Re: ChangeLog policy for same-day changes to a file?

[Karl Fogel <kfogel@red-bean.com>]

Miles Bader <miles@gnu.org> writes:
> Karl Fogel <kfogel@red-bean.com> writes:
>> Obviously, they represent separate CVS commits to doc-view.el, but on
>> the same day, so Tassilo put them into the same ChangeLog entry.  The
>> result is counterintuitive, but I'm not sure what else he should do.
>> Create a separate ChangeLog entry with the same date?  Do we have a
>> policy for how to handle this?
>
> Does it matter?  Either seems clear enough, for a human reader, at
> least.

It's just confusing because there is an implicit one-to-one mapping
between ChangeLog top-level entries and CVS commits.  While I can
discard this assumption if advised to, I'm pretty sure it's one many
developers would share, especially those unfamiliar with Emacs's
unusual ChangeLog policy (i.e., virtually every incoming developer).

When I read Tassilo's entry, I hit that first mention of doc-view.el
and assumed I'd seen everything Tassilo did to that file on that day.
That caused me to spend a bit of time being confused, because I knew
there should be more.  Eventually I saw what I was looking for, later
in the entry.

Personally, I'm going to make a separate top-level entry in ChangeLog
for each commit of mine.  I don't know whether I'll bother to defactor
Tassilo's entry, though ("mattress in the road" problem and all that).

-Karl