Re: changelog format

[Stefano Lattarini]

On 01/17/2012 05:04 PM, Thien-Thi Nguyen wrote:
>
> [SNIP]
>
>    > (Meta-comment: This extra step shows
>    > how generated ChangeLog files are inconvenient to casual readers.)
> 
>    How so?  Note that I've copied & pasted the above from the git
>    output, not from the corresponding generated ChangeLog.
> 
> Well, i didn't have coreutils repo (or tarballs) locally, so i had to
> clone it and do "git log", to find that information.
>
Oh, sorry.  But again, that's due to my sloppiness, not to the fact that
the ChangeLog is auto-generated.

>    > I note that there is more than one paragraph, so i guess i'll change
>    > the "short paragraph" to "paragraph(s)".
>    >
>    +1
> 
> OK.  Attached is the latest diff.  In addition to the above changes, i
> moved the examples to their own node, refilling the one from coreutils
> slightly.  I also used @verbatim, but am not sure if that's cool or not.
> 
>
Now that I've re-read the coreutils entry, I've noticed ...

> Starting with commit adc30a83, when using --color, ls
>
.. that we go against our own advice here, as we report only the VCS id
of the commit we are referring to.  So, what about this tweak?

  Starting with commit adc30a83 (2004-04-24), when using --color, ls

For the rest, the patch looks good.  Thanks again for tackling this!

Regards,
  Stefano