From gregory_r_warnes at groton.pfizer.com  Tue Jan 20 23:41:48 2004
From: gregory_r_warnes at groton.pfizer.com (Warnes, Gregory R)
Date: Tue Jan 20 23:40:34 2004
Subject: [Rd] ChangeLog for R packages {was "Wish list"}
Message-ID: <D7A3CFD7825BD6119B880002A58F06C20680AD78@groexmb02.pfizer.com>


Yes, for an arbitrary project, the CVS log files may not be good enough or
may be too verbose.  The generated logs may still need some hand editing to
be given to clients.

OTOH, now that I know that I'm going to use cvs2cl, the quality and style of
my CVS log entries has gotten better.

Finally, it shouldn't be too hard to parse the XML and provide links to the
appropriate CVS web view...

-G

> -----Original Message-----
> From: rossini@blindglobe.net [mailto:rossini@blindglobe.net]
> Sent: Tuesday, January 20, 2004 2:49 PM
> To: Warnes, Gregory R
> Cc: 'Dirk Eddelbuettel'; Duncan Murdoch; Martin Maechler; r-devel
> Subject: Re: [Rd] ChangeLog for R packages {was "Wish list"}
> 
> 
> "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 attachments may be
> confidential and privileged. If you received this message in error,
> please destroy it and notify the sender. Thank you.
> 


LEGAL NOTICE\ Unless expressly stated otherwise, this messag...{{dropped}}


[Rd] ChangeLog for R packages {was "Wish list"}
Warnes, Gregory R