[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
gnustandards ChangeLog standards.texi
From: |
Karl Berry |
Subject: |
gnustandards ChangeLog standards.texi |
Date: |
Sun, 08 Apr 2012 00:22:33 +0000 |
CVSROOT: /sources/gnustandards
Module name: gnustandards
Changes by: Karl Berry <karl> 12/04/08 00:22:33
Modified files:
. : ChangeLog standards.texi
Log message:
mention formatting of struct and enum types
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnustandards/ChangeLog?cvsroot=gnustandards&r1=1.159&r2=1.160
http://cvs.savannah.gnu.org/viewcvs/gnustandards/standards.texi?cvsroot=gnustandards&r1=1.215&r2=1.216
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/gnustandards/gnustandards/ChangeLog,v
retrieving revision 1.159
retrieving revision 1.160
diff -u -b -r1.159 -r1.160
--- ChangeLog 6 Apr 2012 23:34:07 -0000 1.159
+++ ChangeLog 8 Apr 2012 00:22:33 -0000 1.160
@@ -1,3 +1,8 @@
+2012-04-07 Karl Berry <address@hidden>
+
+ * standards.texi (Formatting): mention struct+enum types
+ per rms.
+
2012-04-06 Karl Berry <address@hidden>
* standards.texi (Comments): Gender neutralize.
Index: standards.texi
===================================================================
RCS file: /sources/gnustandards/gnustandards/standards.texi,v
retrieving revision 1.215
retrieving revision 1.216
diff -u -b -r1.215 -r1.216
--- standards.texi 6 Apr 2012 23:34:07 -0000 1.215
+++ standards.texi 8 Apr 2012 00:22:33 -0000 1.216
@@ -3,7 +3,7 @@
@setfilename standards.info
@settitle GNU Coding Standards
@c This date is automagically updated when you save this file:
address@hidden lastupdate April 6, 2012
address@hidden lastupdate April 7, 2012
@c %**end of header
@dircategory GNU organization
@@ -2384,6 +2384,7 @@
@cindex open brace
@cindex braces, in C source
address@hidden function definitions, formatting
It is important to put the open-brace that starts the body of a C
function in column one, so that they will start a defun. Several
tools look for open-braces in column one to find the beginnings of C
@@ -2430,6 +2431,20 @@
@dots{}
@end example
address@hidden @code{struct} types, formatting
address@hidden @code{enum} types, formatting
+For @code{struct} and @code{enum} types, likewise put the braces in
+column one, unless the whole contents fits on one line:
+
address@hidden
+struct foo
address@hidden
+ int a, b;
address@hidden
address@hidden @r{or}
+struct foo @{ int a, b; @}
address@hidden example
+
The rest of this section gives our recommendations for other aspects of
C formatting style, which is also the default style of the @code{indent}
program in version 1.2 and newer. It corresponds to the options