m4-patches
[Top][All Lists]
Advanced

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

Re: 09-autotest-independence.patch


From: Gary V. Vaughan
Subject: Re: 09-autotest-independence.patch
Date: Sun, 26 Aug 2001 15:06:06 +0100
User-agent: Mutt/1.2.5i

On Mon, Aug 20, 2001 at 06:04:36PM +0200, Akim Demaille wrote:
> 
> | 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?
> 
> I think I basically follow your rules, but for white lines: I don't
> like separating different checkins with a single empty line.  When
> there are things which are very interrelated, but different, I like to
> make it explicit.  For instance on Autoconf:
> 
> I think the augmented readability deserves this 10%.  In the case of
> Autoconf, I spent hours reading the ChangeLogs.  They are precious to me.
> 
> But I will follow your rules if you want me to <g> :)

I don't mind, as long as we are consistent.  If you have time, would
you mind changing all the entries to your preferred style?  And then,
if you amend my rules above to match, we can make this a policy and
I'll add it to the web pages I'm putting together for
http://www.gnu.org/software/m4.

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__/



reply via email to

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