[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation

From: Peter Simons
Subject: Re: Documentation
Date: Mon, 20 Jul 2009 00:51:47 +0200

Hi Francesco,

 > * README, README-maint, INSTALL -> plain text into the root

yes, that's fine. README exists, INSTALL is copied-in by Autotools, and I
have renamed NOTES accordingly, so that's taken care of.

 > * ChangeLog                     -> autogenerated

Gnulib's "gitlog-to-changelog -- --branches >ChangeLog" seems to do a good
job at generating that file, but I wonder: should the ChangeLog contain
messages from all branches? Or just 'master' -- a.k.a. the macros?

 > * NEWS                          -> plain text / autogenerated

We might be able to generate NEWS from annotated tags in Git. This would
mean, of course, that we'd have create a tag every time we want to change
the NEWS file. That sounds somewhat unreasonable to me. Maybe a plain file
is good enough.

Take care,

reply via email to

[Prev in Thread] Current Thread [Next in Thread]