emacs-devel
[Top][All Lists]
Advanced

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

Re: ChangeLog fontifications


From: Werner LEMBERG
Subject: Re: ChangeLog fontifications
Date: Thu, 13 May 2004 23:37:55 +0200 (CEST)

> GNU coding standards say otherwise: 
> 
> http://www.gnu.org/prep/standards_42.html#SEC42
> 
>     Break long lists of function names by closing continued lines with
>     `)', rather than `,', and opening the continuation with `(' as in
>     this example:
> 
>       * keyboard.c (menu_bar_items, tool_bar_items)
>     (Fexecute_extended_command): Deal with `keymap' property.

Well, this is completely crazy in my eyes.  Either this:

  * keyboard.c (menu_bar_items) (tool_bar_items)
  (Fexecute_extended_command): Deal with `keymap' property.

or this:

  * keyboard.c (menu_bar_items, tool_bar_items,
  Fexecute_extended_command): Deal with `keymap' property.

but not something inbetween!

> Emacs gets it right, but it's not surprising that it isn't
> technically enforced on projects with large numbers of non-emacs
> contributers.

This ChangeLog style is a typographic nightmare IMHO.  What on earth
was the reason to invent such a convention?


    Werner




reply via email to

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