From rossini at blindglobe.net  Tue Jan 20 20:48:46 2004
From: rossini at blindglobe.net (A.J. Rossini)
Date: Tue Jan 20 20:45:57 2004
Subject: [Rd] ChangeLog for R packages {was "Wish list"}
In-Reply-To: <D7A3CFD7825BD6119B880002A58F06C20680AD74@groexmb02.pfizer.com>
	(Gregory R. Warnes's message of "Tue, 20 Jan 2004 14:09:45 -0500")
References: <D7A3CFD7825BD6119B880002A58F06C20680AD74@groexmb02.pfizer.com>
Message-ID: <857jzmtn8h.fsf@blindglobe.net>

"Warnes, Gregory R" <gregory_r_warnes@groton.pfizer.com> writes:

> I've been using a cvs2cl.pl (http://www.red-bean.com/cvs2cl), a nice little
> perl script to auto-generate GNU-style 
> changelogs from CVS log information.
>
> This site also has a proposed XML format for changelogs, and cvs2cl can
> optionally produce this instead.  Finally, they have an XSLT sylesheet that
> will convert the XML changlong format into an HTML/XHTML page.
>
> How about we borrow this tool and perhaps XML format for R?

That makes the assumption that there is worthwhile log messages in
CVS.  

In 2 related projects, we are looking at 75% (with ESS) and much less,
maybe 20-25% (BioConductor) of useful and informative log mesages in
CVS.

I'm not precisely sure how well R compares -- a quick check of various
files, based on anoncvs access, suggests that it's pretty good,
assuming that you have cvs access (anonymous or otherwise) to
translate the sometimes terse descriptions.  Compare with
bioconductor, where some of the check-in comments are completely
useless without corresponding diff's (which of course, are completely
self explanatory :-).

best,
-tony

-- 
rossini@u.washington.edu            http://www.analytics.washington.edu/ 
Biomedical and Health Informatics   University of Washington
Biostatistics, SCHARP/HVTN          Fred Hutchinson Cancer Research Center
UW (Tu/Th/F): 206-616-7630 FAX=206-543-3461 | Voicemail is unreliable
FHCRC  (M/W): 206-667-7025 FAX=206-667-4812 | use Email

CONFIDENTIALITY NOTICE: This e-mail message and any attachme...{{dropped}}


[Rd] ChangeLog for R packages {was "Wish list"}
A.J. Rossini