From tobias.verbeke at telenet.be  Fri Apr 17 20:50:49 2009
From: tobias.verbeke at telenet.be (Tobias Verbeke)
Date: Fri, 17 Apr 2009 20:50:49 +0200
Subject: [Rd] suggestion for R >= 3.0: computer-readable CHANGELOG
In-Reply-To: <18920.40641.635120.944317@ron.nulle.part>
References: <49E82D9C.9090402@sciviews.org>
	<49E85C0D.6040809@stats.uwo.ca>	<49E87A59.2010003@life.ku.dk>
	<49E87E85.4050700@stats.uwo.ca>	<18920.36404.547796.504974@ron.nulle.part>	<49E893F1.9000007@stats.uwo.ca>
	<18920.40641.635120.944317@ron.nulle.part>
Message-ID: <49E8CF89.4030402@telenet.be>

Dirk Eddelbuettel wrote:
> On 17 April 2009 at 10:36, Duncan Murdoch wrote:
> | I think it would have to do more than that to be useful.  It would need 
> | to warn about a lack of an entry for the current version.  Otherwise 
> | package.skeleton would create a blank one, and that would satisfy the 
> | check from then on.
> | 
> | To recognize an entry for the current version, it would need a standard 
> | format.  But then, unless whoever put together the format was willing to 
> | do updates to the hundreds of existing files out there, there would be a 
> 
> I'd say use it on a go-forward basis.

I agree. For the ChangeLog, the GNU ChangeLog format could be used.
The advantage is that there are already converters available for some
commonly used source control management systems, such that users
can stick with their favorite systems and comply:

For git:
http://git.savannah.gnu.org/gitweb/?p=gnulib.git;a=blob_plain;f=build-aux/gitlog-to-changelog;hb=HEAD

For Subversion:
http://ch.tudelft.nl/~arthur/svn2cl/

For CVS:
http://www.red-bean.com/cvs2cl/

Always willing to participate (also in converting existing files).

Best,
Tobias

> | Could you take a look at CRAN and Bioconductor, and count how many 
> | packages already have a news/changelog file, and how hard it would be to 
> | convert them to a standard format?
> 
> I can do the count for CRAN using the account we use for cran2deb work.  I'll
> be travelling this weekend (yay, Boston Marathon!) so please ping me next
> week if I forget to aggregate this.
> 
> Dirk
>



[Rd] suggestion for R >= 3.0: computer-readable CHANGELOG
Tobias Verbeke