Re: Position of conditionals in ChangeLog

[Bruno Haible]

Alfred M. Szmidt wrote:
> Why people write one form or the other seems to be to personal
> preference, and not some inherent logical difference.

Going through the occurrences of '] (' in the Emacs ChangeLogs, it seems
that at least half of them were written with the cited logic in mind,
not based on personal preference.

> I would suggest we change the examples to be similar.

Do you propose to show both syntaxes and say that they serve the same
purpose? That would not be good, IMO, because then people would have to
search for two forms
  [COND] (func)
and
  (func) [COND]
before they find what they are looking for.

I see two reasonable actions:

(a) Remove the first example, show only the second one. This will make
    it easier to people who learn how to write a ChangeLog entry.
    I.e. get rid of something that hardly anyone uses and few people
    know about.

or

(b) Keep the two examples, and explain the logic in a better way than
    it does now.

Bruno