Sorry, Could you please point me again to the right place for comment formatting? I remember that single line is different from multi-line, and that multi-line comments should end with a point and two spaces before the closing '*/'
http://www.gnu.org/prep/standards/ does not seem very explicit about this, unless I did not find the right place inside...
Concerning the comment below, should it be 1) /* For GPC, main procedure has a special name */ 2) /* For GPC, main procedure has a special name. */ or something else?
Pierre
-----Original Message----- From: Eli Zaretskii [mailto:eliz@gnu.org] Sent: Wednesday, September 26, 2007 5:04 PM To: Pierre Muller Cc: gdb-patches@sourceware.org; gpc@gnu.de Subject: Re: [RFC] Handle GPC specific name for main function
From: "Pierre Muller" muller@ics.u-strasbg.fr Cc: gpc@gnu.de Date: Wed, 26 Sep 2007 16:40:30 +0200
- /* For GPC, main procedure s a special name.
. */
What happened here? this comment is not formatted according to GNU coding style.
Pierre Muller a écrit:
Sorry, Could you please point me again to the right place for comment formatting? I remember that single line is different from multi-line, and that multi-line comments should end with a point and two spaces before the closing '*/'
http://www.gnu.org/prep/standards/ does not seem very explicit about this, unless I did not find the right place inside...
Concerning the comment below, should it be
- /* For GPC, main procedure has a special name */
- /* For GPC, main procedure has a special name. */
or something else?
I find in the section "commenting your work" in the above file:
Please put two spaces after the end of a sentence in your comments, so that the Emacs sentence commands will work. Also, please write complete sentences and capitalize the first word.
and somewhat later the the example:
There should be a comment on each static variable as well, like this:
/* Nonzero means truncate lines in the display; zero means continue them. */ int truncate_lines;
intermediate between 1) and 2)
We do not follow this Emacs dictated rule in Pascal coding standards !!
Maurice