gnustandards ChangeLog standards.texi

[Karl Berry]

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