This is the mail archive of the gdb-patches@sources.redhat.com mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [COMMIT] Improve coding standard in dbxread.c


> Date: Sat, 20 Nov 2004 13:39:09 +0100 (CET)
> From: Mark Kettenis <kettenis@gnu.org>
> 
> Only a tiny fraction of the code, but it's a step into the right
> direction.

I think changes like these are wrong:

> -    case N_STSYM:		/* Static symbol in data seg */
> -    case N_LCSYM:		/* Static symbol in BSS seg */
> -    case N_ROSYM:		/* Static symbol in Read-only data seg */
> +    case N_STSYM:		/* Static symbol in data segment.  */
> +    case N_LCSYM:		/* Static symbol in BSS segment.  */
> +    case N_ROSYM:		/* Static symbol in read-only data segment.  */

The text in these comments does not constitute a full sentence, and so
adding a period at the end is not the right change.  The right way to
fix this, IMHO, is to lower-case the first letter of the comment, like
this:

    case N_STSYM:		/* static symbol in data segment */

There are numerous other instances of similar changes, and IMHO they
all are wrong.  This one looks particularly incorrect after the
change:

> +    case N_NOMAP:		/* No map?  (Ultrix).  */

Some of the other changes simply reformat comments to break the line
at a different column.  Do we have a canonical column number for that,
and if we do, what is its value?


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]