[Top][All Lists]

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

Re: Commit netiquette.

From: Eli Zaretskii
Subject: Re: Commit netiquette.
Date: Mon, 22 Feb 2010 06:14:34 +0200

> From: Miles Bader <address@hidden>
> Cc: address@hidden,  address@hidden,  address@hidden,  address@hidden
> Date: Mon, 22 Feb 2010 11:17:23 +0900
> > However, the "SUMMARY:" part just wastes precious real estate of the
> > single line produced by "bzr log --line".
> Eh?  I'm confused... I don't mean they should literally write the string

Then it is my misunderstanding, sorry.  I thought you did mean
"SUMMARY: bla-bla" literally.

> and I was talking about ChangeLog files, not commit-logs.

Most people simply copy the former into the latter.

> What I was advocating was, _in ChangeLog files_, a style like:
>    2010-02-22  Miles Bader  <Miles Bader <address@hidden>>
>            Frobbed the grot system:
>            * grot-blah.el (fun1, fun2): Blurged frebly.
>            * grot-zung.el (fun3): Nug n ug.
>            * some-grup.el (zoon): Wabawaba.
> This isn't always necessary for small/trivial changes, but for longer
> ones, i think it's a useful addition.

Right, and I think many, if not most, already do that.

reply via email to

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