From 79958342269382b4ecbe3c5f566f86f71eb09ace Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 8 Apr 2012 06:58:34 -0700 Subject: [PATCH] autoupdate --- doc/maintain.texi | 22 ++++++++++++++-------- doc/standards.texi | 19 +++++++++++++++++-- 2 files changed, 31 insertions(+), 10 deletions(-) diff --git a/doc/maintain.texi b/doc/maintain.texi index 68cc63596..59c11b6dc 100644 --- a/doc/maintain.texi +++ b/doc/maintain.texi @@ -5,7 +5,7 @@ @c For double-sided printing, uncomment: @c @setchapternewpage odd @c This date is automagically updated when you save this file: -@set lastupdate March 20, 2012 +@set lastupdate April 6, 2012 @c %**end of header @dircategory GNU organization @@ -287,6 +287,8 @@ as you maintain the program, to avoid legal difficulties. @node Copyright Papers @section Copyright Papers @cindex copyright papers +@cindex assignments, copyright +@cindex disclaimers If you maintain an FSF-copyrighted package certain legal procedures are required when incorporating legally significant @@ -368,13 +370,17 @@ papers to sign. The @file{request-} file also raises the issue of getting an employer's disclaimer from the contributor's employer. When the contributor emails the form to the FSF, the FSF sends per an -electronic (usually PDF) copy of the assignment. All contributors -then print the assignment and sign it. Contributors residing outside -the U.S. must mail the signed form to the FSF via the post. -Contributors located in the U.S. can then email or fax a scanned copy -back to the FSF (or use postal mail, if they prefer). (To emphasize, -the necessary distinction is between US residents and non-residents, -citizenship does not matter.) +electronic (usually PDF) copy of the assignment. This, or whatever +response is required, should happen within five business days of the +initial request. If no reply from the FSF comes after that time, it +is good to send a reminder. + +After receiving the necessary form, all contributors then print it and +sign it. Contributors residing outside the U.S. must mail the signed +form to the FSF via the post. Contributors located in the U.S. can +then email or fax a scanned copy back to the FSF (or use postal mail, +if they prefer). (To emphasize, the necessary distinction is between +US residents and non-residents; citizenship does not matter.) For less common cases, we have template files you should send to the contributor. Be sure to fill in the name of the person and the name diff --git a/doc/standards.texi b/doc/standards.texi index fc0761f5c..69a400ea2 100644 --- a/doc/standards.texi +++ b/doc/standards.texi @@ -3,7 +3,7 @@ @setfilename standards.info @settitle GNU Coding Standards @c This date is automagically updated when you save this file: -@set lastupdate March 8, 2012 +@set lastupdate April 7, 2012 @c %**end of header @dircategory GNU organization @@ -2384,6 +2384,7 @@ when writing GNU software. @cindex open brace @cindex braces, in C source +@cindex 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 @@ lots_of_args (int an_integer, long a_long, short a_short, @dots{} @end example +@cindex @code{struct} types, formatting +@cindex @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: + +@example +struct foo +@{ + int a, b; +@} +@exdent @r{or} +struct foo @{ int a, b; @} +@end 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 @@ -2576,7 +2591,7 @@ about the value rather than the variable itself. Thus, ``the inode number NODE_NUM'' rather than ``an inode''. There is usually no purpose in restating the name of the function in -the comment before it, because the reader can see that for himself. +the comment before it, because readers can see that for themselves. There might be an exception when the comment is so long that the function itself would be off the bottom of the screen. -- 2.11.0