From: Rafael Laboissiere <rlaboiss@us...> - 2004-02-06 13:09:23
* Alan W. Irwin <irwin@...> [2004-02-04 12:41]:
> -----------The following files should be deleted.
> * CHANGES
> Completely out of date, and ChangeLog should be used instead.
> * TODO.AM-LT
> This file is partially out of date. Anything still relevant should be put
> into PROBLEMS or ToDo (see comments on those below).
Into ToDo, I would say. I have to review its contents, anyway.
> -----------The following files should be kept.
> * ChangeLog
> This one is out-of-date. I maintained it for a while, but it was too much
> work. Instead, the cvs log should be used instead to generate this file
> using cvs2cl or some equivalent tool. I notice Rafael has a ChangeLog that
> he automatically generated for the website. If that tool also makes a txt
> version, that would be ideal, but otherwise use cvs2cl for the txt version.
I used cvsreport (http://www.nongnu.org/cvsreport/), whcih can output both
text and html formats. The ChangeLog of the last release announcement
(http://plplot.sf.net/announce/announce-plplot-5.3.0.txt) is actually an
> * FAQ
> This is grossly out-of-date and misleading. We do need a FAQ, but it should
> be relevant. Both cvs and website forms should be made available.
Agreed. Should this file (or an improved version of it) be moved into the
> * NEWS
> This is out of date. The last updates simply took part of the release
> announcement (or all of it?) for each release, but even that maintenance
> stopped at 5.1.0. I think a better approach is to completely replace the
> current contents of this file with a series of one-line dated overviews of
> major events, e.g.,
> 2004-02-2004: PLplot version 5.3.0 was released (with a link to the release
> Both cvs and website forms should be made available.