Re: 09-autotest-independence.patch

[Gary V . Vaughan]

On Friday 17 August 2001 12:47 pm, Akim Demaille wrote:
> Index: ChangeLog
> from ?Akim Demaille ?<address@hidden>
>
> ????????others.at no longer depends on other-tests/.
>
> ????????* tests/others.at (stackovf): You're actually...
> ????????(sync-lines): this.
> ????????(modfreeze, modpath1, modpath2, modpath3, modpath4, modtest,
> shadow) (unload.test): Keep their authorship.
> ????????(discard-comments, gmp, import-environment, modfreeze)
> ????????(sync-lines): Embed the input files.
> ????????* tests/stackovf.test: Copy from other-tests/stackovf.test.
> ????????* tests/iso8850.m4: Copy from other-tests/iso8859.m4.

Seems we are each writing our ChangeLog entries in a different style =(O|

I don't mind which style we use, as long as it is consistent throughout the 
whole ChangeLog.  It is probably less work to convert your log entries to the 
existing style than vice vera though...

Here's a description of the rules I have been following:

  i) Emacs-21 style header (yyyy-mm-dd  <Name>  <email>)
     Only add a new header if the date or the author is different from the
     current top header.  The name used is the name of the person who wrote
     the ChangeLog entry -- this matters if someone sends a patch without a
     ChangeLog.
 ii) Blank line.
iii) `<tab>From <Name> <email>:' if the patch described beneath was submitted
     by someone other than the person named in the header.
 iv) Optional description of the purpose of the patch, with each line
     indented by a single tab.  No leading `*'.
  v) Changes.
     `<tab>* <Filename>: <global changes description>.
     `<tab>(<function list>) [host triplet globs]: <description>'
     `<tab><description continuation>.'
 vi) `<tab>Reported by <Name> <email>' if this fixes a reported bug.
vii) Only insert blank lines between entries from distinct commits.

If you agree with this, I'll work it into the maintainers-page (to be).  
Comments?

Cheers,
        Gary.
-- 
  ())_. Gary V. Vaughan     gary@(oranda.demon.co.uk|gnu.org)
  ( '/  Research Scientist  http://www.oranda.demon.co.uk       ,_())____
  / )=  GNU Hacker          http://www.gnu.org/software/libtool  \'      `&
`(_~)_  Tech' Author        http://sources.redhat.com/autobook   =`---d__/