[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
www/prep/standards index.html standards.dvi.gz ...
From: |
Karl Berry |
Subject: |
www/prep/standards index.html standards.dvi.gz ... |
Date: |
Mon, 05 May 2008 17:26:05 +0000 |
CVSROOT: /web/www
Module name: www
Changes by: Karl Berry <karl> 08/05/05 17:26:04
Modified files:
prep/standards : index.html standards.dvi.gz standards.html
standards.html.gz standards.html_node.tar.gz
standards.info.tar.gz standards.pdf
standards.ps.gz standards.texi.tar.gz
standards.txt standards.txt.gz
prep/standards/html_node: CPU-Portability.html
Change-Log-Concepts.html
Change-Logs.html Character-Set.html
Command-Variables.html
Command_002dLine-Interfaces.html
Comments.html Compatibility.html
Conditional-Changes.html
Conditional-Compilation.html
Configuration.html Contributions.html
DESTDIR.html Design-Advice.html
Directory-Variables.html
Doc-Strings-and-Manuals.html
Documentation.html Errors.html
File-Usage.html Formatting.html
GNU-Free-Documentation-License.html
GNU-Manuals.html
Graphical-Interfaces.html Index.html
Indicating-the-Part-Changed.html
Install-Command-Categories.html
Internationalization.html
Legal-Issues.html Libraries.html
License-for-Manuals.html
Makefile-Basics.html
Makefile-Conventions.html
Man-Pages.html Managing-Releases.html
Manual-Credits.html
Manual-Structure-Details.html
Memory-Usage.html Mmap.html
NEWS-File.html Names.html
Non_002dGNU-Standards.html
Option-Table.html Preface.html
Printed-Manuals.html
Program-Behavior.html
Quote-Characters.html
Reading-Non_002dFree-Code.html
Reading-other-Manuals.html
References.html Releases.html
Semantics.html Simple-Changes.html
Source-Language.html Standard-C.html
Standard-Targets.html
Style-of-Change-Logs.html
Syntactic-Conventions.html
System-Functions.html
System-Portability.html
Trademarks.html User-Interfaces.html
Using-Extensions.html
Utilities-in-Makefiles.html
Writing-C.html _002d_002dhelp.html
_002d_002dversion.html index.html
Log message:
guile supports GNOME too
CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/index.html?cvsroot=www&r1=1.29&r2=1.30
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.dvi.gz?cvsroot=www&rev=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.html?cvsroot=www&r1=1.28&r2=1.29
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.html.gz?cvsroot=www&rev=1.28
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.html_node.tar.gz?cvsroot=www&rev=1.28
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.info.tar.gz?cvsroot=www&rev=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.pdf?cvsroot=www&rev=1.28
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.ps.gz?cvsroot=www&rev=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.texi.tar.gz?cvsroot=www&rev=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.txt?cvsroot=www&r1=1.27&r2=1.28
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.txt.gz?cvsroot=www&rev=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/CPU-Portability.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Change-Log-Concepts.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Change-Logs.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Character-Set.html?cvsroot=www&r1=1.17&r2=1.18
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Command-Variables.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Command_002dLine-Interfaces.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Comments.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Compatibility.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Conditional-Changes.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Conditional-Compilation.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Configuration.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Contributions.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/DESTDIR.html?cvsroot=www&r1=1.14&r2=1.15
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Design-Advice.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Directory-Variables.html?cvsroot=www&r1=1.26&r2=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Doc-Strings-and-Manuals.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Documentation.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Errors.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/File-Usage.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Formatting.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/GNU-Free-Documentation-License.html?cvsroot=www&r1=1.26&r2=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/GNU-Manuals.html?cvsroot=www&r1=1.26&r2=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Graphical-Interfaces.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Index.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Indicating-the-Part-Changed.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Install-Command-Categories.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Internationalization.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Legal-Issues.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Libraries.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/License-for-Manuals.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Makefile-Basics.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Makefile-Conventions.html?cvsroot=www&r1=1.26&r2=1.27
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Man-Pages.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Managing-Releases.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Manual-Credits.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Manual-Structure-Details.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Memory-Usage.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Mmap.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/NEWS-File.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Names.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Non_002dGNU-Standards.html?cvsroot=www&r1=1.15&r2=1.16
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Option-Table.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Preface.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Printed-Manuals.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Program-Behavior.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Quote-Characters.html?cvsroot=www&r1=1.17&r2=1.18
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Reading-Non_002dFree-Code.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Reading-other-Manuals.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/References.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Releases.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Semantics.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Simple-Changes.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Source-Language.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Standard-C.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Standard-Targets.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Style-of-Change-Logs.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Syntactic-Conventions.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/System-Functions.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/System-Portability.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Trademarks.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/User-Interfaces.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Using-Extensions.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Utilities-in-Makefiles.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Writing-C.html?cvsroot=www&r1=1.25&r2=1.26
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/_002d_002dhelp.html?cvsroot=www&r1=1.9&r2=1.10
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/_002d_002dversion.html?cvsroot=www&r1=1.10&r2=1.11
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/index.html?cvsroot=www&r1=1.25&r2=1.26
Patches:
Index: index.html
===================================================================
RCS file: /web/www/www/prep/standards/index.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- index.html 25 Apr 2008 18:41:34 -0000 1.29
+++ index.html 5 May 2008 17:24:17 -0000 1.30
@@ -10,7 +10,7 @@
<!-- See validator.w3.org -->
<address>Free Software Foundation</address>
-<address>last updated April 25, 2008</address>
+<address>last updated May 05, 2008</address>
<p>This manual (standards) is available in the following formats:</p>
@@ -34,7 +34,7 @@
<li><a href="standards.dvi.gz">TeX dvi file
(112K bytes gzipped)</a>.</li>
<li><a href="standards.ps.gz">PostScript file
- (244K bytes gzipped)</a>.</li>
+ (248K bytes gzipped)</a>.</li>
<li><a href="standards.pdf">PDF file
(424K bytes)</a>.</li>
<li><a href="standards.texi.tar.gz">Texinfo source
Index: standards.dvi.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.dvi.gz,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
Binary files /tmp/cvsqK00j1 and /tmp/cvswZH1Ws differ
Index: standards.html
===================================================================
RCS file: /web/www/www/prep/standards/standards.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -b -r1.28 -r1.29
--- standards.html 25 Apr 2008 18:41:34 -0000 1.28
+++ standards.html 5 May 2008 17:24:18 -0000 1.29
@@ -7,7 +7,7 @@
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -139,7 +139,7 @@
<h2 class="unnumbered">Version</h2>
-<p>The GNU coding standards, last updated February 23, 2008.
+<p>The GNU coding standards, last updated May 5, 2008.
<p>Copyright © 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -187,7 +187,7 @@
state reasons for writing in a certain way.
<p>This release of the GNU Coding Standards was last updated
-February 23, 2008.
+May 5, 2008.
<p><a
name="index-where-to-obtain-_0040code_007bstandards_002etexi_007d-1"></a><a
name="index-downloading-this-manual-2"></a>If you did not obtain this file
directly from the GNU project and
recently, please check for a newer version. You can get the GNU
@@ -446,12 +446,14 @@
is written in that language, too. The Emacs editor pioneered this
technique.
- <p><a name="index-GUILE-11"></a>The standard extensibility interpreter for
GNU software is GUILE
+ <p><a name="index-Guile-11"></a><a name="index-GNOME-and-Guile-12"></a>The
standard extensibility interpreter for GNU software is Guile
(<a
href="http://www.gnu.org/software/guile/">http://www.gnu.org/software/guile/</a>),
which implements the
-language Scheme (an especially clean and simple dialect of Lisp). We
-don't reject programs written in other “scripting languages” such
as
-Perl and Python, but using GUILE is very important for the overall
-consistency of the GNU system.
+language Scheme (an especially clean and simple dialect of Lisp).
+Guile also includes bindings for GTK+/GNOME, making it practical to
+write modern GUI functionality within Guile. We don't reject programs
+written in other “scripting languages” such as Perl and Python, but
+using Guile is very important for the overall consistency of the GNU
+system.
<div class="node">
<p><hr>
@@ -464,7 +466,7 @@
<h3 class="section">3.2 Compatibility with Other Implementations</h3>
-<p><a
name="index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-12"></a><a
name="index-g_t_0040sc_007bposix_007d-compatibility-13"></a>
+<p><a
name="index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-13"></a><a
name="index-g_t_0040sc_007bposix_007d-compatibility-14"></a>
With occasional exceptions, utility programs and libraries for GNU
should be upward compatible with those in Berkeley Unix, and upward
compatible with Standard C if Standard C specifies their
@@ -474,14 +476,14 @@
<p>When these standards conflict, it is useful to offer compatibility
modes for each of them.
- <p><a name="index-options-for-compatibility-14"></a>Standard C and <span
class="sc">posix</span> prohibit many kinds of extensions. Feel
+ <p><a name="index-options-for-compatibility-15"></a>Standard C and <span
class="sc">posix</span> prohibit many kinds of extensions. Feel
free to make the extensions anyway, and include a ‘<samp><span
class="samp">--ansi</span></samp>’,
‘<samp><span class="samp">--posix</span></samp>’, or
‘<samp><span class="samp">--compatible</span></samp>’ option to
turn them off.
However, if the extension has a significant chance of breaking any real
programs or scripts, then it is not really upward compatible. So you
should try to redesign its interface to make it upward compatible.
- <p><a
name="index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-15"></a>Many
GNU programs suppress extensions that conflict with <span
class="sc">posix</span> if the
+ <p><a
name="index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-16"></a>Many
GNU programs suppress extensions that conflict with <span
class="sc">posix</span> if the
environment variable <code>POSIXLY_CORRECT</code> is defined (even if it is
defined with a null value). Please make your program recognize this
variable if appropriate.
@@ -506,7 +508,7 @@
<h3 class="section">3.3 Using Non-standard Features</h3>
-<p><a name="index-non_002dstandard-extensions-16"></a>
+<p><a name="index-non_002dstandard-extensions-17"></a>
Many GNU facilities that already exist support a number of convenient
extensions over the comparable Unix facilities. Whether to use these
extensions in implementing your program is a difficult question.
@@ -546,7 +548,7 @@
<h3 class="section">3.4 Standard C and Pre-Standard C</h3>
-<p><a name="index-g_t_0040sc_007bansi_007d-C-standard-17"></a>
+<p><a name="index-g_t_0040sc_007bansi_007d-C-standard-18"></a>
1989 Standard C is widespread enough now that it is ok to use its
features in new programs. There is one exception: do not ever use the
“trigraph” feature of Standard C.
@@ -558,7 +560,7 @@
so if you know how to do that, feel free. If a program you are
maintaining has such support, you should try to keep it working.
- <p><a name="index-function-prototypes-18"></a>To support pre-standard C,
instead of writing function definitions in
+ <p><a name="index-function-prototypes-19"></a>To support pre-standard C,
instead of writing function definitions in
standard prototype form,
<pre class="example"> int
@@ -747,12 +749,12 @@
<h3 class="section">4.2 Writing Robust Programs</h3>
-<p><a name="index-arbitrary-limits-on-data-19"></a>Avoid arbitrary limits on
the length or number of <em>any</em> data
+<p><a name="index-arbitrary-limits-on-data-20"></a>Avoid arbitrary limits on
the length or number of <em>any</em> data
structure, including file names, lines, files, and symbols, by allocating
all data structures dynamically. In most Unix utilities, “long lines
are silently truncated”. This is not acceptable in a GNU utility.
- <p><a name="index-g_t_0040code_007bNUL_007d-characters-20"></a>Utilities
reading files should not drop NUL characters, or any other
+ <p><a name="index-g_t_0040code_007bNUL_007d-characters-21"></a>Utilities
reading files should not drop NUL characters, or any other
nonprinting characters <em>including those with codes above 0177</em>.
The only sensible exceptions would be utilities specifically intended
for interface to certain types of terminals or printers
@@ -761,14 +763,14 @@
sequences of bytes that represent multibyte characters, using encodings
such as UTF-8 and others.
- <p><a name="index-error-messages-21"></a>Check every system call for an
error return, unless you know you wish to
+ <p><a name="index-error-messages-22"></a>Check every system call for an
error return, unless you know you wish to
ignore errors. Include the system error text (from <code>perror</code> or
equivalent) in <em>every</em> error message resulting from a failing
system call, as well as the name of the file if any and the name of the
utility. Just “cannot open foo.c” or “stat failed” is
not
sufficient.
- <p><a name="index-g_t_0040code_007bmalloc_007d-return-value-22"></a><a
name="index-memory-allocation-failure-23"></a>Check every call to
<code>malloc</code> or <code>realloc</code> to see if it
+ <p><a name="index-g_t_0040code_007bmalloc_007d-return-value-23"></a><a
name="index-memory-allocation-failure-24"></a>Check every call to
<code>malloc</code> or <code>realloc</code> to see if it
returned zero. Check <code>realloc</code> even if you are making the block
smaller; in a system that rounds block sizes to a power of 2,
<code>realloc</code> may get a different block if you ask for less space.
@@ -789,7 +791,7 @@
reader loop. This allows the user to kill other processes to free up
virtual memory, and then try the command again.
- <p><a name="index-command_002dline-arguments_002c-decoding-24"></a>Use
<code>getopt_long</code> to decode arguments, unless the argument syntax
+ <p><a name="index-command_002dline-arguments_002c-decoding-25"></a>Use
<code>getopt_long</code> to decode arguments, unless the argument syntax
makes this unreasonable.
<p>When static storage is to be written in during program execution, use
@@ -803,7 +805,7 @@
in a directory, use <code>readdir</code> or some other high-level interface.
These are supported compatibly by GNU.
- <p><a name="index-signal-handling-25"></a>The preferred signal handling
facilities are the BSD variant of
+ <p><a name="index-signal-handling-26"></a>The preferred signal handling
facilities are the BSD variant of
<code>signal</code>, and the <span class="sc">posix</span>
<code>sigaction</code> function; the
alternative USG <code>signal</code> interface is an inferior design.
@@ -814,7 +816,7 @@
behavior. It is up to you whether to support systems where
<code>signal</code> has only the USG behavior, or give up on them.
- <p><a name="index-impossible-conditions-26"></a>In error checks that detect
“impossible” conditions, just abort.
+ <p><a name="index-impossible-conditions-27"></a>In error checks that detect
“impossible” conditions, just abort.
There is usually no point in printing any message. These checks
indicate the existence of bugs. Whoever wants to fix the bugs will have
to read the source code and run a debugger. So explain the problem with
@@ -828,7 +830,7 @@
errors; if you try to return 256 as the exit status, the parent process
will see 0 as the status, and it will appear that the program succeeded.
- <p><a name="index-temporary-files-27"></a><a
name="index-g_t_0040code_007bTMPDIR_007d-environment-variable-28"></a>If you
make temporary files, check the <code>TMPDIR</code> environment
+ <p><a name="index-temporary-files-28"></a><a
name="index-g_t_0040code_007bTMPDIR_007d-environment-variable-29"></a>If you
make temporary files, check the <code>TMPDIR</code> environment
variable; if that variable is defined, use the specified directory
instead of <samp><span class="file">/tmp</span></samp>.
@@ -853,7 +855,7 @@
<h3 class="section">4.3 Library Behavior</h3>
-<p><a name="index-libraries-29"></a>
+<p><a name="index-libraries-30"></a>
Try to make library functions reentrant. If they need to do dynamic
storage allocation, at least try to avoid any nonreentrancy aside from
that of <code>malloc</code> itself.
@@ -891,7 +893,7 @@
<h3 class="section">4.4 Formatting Error Messages</h3>
-<p><a name="index-formatting-error-messages-30"></a><a
name="index-error-messages_002c-formatting-31"></a>
+<p><a name="index-formatting-error-messages-31"></a><a
name="index-error-messages_002c-formatting-32"></a>
Error messages from compilers should look like this:
<pre class="example"> <var>source-file-name</var>:<var>lineno</var>:
<var>message</var>
@@ -962,14 +964,14 @@
<h3 class="section">4.5 Standards for Interfaces Generally</h3>
-<p><a name="index-program-name-and-its-behavior-32"></a><a
name="index-behavior_002c-dependent-on-program_0027s-name-33"></a>Please don't
make the behavior of a utility depend on the name used
+<p><a name="index-program-name-and-its-behavior-33"></a><a
name="index-behavior_002c-dependent-on-program_0027s-name-34"></a>Please don't
make the behavior of a utility depend on the name used
to invoke it. It is useful sometimes to make a link to a utility
with a different name, and that should not change what it does.
<p>Instead, use a run time option or a compilation switch or both
to select among the alternate behaviors.
- <p><a
name="index-output-device-and-program_0027s-behavior-34"></a>Likewise, please
don't make the behavior of the program depend on the
+ <p><a
name="index-output-device-and-program_0027s-behavior-35"></a>Likewise, please
don't make the behavior of the program depend on the
type of output device it is used with. Device independence is an
important principle of the system's design; do not compromise it merely
to save someone from typing an option now and then. (Variation in error
@@ -1001,8 +1003,8 @@
<h3 class="section">4.6 Standards for Graphical Interfaces</h3>
-<p><a name="index-graphical-user-interface-35"></a>
-<a name="index-gtk_002b-36"></a>When you write a program that provides a
graphical user interface,
+<p><a name="index-graphical-user-interface-36"></a>
+<a name="index-gtk_002b-37"></a>When you write a program that provides a
graphical user interface,
please make it work with X Windows and the GTK+ toolkit unless the
functionality specifically requires some alternative (for example,
“displaying jpeg images while in console mode”).
@@ -1012,7 +1014,7 @@
separate program which invokes the command-line program.) This is
so that the same jobs can be done from scripts.
- <p><a name="index-corba-37"></a><a name="index-gnome-38"></a>Please also
consider providing a CORBA interface (for use from GNOME), a
+ <p><a name="index-corba-38"></a><a name="index-gnome-39"></a>Please also
consider providing a CORBA interface (for use from GNOME), a
library interface (for use from C), and perhaps a keyboard-driven
console interface (for use by users from console mode). Once you are
doing the work to provide the functionality and the graphical interface,
@@ -1030,15 +1032,15 @@
<h3 class="section">4.7 Standards for Command Line Interfaces</h3>
-<p><a name="index-command_002dline-interface-39"></a>
-<a name="index-getopt-40"></a>It is a good idea to follow the <span
class="sc">posix</span> guidelines for the
+<p><a name="index-command_002dline-interface-40"></a>
+<a name="index-getopt-41"></a>It is a good idea to follow the <span
class="sc">posix</span> guidelines for the
command-line options of a program. The easiest way to do this is to use
<code>getopt</code> to parse them. Note that the GNU version of
<code>getopt</code>
will normally permit options anywhere among the arguments unless the
special argument ‘<samp><span class="samp">--</span></samp>’ is
used. This is not what <span class="sc">posix</span>
specifies; it is a GNU extension.
- <p><a name="index-long_002dnamed-options-41"></a>Please define long-named
options that are equivalent to the
+ <p><a name="index-long_002dnamed-options-42"></a>Please define long-named
options that are equivalent to the
single-letter Unix-style options. We hope to make GNU more user
friendly this way. This is easy to do with the GNU function
<code>getopt_long</code>.
@@ -1057,7 +1059,7 @@
option as another way to specify it. This will lead to more consistency
among GNU utilities, and fewer idiosyncrasies for users to remember.
- <p><a name="index-standard-command_002dline-options-42"></a><a
name="index-options_002c-standard-command_002dline-43"></a><a
name="index-CGI-programs_002c-standard-options-for-44"></a><a
name="index-PATH_005fINFO_002c-specifying-standard-options-as-45"></a>All
programs should support two standard options: ‘<samp><span
class="samp">--version</span></samp>’
+ <p><a name="index-standard-command_002dline-options-43"></a><a
name="index-options_002c-standard-command_002dline-44"></a><a
name="index-CGI-programs_002c-standard-options-for-45"></a><a
name="index-PATH_005fINFO_002c-specifying-standard-options-as-46"></a>All
programs should support two standard options: ‘<samp><span
class="samp">--version</span></samp>’
and ‘<samp><span class="samp">--help</span></samp>’. CGI programs
should accept these as command-line
options, and also if given as the <samp><span
class="env">PATH_INFO</span></samp>; for instance,
visiting <a
href="http://example.org/p.cgi/--help">http://example.org/p.cgi/–help</a>
in a browser should
@@ -1080,14 +1082,14 @@
<h4 class="subsection">4.7.1 <samp><span
class="option">--version</span></samp></h4>
-<p><a name="index-g_t_0040samp_007b_002d_002dversion_007d-output-46"></a>
+<p><a name="index-g_t_0040samp_007b_002d_002dversion_007d-output-47"></a>
The standard <code>--version</code> option should direct the program to
print information about its name, version, origin and legal status,
all on standard output, and then exit successfully. Other options and
arguments should be ignored once this is seen, and the program should
not perform its normal function.
- <p><a name="index-canonical-name-of-a-program-47"></a><a
name="index-program_0027s-canonical-name-48"></a>The first line is meant to be
easy for a program to parse; the version
+ <p><a name="index-canonical-name-of-a-program-48"></a><a
name="index-program_0027s-canonical-name-49"></a>The first line is meant to be
easy for a program to parse; the version
number proper starts after the last space. In addition, it contains
the canonical name for this program, in this format:
@@ -1179,7 +1181,7 @@
<br><dt>GPL/Guile<dd>GNU GPL with the exception for Guile; for example,
GPLv3+/Guile means
the GNU GPL version 3 or later, with the extra exception for Guile.
- <p>GNU GPL with the exception for Ada.
+ <br><dt>GPL/Ada<dd>GNU GPL with the exception for Ada.
<br><dt>Apache<dd>The Apache Software Foundation license,
<a href="http://www.apache.org/licenses">http://www.apache.org/licenses</a>.
@@ -1225,13 +1227,13 @@
<h4 class="subsection">4.7.2 <samp><span
class="option">--help</span></samp></h4>
-<p><a name="index-g_t_0040samp_007b_002d_002dhelp_007d-output-49"></a>
+<p><a name="index-g_t_0040samp_007b_002d_002dhelp_007d-output-50"></a>
The standard <code>--help</code> option should output brief documentation
for how to invoke the program, on standard output, then exit
successfully. Other options and arguments should be ignored once this
is seen, and the program should not perform its normal function.
- <p><a name="index-address-for-bug-reports-50"></a><a
name="index-bug-reports-51"></a>Near the end of the ‘<samp><span
class="samp">--help</span></samp>’ option's output there should be a line
+ <p><a name="index-address-for-bug-reports-51"></a><a
name="index-bug-reports-52"></a>Near the end of the ‘<samp><span
class="samp">--help</span></samp>’ option's output there should be a line
that says where to mail bug reports. It should have this format:
<pre class="example"> Report bugs to <var>mailing-address</var>.
@@ -1247,7 +1249,7 @@
<h3 class="section">4.8 Table of Long Options</h3>
-<p><a name="index-long-option-names-52"></a><a
name="index-table-of-long-options-53"></a>
+<p><a name="index-long-option-names-53"></a><a
name="index-table-of-long-options-54"></a>
Here is a table of long options used by GNU programs. It is surely
incomplete, but we aim to list all the options that a new program might
want to be compatible with. If you use names not already in the table,
@@ -2017,7 +2019,7 @@
<h3 class="section">4.9 Memory Usage</h3>
-<p><a name="index-memory-usage-54"></a>
+<p><a name="index-memory-usage-55"></a>
If a program typically uses just a few meg of memory, don't bother making any
effort to reduce memory usage. For example, if it is impractical for
other reasons to operate on files more than a few meg long, it is
@@ -2044,7 +2046,7 @@
<h3 class="section">4.10 File Usage</h3>
-<p><a name="index-file-usage-55"></a>
+<p><a name="index-file-usage-56"></a>
Programs should be prepared to operate when <samp><span
class="file">/usr</span></samp> and <samp><span class="file">/etc</span></samp>
are read-only file systems. Thus, if the program manages log files,
lock files, backup files, score files, or any other files which are
@@ -2096,8 +2098,8 @@
<h3 class="section">5.1 Formatting Your Source Code</h3>
-<p><a name="index-formatting-source-code-56"></a>
-<a name="index-open-brace-57"></a><a
name="index-braces_002c-in-C-source-58"></a>It is important to put the
open-brace that starts the body of a C
+<p><a name="index-formatting-source-code-57"></a>
+<a name="index-open-brace-58"></a><a
name="index-braces_002c-in-C-source-59"></a>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
functions. These tools will not work on code not formatted that way.
@@ -2166,13 +2168,13 @@
return ++x + bar ();
}
</pre>
- <p><a name="index-spaces-before-open_002dparen-59"></a>We find it easier to
read a program when it has spaces before the
+ <p><a name="index-spaces-before-open_002dparen-60"></a>We find it easier to
read a program when it has spaces before the
open-parentheses and after the commas. Especially after the commas.
<p>When you split an expression into multiple lines, split it
before an operator, not after one. Here is the right way:
- <p><a name="index-expressions_002c-splitting-60"></a>
+ <p><a name="index-expressions_002c-splitting-61"></a>
<pre class="example"> if (foo_this_is_long && bar > win (x, y,
z)
&& remaining_condition)
</pre>
@@ -2209,7 +2211,7 @@
}
while (a > 0);
</pre>
- <p><a name="index-formfeed-61"></a><a
name="index-control_002dL-62"></a>Please use formfeed characters (control-L) to
divide the program into
+ <p><a name="index-formfeed-62"></a><a
name="index-control_002dL-63"></a>Please use formfeed characters (control-L) to
divide the program into
pages at logical places (but not within a function). It does not matter
just how long the pages are, since they do not have to fit on a printed
page. The formfeeds should appear alone on lines by themselves.
@@ -2225,7 +2227,7 @@
<h3 class="section">5.2 Commenting Your Work</h3>
-<p><a name="index-commenting-63"></a>
+<p><a name="index-commenting-64"></a>
Every program should start with a comment saying briefly what it is for.
Example: ‘<samp><span class="samp">fmt - filter for simple filling of
text</span></samp>’. This comment
should be at the top of the source file containing the ‘<samp><span
class="samp">main</span></samp>’
@@ -2280,7 +2282,7 @@
zero means continue them. */
int truncate_lines;
</pre>
- <p><a name="index-conditionals_002c-comments-for-64"></a><a
name="index-g_t_0040code_007b_0023endif_007d_002c-commenting-65"></a>Every
‘<samp><span class="samp">#endif</span></samp>’ should have a
comment, except in the case of short
+ <p><a name="index-conditionals_002c-comments-for-65"></a><a
name="index-g_t_0040code_007b_0023endif_007d_002c-commenting-66"></a>Every
‘<samp><span class="samp">#endif</span></samp>’ should have a
comment, except in the case of short
conditionals (just a few lines) that are not nested. The comment should
state the condition of the conditional that is ending, <em>including
its sense</em>. ‘<samp><span class="samp">#else</span></samp>’
should have a comment describing the condition
@@ -2317,13 +2319,13 @@
<h3 class="section">5.3 Clean Use of C Constructs</h3>
-<p><a name="index-syntactic-conventions-66"></a>
-<a name="index-implicit-_0040code_007bint_007d-67"></a><a
name="index-function-argument_002c-declaring-68"></a>Please explicitly declare
the types of all objects. For example, you
+<p><a name="index-syntactic-conventions-67"></a>
+<a name="index-implicit-_0040code_007bint_007d-68"></a><a
name="index-function-argument_002c-declaring-69"></a>Please explicitly declare
the types of all objects. For example, you
should explicitly declare all arguments to functions, and you should
declare functions to return <code>int</code> rather than omitting the
<code>int</code>.
- <p><a name="index-compiler-warnings-69"></a><a
name="index-g_t_0040samp_007b_002dWall_007d-compiler-option-70"></a>Some
programmers like to use the GCC ‘<samp><span
class="samp">-Wall</span></samp>’ option, and change the
+ <p><a name="index-compiler-warnings-70"></a><a
name="index-g_t_0040samp_007b_002dWall_007d-compiler-option-71"></a>Some
programmers like to use the GCC ‘<samp><span
class="samp">-Wall</span></samp>’ option, and change the
code whenever it issues a warning. If you want to do this, then do.
Other programmers prefer not to use ‘<samp><span
class="samp">-Wall</span></samp>’, because it gives
warnings for valid and legitimate code which they do not want to change.
@@ -2336,7 +2338,7 @@
should go in a header file. Don't put <code>extern</code> declarations inside
functions.
- <p><a name="index-temporary-variables-71"></a>It used to be common practice
to use the same local variables (with
+ <p><a name="index-temporary-variables-72"></a>It used to be common practice
to use the same local variables (with
names like <code>tem</code>) over and over for different values within one
function. Instead of doing this, it is better to declare a separate local
variable for each distinct purpose, and give it a name which is
@@ -2347,7 +2349,7 @@
<p>Don't use local variables or parameters that shadow global identifiers.
- <p><a name="index-multiple-variables-in-a-line-72"></a>Don't declare
multiple variables in one declaration that spans lines.
+ <p><a name="index-multiple-variables-in-a-line-73"></a>Don't declare
multiple variables in one declaration that spans lines.
Start a new declaration on each line, instead. For example, instead
of this:
@@ -2422,7 +2424,7 @@
if (foo == 0)
fatal ("virtual memory exhausted");
</pre>
- <p><a name="index-lint-73"></a>Don't make the program ugly to placate
<code>lint</code>. Please don't insert any
+ <p><a name="index-lint-74"></a>Don't make the program ugly to placate
<code>lint</code>. Please don't insert any
casts to <code>void</code>. Zero without a cast is perfectly fine as a null
pointer constant, except when calling a varargs function.
@@ -2437,7 +2439,7 @@
<h3 class="section">5.4 Naming Variables, Functions, and Files</h3>
-<p><a name="index-names-of-variables_002c-functions_002c-and-files-74"></a>The
names of global variables and functions in a program serve as
+<p><a name="index-names-of-variables_002c-functions_002c-and-files-75"></a>The
names of global variables and functions in a program serve as
comments of a sort. So don't choose terse names—instead, look for
names that give useful information about the meaning of the variable or
function. In a GNU program, names should be English, like other
@@ -2470,7 +2472,7 @@
<code>enum</code> rather than ‘<samp><span
class="samp">#define</span></samp>’. GDB knows about enumeration
constants.
- <p><a name="index-file_002dname-limitations-75"></a><a
name="index-doschk-76"></a>You might want to make sure that none of the file
names would conflict
+ <p><a name="index-file_002dname-limitations-76"></a><a
name="index-doschk-77"></a>You might want to make sure that none of the file
names would conflict
if the files were loaded onto an MS-DOS file system which shortens the
names. You can use the program <code>doschk</code> to test for this.
@@ -2492,7 +2494,7 @@
<h3 class="section">5.5 Portability between System Types</h3>
-<p><a name="index-portability_002c-between-system-types-77"></a>
+<p><a name="index-portability_002c-between-system-types-78"></a>
In the Unix world, “portability” refers to porting to different
Unix
versions. For a GNU program, this kind of portability is desirable, but
not paramount.
@@ -2510,7 +2512,7 @@
But you don't have to consider it an obligation, if it does turn out to
be hard.
- <p><a name="index-autoconf-78"></a>The easiest way to achieve portability
to most Unix-like systems is to
+ <p><a name="index-autoconf-79"></a>The easiest way to achieve portability
to most Unix-like systems is to
use Autoconf. It's unlikely that your program needs to know more
information about the host platform than Autoconf can provide, simply
because most of the programs that need such knowledge have already been
@@ -2519,7 +2521,7 @@
<p>Avoid using the format of semi-internal data bases (e.g., directories)
when there is a higher-level alternative (<code>readdir</code>).
- <p><a
name="index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-79"></a>As
for systems that are not like Unix, such as MSDOS, Windows, VMS, MVS,
+ <p><a
name="index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-80"></a>As
for systems that are not like Unix, such as MSDOS, Windows, VMS, MVS,
and older Macintosh systems, supporting them is often a lot of work.
When that is the case, it is better to spend your time adding features
that will be useful on GNU and GNU/Linux, rather than on supporting
@@ -2557,7 +2559,7 @@
<h3 class="section">5.6 Portability between <span class="sc">cpu</span>s</h3>
-<p><a name="index-data-types_002c-and-portability-80"></a><a
name="index-portability_002c-and-data-types-81"></a>Even GNU systems will
differ because of differences among <span class="sc">cpu</span>
+<p><a name="index-data-types_002c-and-portability-81"></a><a
name="index-portability_002c-and-data-types-82"></a>Even GNU systems will
differ because of differences among <span class="sc">cpu</span>
types—for example, difference in byte ordering and alignment
requirements. It is absolutely essential to handle these differences.
However, don't make any effort to cater to the possibility that an
@@ -2642,7 +2644,7 @@
return fp;
}
</pre>
- <p><a name="index-casting-pointers-to-integers-82"></a>Avoid casting
pointers to integers if you can. Such casts greatly
+ <p><a name="index-casting-pointers-to-integers-83"></a>Avoid casting
pointers to integers if you can. Such casts greatly
reduce portability, and in most programs they are easy to avoid. In the
cases where casting pointers to integers is essential—such as, a Lisp
interpreter which stores type information as well as an address in one
@@ -2662,7 +2664,7 @@
<h3 class="section">5.7 Calling System Functions</h3>
-<p><a name="index-library-functions_002c-and-portability-83"></a><a
name="index-portability_002c-and-library-functions-84"></a>
+<p><a name="index-library-functions_002c-and-portability-84"></a><a
name="index-portability_002c-and-library-functions-85"></a>
C implementations differ substantially. Standard C reduces but does
not eliminate the incompatibilities; meanwhile, many GNU packages still
support pre-standard compilers because this is not hard to do. This
@@ -2679,7 +2681,7 @@
terminate either by calling <code>exit</code> or by returning the integer
status code; make sure it cannot ever return an undefined value.
- <p><a name="index-declaration-for-system-functions-85"></a><li>Don't
declare system functions explicitly.
+ <p><a name="index-declaration-for-system-functions-86"></a><li>Don't
declare system functions explicitly.
<p>Almost any declaration for a system function is wrong on some system.
To minimize conflicts, leave it to the system header files to declare
@@ -2714,7 +2716,7 @@
<code>realloc</code>—or put these declarations in configuration files
specific to those systems.
- <p><a name="index-string-library-functions-86"></a><li>The string
functions require special treatment. Some Unix systems have
+ <p><a name="index-string-library-functions-87"></a><li>The string
functions require special treatment. Some Unix systems have
a header file <samp><span class="file">string.h</span></samp>; others have
<samp><span class="file">strings.h</span></samp>. Neither
file name is portable. There are two things you can do: use Autoconf to
figure out which file to include, or don't include either file.
@@ -2784,8 +2786,8 @@
<h3 class="section">5.8 Internationalization</h3>
-<p><a name="index-internationalization-87"></a>
-<a name="index-gettext-88"></a>GNU has a library called GNU gettext that makes
it easy to translate the
+<p><a name="index-internationalization-88"></a>
+<a name="index-gettext-89"></a>GNU has a library called GNU gettext that makes
it easy to translate the
messages in a program into various languages. You should use this
library in every program. Use English for the messages as they appear
in the program, and let gettext provide the way to translate them into
@@ -2808,7 +2810,7 @@
Normally, the text domain name should be the same as the name of the
package—for example, ‘<samp><span
class="samp">coreutils</span></samp>’ for the GNU core utilities.
- <p><a name="index-message-text_002c-and-internationalization-89"></a>To
enable gettext to work well, avoid writing code that makes
+ <p><a name="index-message-text_002c-and-internationalization-90"></a>To
enable gettext to work well, avoid writing code that makes
assumptions about the structure of words or sentences. When you want
the precise text of a sentence to vary depending on the data, use two or
more alternative string constants each containing a complete sentences,
@@ -2888,7 +2890,7 @@
<h3 class="section">5.9 Character Set</h3>
-<p><a name="index-character-set-90"></a><a name="index-encodings-91"></a><a
name="index-ASCII-characters-92"></a><a
name="index-non_002dASCII-characters-93"></a>
+<p><a name="index-character-set-91"></a><a name="index-encodings-92"></a><a
name="index-ASCII-characters-93"></a><a
name="index-non_002dASCII-characters-94"></a>
Sticking to the ASCII character set (plain text, 7-bit characters) is
preferred in GNU source code comments, text documents, and other
contexts, unless there is good reason to do something else because of
@@ -2912,7 +2914,7 @@
<h3 class="section">5.10 Quote Characters</h3>
-<p><a name="index-quote-characters-94"></a><a
name="index-locale_002dspecific-quote-characters-95"></a><a
name="index-left-quote-96"></a><a name="index-grave-accent-97"></a>
+<p><a name="index-quote-characters-95"></a><a
name="index-locale_002dspecific-quote-characters-96"></a><a
name="index-left-quote-97"></a><a name="index-grave-accent-98"></a>
In the C locale, GNU programs should stick to plain ASCII for quotation
characters in messages to users: preferably 0x60 (‘<samp><span
class="samp">`</span></samp>’) for left
quotes and 0x27 (‘<samp><span class="samp">'</span></samp>’) for
right quotes. It is ok, but not
@@ -2951,7 +2953,7 @@
<h3 class="section">5.11 Mmap</h3>
-<p><a name="index-mmap-98"></a>
+<p><a name="index-mmap-99"></a>
Don't assume that <code>mmap</code> either works on all files or fails
for all files. It may work on some files and fail on others.
@@ -2976,7 +2978,7 @@
<h2 class="chapter">6 Documenting Programs</h2>
-<p><a name="index-documentation-99"></a>
+<p><a name="index-documentation-100"></a>
A GNU program should ideally come with full free documentation, adequate
for both reference and tutorial purposes. If the package can be
programmed or extended, the documentation should cover programming or
@@ -3157,7 +3159,7 @@
<h3 class="section">6.3 Manual Structure Details</h3>
-<p><a name="index-manual-structure-100"></a>
+<p><a name="index-manual-structure-101"></a>
The title page of the manual should state the version of the programs or
packages documented in the manual. The Top node of the manual should
also contain this information. If the manual is changing more
@@ -3194,7 +3196,7 @@
<h3 class="section">6.4 License for Manuals</h3>
-<p><a name="index-license-for-manuals-101"></a>
+<p><a name="index-license-for-manuals-102"></a>
Please use the GNU Free Documentation License for all GNU manuals that
are more than a few pages long. Likewise for a collection of short
documents—you only need one copy of the GNU FDL for the whole
@@ -3221,7 +3223,7 @@
<h3 class="section">6.5 Manual Credits</h3>
-<p><a name="index-credits-for-manuals-102"></a>
+<p><a name="index-credits-for-manuals-103"></a>
Please credit the principal human writers of the manual as the authors,
on the title page of the manual. If a company sponsored the work, thank
the company in a suitable place in the manual, but do not cite the
@@ -3259,7 +3261,7 @@
<h3 class="section">6.7 The NEWS File</h3>
-<p><a name="index-g_t_0040file_007bNEWS_007d-file-103"></a>
+<p><a name="index-g_t_0040file_007bNEWS_007d-file-104"></a>
In addition to its manual, the package should have a file named
<samp><span class="file">NEWS</span></samp> which contains a list of
user-visible changes worth
mentioning. In each new release, add items to the front of the file and
@@ -3282,7 +3284,7 @@
<h3 class="section">6.8 Change Logs</h3>
-<p><a name="index-change-logs-104"></a>
+<p><a name="index-change-logs-105"></a>
Keep a change log to describe all the changes made to program source
files. The purpose of this is so that people investigating bugs in the
future will know about the changes that might have introduced the bug.
@@ -3358,7 +3360,7 @@
<h4 class="subsection">6.8.2 Style of Change Logs</h4>
-<p><a name="index-change-logs_002c-style-105"></a>
+<p><a name="index-change-logs_002c-style-106"></a>
Here are some simple examples of change log entries, starting with the
header line that says who made the change and when it was installed,
followed by descriptions of specific changes. (These examples are
@@ -3468,7 +3470,7 @@
<h4 class="subsection">6.8.4 Conditional Changes</h4>
-<p><a name="index-conditional-changes_002c-and-change-logs-106"></a><a
name="index-change-logs_002c-conditional-changes-107"></a>
+<p><a name="index-conditional-changes_002c-and-change-logs-107"></a><a
name="index-change-logs_002c-conditional-changes-108"></a>
C programs often contain compile-time <code>#if</code> conditionals. Many
changes are conditional; sometimes you add a new definition which is
entirely contained in a conditional. It is very useful to indicate in
@@ -3528,7 +3530,7 @@
<h3 class="section">6.9 Man Pages</h3>
-<p><a name="index-man-pages-108"></a>
+<p><a name="index-man-pages-109"></a>
In the GNU project, man pages are secondary. It is not necessary or
expected for every GNU program to have a man page, but some of them do.
It's your choice whether to include a man page in your program.
@@ -3606,7 +3608,7 @@
<h2 class="chapter">7 The Release Process</h2>
-<p><a name="index-releasing-109"></a>
+<p><a name="index-releasing-110"></a>
Making a release is more than just bundling up your source files in a
tar file and putting it up for FTP. You should set up your software so
that it can be configured to run on a variety of systems. Your Makefile
@@ -3631,8 +3633,8 @@
<h3 class="section">7.1 How Configuration Should Work</h3>
-<p><a name="index-program-configuration-110"></a>
-<a name="index-configure-111"></a>Each GNU distribution should come with a
shell script named
+<p><a name="index-program-configuration-111"></a>
+<a name="index-configure-112"></a>Each GNU distribution should come with a
shell script named
<code>configure</code>. This script is given arguments which describe the
kind of machine and system you want to compile the program for.
@@ -3719,7 +3721,7 @@
the shell script
<a
href="http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD"><samp><span
class="file">config.guess</span></samp></a>.
- <p><a name="index-optional-features_002c-configure_002dtime-112"></a>Other
options are permitted to specify in more detail the software
+ <p><a name="index-optional-features_002c-configure_002dtime-113"></a>Other
options are permitted to specify in more detail the software
or hardware present on the machine, to include or exclude optional parts
of the package, or to adjust the name of some tools or arguments to them:
@@ -3828,7 +3830,7 @@
<h3 class="section">7.2 Makefile Conventions</h3>
<!-- standards.texi does not print an index, but make.texinfo does. -->
-<p><a name="index-makefile_002c-conventions-for-113"></a><a
name="index-conventions-for-makefiles-114"></a><a
name="index-standards-for-makefiles-115"></a>
+<p><a name="index-makefile_002c-conventions-for-114"></a><a
name="index-conventions-for-makefiles-115"></a><a
name="index-standards-for-makefiles-116"></a>
<!-- Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2001, -->
<!-- 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. -->
@@ -4100,7 +4102,7 @@
<h4 class="subsection">7.2.4 <code>DESTDIR</code>: support for staged
installs</h4>
-<p><a name="index-DESTDIR-116"></a><a name="index-staged-installs-117"></a><a
name="index-installations_002c-staged-118"></a>
+<p><a name="index-DESTDIR-117"></a><a name="index-staged-installs-118"></a><a
name="index-installations_002c-staged-119"></a>
<code>DESTDIR</code> is a variable prepended to each installed target file,
like this:
@@ -4177,7 +4179,7 @@
directories.
<dl>
-<dt><code>prefix</code><dd><a name="index-prefix-119"></a>A prefix used in
constructing the default values of the variables listed
+<dt><code>prefix</code><dd><a name="index-prefix-120"></a>A prefix used in
constructing the default values of the variables listed
below. The default value of <code>prefix</code> should be <samp><span
class="file">/usr/local</span></samp>.
When building the complete GNU system, the prefix will be empty and
<samp><span class="file">/usr</span></samp> will be a symbolic link to
<samp><span class="file">/</span></samp>.
@@ -4187,7 +4189,7 @@
the one used to build the program should <em>not</em> recompile the
program.
- <br><dt><code>exec_prefix</code><dd><a
name="index-exec_005fprefix-120"></a>A prefix used in constructing the default
values of some of the
+ <br><dt><code>exec_prefix</code><dd><a
name="index-exec_005fprefix-121"></a>A prefix used in constructing the default
values of some of the
variables listed below. The default value of <code>exec_prefix</code> should
be <code>$(prefix)</code>.
(If you are using Autoconf, write it as ‘<samp><span
class="samp">@exec_prefix@</span></samp>’.)
@@ -4204,18 +4206,18 @@
<p>Executable programs are installed in one of the following directories.
<dl>
-<dt><code>bindir</code><dd><a name="index-bindir-121"></a>The directory for
installing executable programs that users can run.
+<dt><code>bindir</code><dd><a name="index-bindir-122"></a>The directory for
installing executable programs that users can run.
This should normally be <samp><span class="file">/usr/local/bin</span></samp>,
but write it as
<samp><span class="file">$(exec_prefix)/bin</span></samp>.
(If you are using Autoconf, write it as ‘<samp><span
class="samp">@bindir@</span></samp>’.)
- <br><dt><code>sbindir</code><dd><a name="index-sbindir-122"></a>The
directory for installing executable programs that can be run from
+ <br><dt><code>sbindir</code><dd><a name="index-sbindir-123"></a>The
directory for installing executable programs that can be run from
the shell, but are only generally useful to system administrators. This
should normally be <samp><span class="file">/usr/local/sbin</span></samp>, but
write it as
<samp><span class="file">$(exec_prefix)/sbin</span></samp>.
(If you are using Autoconf, write it as ‘<samp><span
class="samp">@sbindir@</span></samp>’.)
- <br><dt><code>libexecdir</code><dd><a
name="index-libexecdir-123"></a><!-- This paragraph adjusted to avoid overfull
hbox -roland 5jul94 -->
+ <br><dt><code>libexecdir</code><dd><a
name="index-libexecdir-124"></a><!-- This paragraph adjusted to avoid overfull
hbox -roland 5jul94 -->
The directory for installing executable programs to be run by other
programs rather than by users. This directory should normally be
<samp><span class="file">/usr/local/libexec</span></samp>, but write it as
<samp><span class="file">$(exec_prefix)/libexec</span></samp>.
@@ -4763,7 +4765,7 @@
<h4 class="subsection">7.2.7 Install Command Categories</h4>
-<p><a name="index-pre_002dinstallation-commands-124"></a><a
name="index-post_002dinstallation-commands-125"></a>When writing the
<code>install</code> target, you must classify all the
+<p><a name="index-pre_002dinstallation-commands-125"></a><a
name="index-post_002dinstallation-commands-126"></a>When writing the
<code>install</code> target, you must classify all the
commands into three categories: normal ones, <dfn>pre-installation</dfn>
commands and <dfn>post-installation</dfn> commands.
@@ -4836,7 +4838,7 @@
mkdir mkfifo mknod mv printenv pwd rm rmdir sed sort tee
test touch true uname xargs yes
</pre>
- <p><a name="index-binary-packages-126"></a>The reason for distinguishing
the commands in this way is for the sake
+ <p><a name="index-binary-packages-127"></a>The reason for distinguishing
the commands in this way is for the sake
of making binary packages. Typically a binary package contains all the
executables and other files that need to be installed, and has its own
method of installing them—so it does not need to run the normal
@@ -4871,7 +4873,7 @@
<h3 class="section">7.3 Making Releases</h3>
-<p><a name="index-packaging-127"></a>
+<p><a name="index-packaging-128"></a>
You should identify each release with a pair of version numbers, a
major version and a minor. We have no objection to using more than
two numbers, but it is very unlikely that you really need them.
@@ -4887,7 +4889,7 @@
and never changed automatically; non-source files are produced from
source files by programs under the control of the Makefile.
- <p><a name="index-g_t_0040file_007bREADME_007d-file-128"></a>The
distribution should contain a file named <samp><span
class="file">README</span></samp> which gives
+ <p><a name="index-g_t_0040file_007bREADME_007d-file-129"></a>The
distribution should contain a file named <samp><span
class="file">README</span></samp> which gives
the name of the package, and a general description of what it does. It
is also good to explain the purpose of each of the first-level
subdirectories in the package, if there are any. The <samp><span
class="file">README</span></samp> file
@@ -4938,7 +4940,7 @@
are truncated to <samp><span class="file">foobarha.c</span></samp> and
<samp><span class="file">foobarha.o</span></samp>, which are
distinct.
- <p><a
name="index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-129"></a>Include
in your distribution a copy of the <samp><span
class="file">texinfo.tex</span></samp> you used
+ <p><a
name="index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-130"></a>Include
in your distribution a copy of the <samp><span
class="file">texinfo.tex</span></samp> you used
to test print any <samp><span class="file">*.texinfo</span></samp> or
<samp><span class="file">*.texi</span></samp> files.
<p>Likewise, if your program uses small GNU software packages like regex,
@@ -4958,7 +4960,7 @@
<h2 class="chapter">8 References to Non-Free Software and Documentation</h2>
-<p><a name="index-references-to-non_002dfree-material-130"></a>
+<p><a name="index-references-to-non_002dfree-material-131"></a>
A GNU program should not recommend, promote, or grant legitimacy to
the use of any non-free program. Proprietary software is a social and
ethical problem, and our aim is to put an end to that problem. We
@@ -5075,7 +5077,7 @@
<h2 class="appendix">Appendix A GNU Free Documentation License</h2>
-<p><a name="index-FDL_002c-GNU-Free-Documentation-License-131"></a>
+<p><a name="index-FDL_002c-GNU-Free-Documentation-License-132"></a>
<!-- The GNU Free Documentation License. -->
<div align="center">Version 1.2, November 2002</div>
@@ -5500,135 +5502,136 @@
<h2 class="unnumbered">Index</h2>
<ul class="index-cp" compact>
-<li><a
href="#index-g_t_0040code_007b_0023endif_007d_002c-commenting-65"><code>#endif</code>,
commenting</a>: <a href="#Comments">Comments</a></li>
-<li><a
href="#index-g_t_0040samp_007b_002d_002dhelp_007d-output-49">‘<samp><span
class="samp">--help</span></samp>’ output</a>: <a
href="#g_t_002d_002dhelp">--help</a></li>
-<li><a
href="#index-g_t_0040samp_007b_002d_002dversion_007d-output-46">‘<samp><span
class="samp">--version</span></samp>’ output</a>: <a
href="#g_t_002d_002dversion">--version</a></li>
-<li><a
href="#index-g_t_0040samp_007b_002dWall_007d-compiler-option-70">‘<samp><span
class="samp">-Wall</span></samp>’ compiler option</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a
href="#index-g_t_0040code_007b_0023endif_007d_002c-commenting-66"><code>#endif</code>,
commenting</a>: <a href="#Comments">Comments</a></li>
+<li><a
href="#index-g_t_0040samp_007b_002d_002dhelp_007d-output-50">‘<samp><span
class="samp">--help</span></samp>’ output</a>: <a
href="#g_t_002d_002dhelp">--help</a></li>
+<li><a
href="#index-g_t_0040samp_007b_002d_002dversion_007d-output-47">‘<samp><span
class="samp">--version</span></samp>’ output</a>: <a
href="#g_t_002d_002dversion">--version</a></li>
+<li><a
href="#index-g_t_0040samp_007b_002dWall_007d-compiler-option-71">‘<samp><span
class="samp">-Wall</span></samp>’ compiler option</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
<li><a href="#index-accepting-contributions-7">accepting contributions</a>: <a
href="#Contributions">Contributions</a></li>
-<li><a href="#index-address-for-bug-reports-50">address for bug reports</a>:
<a href="#g_t_002d_002dhelp">--help</a></li>
-<li><a href="#index-g_t_0040sc_007bansi_007d-C-standard-17"><span
class="sc">ansi</span> C standard</a>: <a href="#Standard-C">Standard C</a></li>
-<li><a href="#index-arbitrary-limits-on-data-19">arbitrary limits on data</a>:
<a href="#Semantics">Semantics</a></li>
-<li><a href="#index-ASCII-characters-92">ASCII characters</a>: <a
href="#Character-Set">Character Set</a></li>
-<li><a href="#index-autoconf-78"><code>autoconf</code></a>: <a
href="#System-Portability">System Portability</a></li>
+<li><a href="#index-address-for-bug-reports-51">address for bug reports</a>:
<a href="#g_t_002d_002dhelp">--help</a></li>
+<li><a href="#index-g_t_0040sc_007bansi_007d-C-standard-18"><span
class="sc">ansi</span> C standard</a>: <a href="#Standard-C">Standard C</a></li>
+<li><a href="#index-arbitrary-limits-on-data-20">arbitrary limits on data</a>:
<a href="#Semantics">Semantics</a></li>
+<li><a href="#index-ASCII-characters-93">ASCII characters</a>: <a
href="#Character-Set">Character Set</a></li>
+<li><a href="#index-autoconf-79"><code>autoconf</code></a>: <a
href="#System-Portability">System Portability</a></li>
<li><a href="#index-avoiding-proprietary-code-5">avoiding proprietary
code</a>: <a href="#Reading-Non_002dFree-Code">Reading Non-Free Code</a></li>
-<li><a
href="#index-behavior_002c-dependent-on-program_0027s-name-33">behavior,
dependent on program's name</a>: <a href="#User-Interfaces">User
Interfaces</a></li>
-<li><a href="#index-binary-packages-126">binary packages</a>: <a
href="#Install-Command-Categories">Install Command Categories</a></li>
-<li><a href="#index-bindir-121"><code>bindir</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
-<li><a href="#index-braces_002c-in-C-source-58">braces, in C source</a>: <a
href="#Formatting">Formatting</a></li>
-<li><a href="#index-bug-reports-51">bug reports</a>: <a
href="#g_t_002d_002dhelp">--help</a></li>
-<li><a href="#index-canonical-name-of-a-program-47">canonical name of a
program</a>: <a href="#g_t_002d_002dversion">--version</a></li>
-<li><a href="#index-casting-pointers-to-integers-82">casting pointers to
integers</a>: <a href="#CPU-Portability">CPU Portability</a></li>
-<li><a href="#index-CGI-programs_002c-standard-options-for-44">CGI programs,
standard options for</a>: <a href="#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a href="#index-change-logs-104">change logs</a>: <a
href="#Change-Logs">Change Logs</a></li>
-<li><a href="#index-change-logs_002c-conditional-changes-107">change logs,
conditional changes</a>: <a href="#Conditional-Changes">Conditional
Changes</a></li>
-<li><a href="#index-change-logs_002c-style-105">change logs, style</a>: <a
href="#Style-of-Change-Logs">Style of Change Logs</a></li>
-<li><a href="#index-character-set-90">character set</a>: <a
href="#Character-Set">Character Set</a></li>
-<li><a href="#index-command_002dline-arguments_002c-decoding-24">command-line
arguments, decoding</a>: <a href="#Semantics">Semantics</a></li>
-<li><a href="#index-command_002dline-interface-39">command-line interface</a>:
<a href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
-<li><a href="#index-commenting-63">commenting</a>: <a
href="#Comments">Comments</a></li>
-<li><a
href="#index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-12">compatibility
with C and <span class="sc">posix</span> standards</a>: <a
href="#Compatibility">Compatibility</a></li>
-<li><a href="#index-compiler-warnings-69">compiler warnings</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
-<li><a href="#index-conditional-changes_002c-and-change-logs-106">conditional
changes, and change logs</a>: <a href="#Conditional-Changes">Conditional
Changes</a></li>
-<li><a href="#index-conditionals_002c-comments-for-64">conditionals, comments
for</a>: <a href="#Comments">Comments</a></li>
-<li><a href="#index-configure-111"><code>configure</code></a>: <a
href="#Configuration">Configuration</a></li>
-<li><a href="#index-control_002dL-62">control-L</a>: <a
href="#Formatting">Formatting</a></li>
-<li><a href="#index-conventions-for-makefiles-114">conventions for
makefiles</a>: <a href="#Makefile-Conventions">Makefile Conventions</a></li>
-<li><a href="#index-corba-37">corba</a>: <a
href="#Graphical-Interfaces">Graphical Interfaces</a></li>
-<li><a href="#index-credits-for-manuals-102">credits for manuals</a>: <a
href="#Manual-Credits">Manual Credits</a></li>
-<li><a href="#index-data-types_002c-and-portability-80">data types, and
portability</a>: <a href="#CPU-Portability">CPU Portability</a></li>
-<li><a href="#index-declaration-for-system-functions-85">declaration for
system functions</a>: <a href="#System-Functions">System Functions</a></li>
-<li><a href="#index-DESTDIR-116"><code>DESTDIR</code></a>: <a
href="#DESTDIR">DESTDIR</a></li>
-<li><a href="#index-documentation-99">documentation</a>: <a
href="#Documentation">Documentation</a></li>
-<li><a href="#index-doschk-76"><code>doschk</code></a>: <a
href="#Names">Names</a></li>
+<li><a
href="#index-behavior_002c-dependent-on-program_0027s-name-34">behavior,
dependent on program's name</a>: <a href="#User-Interfaces">User
Interfaces</a></li>
+<li><a href="#index-binary-packages-127">binary packages</a>: <a
href="#Install-Command-Categories">Install Command Categories</a></li>
+<li><a href="#index-bindir-122"><code>bindir</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
+<li><a href="#index-braces_002c-in-C-source-59">braces, in C source</a>: <a
href="#Formatting">Formatting</a></li>
+<li><a href="#index-bug-reports-52">bug reports</a>: <a
href="#g_t_002d_002dhelp">--help</a></li>
+<li><a href="#index-canonical-name-of-a-program-48">canonical name of a
program</a>: <a href="#g_t_002d_002dversion">--version</a></li>
+<li><a href="#index-casting-pointers-to-integers-83">casting pointers to
integers</a>: <a href="#CPU-Portability">CPU Portability</a></li>
+<li><a href="#index-CGI-programs_002c-standard-options-for-45">CGI programs,
standard options for</a>: <a href="#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a href="#index-change-logs-105">change logs</a>: <a
href="#Change-Logs">Change Logs</a></li>
+<li><a href="#index-change-logs_002c-conditional-changes-108">change logs,
conditional changes</a>: <a href="#Conditional-Changes">Conditional
Changes</a></li>
+<li><a href="#index-change-logs_002c-style-106">change logs, style</a>: <a
href="#Style-of-Change-Logs">Style of Change Logs</a></li>
+<li><a href="#index-character-set-91">character set</a>: <a
href="#Character-Set">Character Set</a></li>
+<li><a href="#index-command_002dline-arguments_002c-decoding-25">command-line
arguments, decoding</a>: <a href="#Semantics">Semantics</a></li>
+<li><a href="#index-command_002dline-interface-40">command-line interface</a>:
<a href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
+<li><a href="#index-commenting-64">commenting</a>: <a
href="#Comments">Comments</a></li>
+<li><a
href="#index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-13">compatibility
with C and <span class="sc">posix</span> standards</a>: <a
href="#Compatibility">Compatibility</a></li>
+<li><a href="#index-compiler-warnings-70">compiler warnings</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a href="#index-conditional-changes_002c-and-change-logs-107">conditional
changes, and change logs</a>: <a href="#Conditional-Changes">Conditional
Changes</a></li>
+<li><a href="#index-conditionals_002c-comments-for-65">conditionals, comments
for</a>: <a href="#Comments">Comments</a></li>
+<li><a href="#index-configure-112"><code>configure</code></a>: <a
href="#Configuration">Configuration</a></li>
+<li><a href="#index-control_002dL-63">control-L</a>: <a
href="#Formatting">Formatting</a></li>
+<li><a href="#index-conventions-for-makefiles-115">conventions for
makefiles</a>: <a href="#Makefile-Conventions">Makefile Conventions</a></li>
+<li><a href="#index-corba-38">corba</a>: <a
href="#Graphical-Interfaces">Graphical Interfaces</a></li>
+<li><a href="#index-credits-for-manuals-103">credits for manuals</a>: <a
href="#Manual-Credits">Manual Credits</a></li>
+<li><a href="#index-data-types_002c-and-portability-81">data types, and
portability</a>: <a href="#CPU-Portability">CPU Portability</a></li>
+<li><a href="#index-declaration-for-system-functions-86">declaration for
system functions</a>: <a href="#System-Functions">System Functions</a></li>
+<li><a href="#index-DESTDIR-117"><code>DESTDIR</code></a>: <a
href="#DESTDIR">DESTDIR</a></li>
+<li><a href="#index-documentation-100">documentation</a>: <a
href="#Documentation">Documentation</a></li>
+<li><a href="#index-doschk-77"><code>doschk</code></a>: <a
href="#Names">Names</a></li>
<li><a href="#index-downloading-this-manual-2">downloading this manual</a>: <a
href="#Preface">Preface</a></li>
-<li><a href="#index-encodings-91">encodings</a>: <a
href="#Character-Set">Character Set</a></li>
-<li><a href="#index-error-messages-21">error messages</a>: <a
href="#Semantics">Semantics</a></li>
-<li><a href="#index-error-messages_002c-formatting-31">error messages,
formatting</a>: <a href="#Errors">Errors</a></li>
-<li><a href="#index-exec_005fprefix-120"><code>exec_prefix</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
-<li><a href="#index-expressions_002c-splitting-60">expressions, splitting</a>:
<a href="#Formatting">Formatting</a></li>
-<li><a href="#index-FDL_002c-GNU-Free-Documentation-License-131">FDL, GNU Free
Documentation License</a>: <a href="#GNU-Free-Documentation-License">GNU Free
Documentation License</a></li>
-<li><a href="#index-file-usage-55">file usage</a>: <a href="#File-Usage">File
Usage</a></li>
-<li><a href="#index-file_002dname-limitations-75">file-name limitations</a>:
<a href="#Names">Names</a></li>
-<li><a href="#index-formatting-error-messages-30">formatting error
messages</a>: <a href="#Errors">Errors</a></li>
-<li><a href="#index-formatting-source-code-56">formatting source code</a>: <a
href="#Formatting">Formatting</a></li>
-<li><a href="#index-formfeed-61">formfeed</a>: <a
href="#Formatting">Formatting</a></li>
-<li><a href="#index-function-argument_002c-declaring-68">function argument,
declaring</a>: <a href="#Syntactic-Conventions">Syntactic Conventions</a></li>
-<li><a href="#index-function-prototypes-18">function prototypes</a>: <a
href="#Standard-C">Standard C</a></li>
-<li><a href="#index-getopt-40"><code>getopt</code></a>: <a
href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
-<li><a href="#index-gettext-88"><code>gettext</code></a>: <a
href="#Internationalization">Internationalization</a></li>
-<li><a href="#index-gnome-38">gnome</a>: <a
href="#Graphical-Interfaces">Graphical Interfaces</a></li>
-<li><a href="#index-graphical-user-interface-35">graphical user interface</a>:
<a href="#Graphical-Interfaces">Graphical Interfaces</a></li>
-<li><a href="#index-grave-accent-97">grave accent</a>: <a
href="#Quote-Characters">Quote Characters</a></li>
-<li><a href="#index-gtk_002b-36">gtk+</a>: <a
href="#Graphical-Interfaces">Graphical Interfaces</a></li>
-<li><a href="#index-GUILE-11">GUILE</a>: <a href="#Source-Language">Source
Language</a></li>
-<li><a href="#index-implicit-_0040code_007bint_007d-67">implicit
<code>int</code></a>: <a href="#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a href="#index-impossible-conditions-26">impossible conditions</a>: <a
href="#Semantics">Semantics</a></li>
-<li><a href="#index-installations_002c-staged-118">installations, staged</a>:
<a href="#DESTDIR">DESTDIR</a></li>
-<li><a href="#index-internationalization-87">internationalization</a>: <a
href="#Internationalization">Internationalization</a></li>
-<li><a href="#index-left-quote-96">left quote</a>: <a
href="#Quote-Characters">Quote Characters</a></li>
+<li><a href="#index-encodings-92">encodings</a>: <a
href="#Character-Set">Character Set</a></li>
+<li><a href="#index-error-messages-22">error messages</a>: <a
href="#Semantics">Semantics</a></li>
+<li><a href="#index-error-messages_002c-formatting-32">error messages,
formatting</a>: <a href="#Errors">Errors</a></li>
+<li><a href="#index-exec_005fprefix-121"><code>exec_prefix</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
+<li><a href="#index-expressions_002c-splitting-61">expressions, splitting</a>:
<a href="#Formatting">Formatting</a></li>
+<li><a href="#index-FDL_002c-GNU-Free-Documentation-License-132">FDL, GNU Free
Documentation License</a>: <a href="#GNU-Free-Documentation-License">GNU Free
Documentation License</a></li>
+<li><a href="#index-file-usage-56">file usage</a>: <a href="#File-Usage">File
Usage</a></li>
+<li><a href="#index-file_002dname-limitations-76">file-name limitations</a>:
<a href="#Names">Names</a></li>
+<li><a href="#index-formatting-error-messages-31">formatting error
messages</a>: <a href="#Errors">Errors</a></li>
+<li><a href="#index-formatting-source-code-57">formatting source code</a>: <a
href="#Formatting">Formatting</a></li>
+<li><a href="#index-formfeed-62">formfeed</a>: <a
href="#Formatting">Formatting</a></li>
+<li><a href="#index-function-argument_002c-declaring-69">function argument,
declaring</a>: <a href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a href="#index-function-prototypes-19">function prototypes</a>: <a
href="#Standard-C">Standard C</a></li>
+<li><a href="#index-getopt-41"><code>getopt</code></a>: <a
href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
+<li><a href="#index-gettext-89"><code>gettext</code></a>: <a
href="#Internationalization">Internationalization</a></li>
+<li><a href="#index-gnome-39">gnome</a>: <a
href="#Graphical-Interfaces">Graphical Interfaces</a></li>
+<li><a href="#index-GNOME-and-Guile-12">GNOME and Guile</a>: <a
href="#Source-Language">Source Language</a></li>
+<li><a href="#index-graphical-user-interface-36">graphical user interface</a>:
<a href="#Graphical-Interfaces">Graphical Interfaces</a></li>
+<li><a href="#index-grave-accent-98">grave accent</a>: <a
href="#Quote-Characters">Quote Characters</a></li>
+<li><a href="#index-gtk_002b-37">gtk+</a>: <a
href="#Graphical-Interfaces">Graphical Interfaces</a></li>
+<li><a href="#index-Guile-11">Guile</a>: <a href="#Source-Language">Source
Language</a></li>
+<li><a href="#index-implicit-_0040code_007bint_007d-68">implicit
<code>int</code></a>: <a href="#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a href="#index-impossible-conditions-27">impossible conditions</a>: <a
href="#Semantics">Semantics</a></li>
+<li><a href="#index-installations_002c-staged-119">installations, staged</a>:
<a href="#DESTDIR">DESTDIR</a></li>
+<li><a href="#index-internationalization-88">internationalization</a>: <a
href="#Internationalization">Internationalization</a></li>
+<li><a href="#index-left-quote-97">left quote</a>: <a
href="#Quote-Characters">Quote Characters</a></li>
<li><a href="#index-legal-aspects-3">legal aspects</a>: <a
href="#Legal-Issues">Legal Issues</a></li>
<li><a href="#index-legal-papers-6">legal papers</a>: <a
href="#Contributions">Contributions</a></li>
-<li><a href="#index-libexecdir-123"><code>libexecdir</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
-<li><a href="#index-libraries-29">libraries</a>: <a
href="#Libraries">Libraries</a></li>
-<li><a href="#index-library-functions_002c-and-portability-83">library
functions, and portability</a>: <a href="#System-Functions">System
Functions</a></li>
-<li><a href="#index-license-for-manuals-101">license for manuals</a>: <a
href="#License-for-Manuals">License for Manuals</a></li>
-<li><a href="#index-lint-73"><code>lint</code></a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
-<li><a href="#index-locale_002dspecific-quote-characters-95">locale-specific
quote characters</a>: <a href="#Quote-Characters">Quote Characters</a></li>
-<li><a href="#index-long-option-names-52">long option names</a>: <a
href="#Option-Table">Option Table</a></li>
-<li><a href="#index-long_002dnamed-options-41">long-named options</a>: <a
href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
-<li><a href="#index-makefile_002c-conventions-for-113">makefile, conventions
for</a>: <a href="#Makefile-Conventions">Makefile Conventions</a></li>
-<li><a
href="#index-g_t_0040code_007bmalloc_007d-return-value-22"><code>malloc</code>
return value</a>: <a href="#Semantics">Semantics</a></li>
-<li><a href="#index-man-pages-108">man pages</a>: <a href="#Man-Pages">Man
Pages</a></li>
-<li><a href="#index-manual-structure-100">manual structure</a>: <a
href="#Manual-Structure-Details">Manual Structure Details</a></li>
-<li><a href="#index-memory-allocation-failure-23">memory allocation
failure</a>: <a href="#Semantics">Semantics</a></li>
-<li><a href="#index-memory-usage-54">memory usage</a>: <a
href="#Memory-Usage">Memory Usage</a></li>
-<li><a href="#index-message-text_002c-and-internationalization-89">message
text, and internationalization</a>: <a
href="#Internationalization">Internationalization</a></li>
-<li><a href="#index-mmap-98"><code>mmap</code></a>: <a
href="#Mmap">Mmap</a></li>
-<li><a href="#index-multiple-variables-in-a-line-72">multiple variables in a
line</a>: <a href="#Syntactic-Conventions">Syntactic Conventions</a></li>
-<li><a href="#index-names-of-variables_002c-functions_002c-and-files-74">names
of variables, functions, and files</a>: <a href="#Names">Names</a></li>
-<li><a href="#index-g_t_0040file_007bNEWS_007d-file-103"><samp><span
class="file">NEWS</span></samp> file</a>: <a href="#NEWS-File">NEWS
File</a></li>
-<li><a href="#index-non_002dASCII-characters-93">non-ASCII characters</a>: <a
href="#Character-Set">Character Set</a></li>
-<li><a
href="#index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-79">non-<span
class="sc">posix</span> systems, and portability</a>: <a
href="#System-Portability">System Portability</a></li>
-<li><a href="#index-non_002dstandard-extensions-16">non-standard
extensions</a>: <a href="#Using-Extensions">Using Extensions</a></li>
-<li><a href="#index-g_t_0040code_007bNUL_007d-characters-20"><code>NUL</code>
characters</a>: <a href="#Semantics">Semantics</a></li>
-<li><a href="#index-open-brace-57">open brace</a>: <a
href="#Formatting">Formatting</a></li>
-<li><a href="#index-optional-features_002c-configure_002dtime-112">optional
features, configure-time</a>: <a href="#Configuration">Configuration</a></li>
-<li><a href="#index-options-for-compatibility-14">options for
compatibility</a>: <a href="#Compatibility">Compatibility</a></li>
-<li><a href="#index-options_002c-standard-command_002dline-43">options,
standard command-line</a>: <a href="#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a href="#index-output-device-and-program_0027s-behavior-34">output device
and program's behavior</a>: <a href="#User-Interfaces">User Interfaces</a></li>
-<li><a href="#index-packaging-127">packaging</a>: <a
href="#Releases">Releases</a></li>
-<li><a
href="#index-PATH_005fINFO_002c-specifying-standard-options-as-45">PATH_INFO,
specifying standard options as</a>: <a
href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
-<li><a href="#index-portability_002c-and-data-types-81">portability, and data
types</a>: <a href="#CPU-Portability">CPU Portability</a></li>
-<li><a href="#index-portability_002c-and-library-functions-84">portability,
and library functions</a>: <a href="#System-Functions">System Functions</a></li>
-<li><a href="#index-portability_002c-between-system-types-77">portability,
between system types</a>: <a href="#System-Portability">System
Portability</a></li>
-<li><a href="#index-g_t_0040sc_007bposix_007d-compatibility-13"><span
class="sc">posix</span> compatibility</a>: <a
href="#Compatibility">Compatibility</a></li>
-<li><a
href="#index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-15"><code>POSIXLY_CORRECT</code>,
environment variable</a>: <a href="#Compatibility">Compatibility</a></li>
-<li><a href="#index-post_002dinstallation-commands-125">post-installation
commands</a>: <a href="#Install-Command-Categories">Install Command
Categories</a></li>
-<li><a href="#index-pre_002dinstallation-commands-124">pre-installation
commands</a>: <a href="#Install-Command-Categories">Install Command
Categories</a></li>
-<li><a href="#index-prefix-119"><code>prefix</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
-<li><a href="#index-program-configuration-110">program configuration</a>: <a
href="#Configuration">Configuration</a></li>
+<li><a href="#index-libexecdir-124"><code>libexecdir</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
+<li><a href="#index-libraries-30">libraries</a>: <a
href="#Libraries">Libraries</a></li>
+<li><a href="#index-library-functions_002c-and-portability-84">library
functions, and portability</a>: <a href="#System-Functions">System
Functions</a></li>
+<li><a href="#index-license-for-manuals-102">license for manuals</a>: <a
href="#License-for-Manuals">License for Manuals</a></li>
+<li><a href="#index-lint-74"><code>lint</code></a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a href="#index-locale_002dspecific-quote-characters-96">locale-specific
quote characters</a>: <a href="#Quote-Characters">Quote Characters</a></li>
+<li><a href="#index-long-option-names-53">long option names</a>: <a
href="#Option-Table">Option Table</a></li>
+<li><a href="#index-long_002dnamed-options-42">long-named options</a>: <a
href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
+<li><a href="#index-makefile_002c-conventions-for-114">makefile, conventions
for</a>: <a href="#Makefile-Conventions">Makefile Conventions</a></li>
+<li><a
href="#index-g_t_0040code_007bmalloc_007d-return-value-23"><code>malloc</code>
return value</a>: <a href="#Semantics">Semantics</a></li>
+<li><a href="#index-man-pages-109">man pages</a>: <a href="#Man-Pages">Man
Pages</a></li>
+<li><a href="#index-manual-structure-101">manual structure</a>: <a
href="#Manual-Structure-Details">Manual Structure Details</a></li>
+<li><a href="#index-memory-allocation-failure-24">memory allocation
failure</a>: <a href="#Semantics">Semantics</a></li>
+<li><a href="#index-memory-usage-55">memory usage</a>: <a
href="#Memory-Usage">Memory Usage</a></li>
+<li><a href="#index-message-text_002c-and-internationalization-90">message
text, and internationalization</a>: <a
href="#Internationalization">Internationalization</a></li>
+<li><a href="#index-mmap-99"><code>mmap</code></a>: <a
href="#Mmap">Mmap</a></li>
+<li><a href="#index-multiple-variables-in-a-line-73">multiple variables in a
line</a>: <a href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a href="#index-names-of-variables_002c-functions_002c-and-files-75">names
of variables, functions, and files</a>: <a href="#Names">Names</a></li>
+<li><a href="#index-g_t_0040file_007bNEWS_007d-file-104"><samp><span
class="file">NEWS</span></samp> file</a>: <a href="#NEWS-File">NEWS
File</a></li>
+<li><a href="#index-non_002dASCII-characters-94">non-ASCII characters</a>: <a
href="#Character-Set">Character Set</a></li>
+<li><a
href="#index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-80">non-<span
class="sc">posix</span> systems, and portability</a>: <a
href="#System-Portability">System Portability</a></li>
+<li><a href="#index-non_002dstandard-extensions-17">non-standard
extensions</a>: <a href="#Using-Extensions">Using Extensions</a></li>
+<li><a href="#index-g_t_0040code_007bNUL_007d-characters-21"><code>NUL</code>
characters</a>: <a href="#Semantics">Semantics</a></li>
+<li><a href="#index-open-brace-58">open brace</a>: <a
href="#Formatting">Formatting</a></li>
+<li><a href="#index-optional-features_002c-configure_002dtime-113">optional
features, configure-time</a>: <a href="#Configuration">Configuration</a></li>
+<li><a href="#index-options-for-compatibility-15">options for
compatibility</a>: <a href="#Compatibility">Compatibility</a></li>
+<li><a href="#index-options_002c-standard-command_002dline-44">options,
standard command-line</a>: <a href="#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a href="#index-output-device-and-program_0027s-behavior-35">output device
and program's behavior</a>: <a href="#User-Interfaces">User Interfaces</a></li>
+<li><a href="#index-packaging-128">packaging</a>: <a
href="#Releases">Releases</a></li>
+<li><a
href="#index-PATH_005fINFO_002c-specifying-standard-options-as-46">PATH_INFO,
specifying standard options as</a>: <a
href="#Command_002dLine-Interfaces">Command-Line Interfaces</a></li>
+<li><a href="#index-portability_002c-and-data-types-82">portability, and data
types</a>: <a href="#CPU-Portability">CPU Portability</a></li>
+<li><a href="#index-portability_002c-and-library-functions-85">portability,
and library functions</a>: <a href="#System-Functions">System Functions</a></li>
+<li><a href="#index-portability_002c-between-system-types-78">portability,
between system types</a>: <a href="#System-Portability">System
Portability</a></li>
+<li><a href="#index-g_t_0040sc_007bposix_007d-compatibility-14"><span
class="sc">posix</span> compatibility</a>: <a
href="#Compatibility">Compatibility</a></li>
+<li><a
href="#index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-16"><code>POSIXLY_CORRECT</code>,
environment variable</a>: <a href="#Compatibility">Compatibility</a></li>
+<li><a href="#index-post_002dinstallation-commands-126">post-installation
commands</a>: <a href="#Install-Command-Categories">Install Command
Categories</a></li>
+<li><a href="#index-pre_002dinstallation-commands-125">pre-installation
commands</a>: <a href="#Install-Command-Categories">Install Command
Categories</a></li>
+<li><a href="#index-prefix-120"><code>prefix</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
+<li><a href="#index-program-configuration-111">program configuration</a>: <a
href="#Configuration">Configuration</a></li>
<li><a href="#index-program-design-9">program design</a>: <a
href="#Design-Advice">Design Advice</a></li>
-<li><a href="#index-program-name-and-its-behavior-32">program name and its
behavior</a>: <a href="#User-Interfaces">User Interfaces</a></li>
-<li><a href="#index-program_0027s-canonical-name-48">program's canonical
name</a>: <a href="#g_t_002d_002dversion">--version</a></li>
+<li><a href="#index-program-name-and-its-behavior-33">program name and its
behavior</a>: <a href="#User-Interfaces">User Interfaces</a></li>
+<li><a href="#index-program_0027s-canonical-name-49">program's canonical
name</a>: <a href="#g_t_002d_002dversion">--version</a></li>
<li><a href="#index-programming-languages-10">programming languages</a>: <a
href="#Source-Language">Source Language</a></li>
<li><a href="#index-proprietary-programs-4">proprietary programs</a>: <a
href="#Reading-Non_002dFree-Code">Reading Non-Free Code</a></li>
-<li><a href="#index-quote-characters-94">quote characters</a>: <a
href="#Quote-Characters">Quote Characters</a></li>
-<li><a href="#index-g_t_0040file_007bREADME_007d-file-128"><samp><span
class="file">README</span></samp> file</a>: <a
href="#Releases">Releases</a></li>
-<li><a href="#index-references-to-non_002dfree-material-130">references to
non-free material</a>: <a href="#References">References</a></li>
-<li><a href="#index-releasing-109">releasing</a>: <a
href="#Managing-Releases">Managing Releases</a></li>
-<li><a href="#index-sbindir-122"><code>sbindir</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
-<li><a href="#index-signal-handling-25">signal handling</a>: <a
href="#Semantics">Semantics</a></li>
-<li><a href="#index-spaces-before-open_002dparen-59">spaces before
open-paren</a>: <a href="#Formatting">Formatting</a></li>
-<li><a href="#index-staged-installs-117">staged installs</a>: <a
href="#DESTDIR">DESTDIR</a></li>
-<li><a href="#index-standard-command_002dline-options-42">standard
command-line options</a>: <a href="#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a href="#index-standards-for-makefiles-115">standards for makefiles</a>:
<a href="#Makefile-Conventions">Makefile Conventions</a></li>
-<li><a href="#index-string-library-functions-86">string library functions</a>:
<a href="#System-Functions">System Functions</a></li>
-<li><a href="#index-syntactic-conventions-66">syntactic conventions</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
-<li><a href="#index-table-of-long-options-53">table of long options</a>: <a
href="#Option-Table">Option Table</a></li>
-<li><a href="#index-temporary-files-27">temporary files</a>: <a
href="#Semantics">Semantics</a></li>
-<li><a href="#index-temporary-variables-71">temporary variables</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
-<li><a
href="#index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-129"><samp><span
class="file">texinfo.tex</span></samp>, in a distribution</a>: <a
href="#Releases">Releases</a></li>
-<li><a
href="#index-g_t_0040code_007bTMPDIR_007d-environment-variable-28"><code>TMPDIR</code>
environment variable</a>: <a href="#Semantics">Semantics</a></li>
+<li><a href="#index-quote-characters-95">quote characters</a>: <a
href="#Quote-Characters">Quote Characters</a></li>
+<li><a href="#index-g_t_0040file_007bREADME_007d-file-129"><samp><span
class="file">README</span></samp> file</a>: <a
href="#Releases">Releases</a></li>
+<li><a href="#index-references-to-non_002dfree-material-131">references to
non-free material</a>: <a href="#References">References</a></li>
+<li><a href="#index-releasing-110">releasing</a>: <a
href="#Managing-Releases">Managing Releases</a></li>
+<li><a href="#index-sbindir-123"><code>sbindir</code></a>: <a
href="#Directory-Variables">Directory Variables</a></li>
+<li><a href="#index-signal-handling-26">signal handling</a>: <a
href="#Semantics">Semantics</a></li>
+<li><a href="#index-spaces-before-open_002dparen-60">spaces before
open-paren</a>: <a href="#Formatting">Formatting</a></li>
+<li><a href="#index-staged-installs-118">staged installs</a>: <a
href="#DESTDIR">DESTDIR</a></li>
+<li><a href="#index-standard-command_002dline-options-43">standard
command-line options</a>: <a href="#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a href="#index-standards-for-makefiles-116">standards for makefiles</a>:
<a href="#Makefile-Conventions">Makefile Conventions</a></li>
+<li><a href="#index-string-library-functions-87">string library functions</a>:
<a href="#System-Functions">System Functions</a></li>
+<li><a href="#index-syntactic-conventions-67">syntactic conventions</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a href="#index-table-of-long-options-54">table of long options</a>: <a
href="#Option-Table">Option Table</a></li>
+<li><a href="#index-temporary-files-28">temporary files</a>: <a
href="#Semantics">Semantics</a></li>
+<li><a href="#index-temporary-variables-72">temporary variables</a>: <a
href="#Syntactic-Conventions">Syntactic Conventions</a></li>
+<li><a
href="#index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-130"><samp><span
class="file">texinfo.tex</span></samp>, in a distribution</a>: <a
href="#Releases">Releases</a></li>
+<li><a
href="#index-g_t_0040code_007bTMPDIR_007d-environment-variable-29"><code>TMPDIR</code>
environment variable</a>: <a href="#Semantics">Semantics</a></li>
<li><a href="#index-trademarks-8">trademarks</a>: <a
href="#Trademarks">Trademarks</a></li>
<li><a
href="#index-where-to-obtain-_0040code_007bstandards_002etexi_007d-1">where to
obtain <code>standards.texi</code></a>: <a href="#Preface">Preface</a></li>
</ul><div class="footnote">
Index: standards.html.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.html.gz,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
Binary files /tmp/cvs8jaRj6 and /tmp/cvsYnqv8x differ
Index: standards.html_node.tar.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.html_node.tar.gz,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
Binary files /tmp/cvsVWqix4 and /tmp/cvsgK4eow differ
Index: standards.info.tar.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.info.tar.gz,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
Binary files /tmp/cvsqwwHN7 and /tmp/cvseSWGGz differ
Index: standards.pdf
===================================================================
RCS file: /web/www/www/prep/standards/standards.pdf,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
Binary files /tmp/cvszFu5G6 and /tmp/cvseBKYMy differ
Index: standards.ps.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.ps.gz,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
Binary files /tmp/cvsC4R2fc and /tmp/cvsYTlVrE differ
Index: standards.texi.tar.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.texi.tar.gz,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
Binary files /tmp/cvshLxL1d and /tmp/cvsS3YFgG differ
Index: standards.txt
===================================================================
RCS file: /web/www/www/prep/standards/standards.txt,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
--- standards.txt 25 Apr 2008 18:41:37 -0000 1.27
+++ standards.txt 5 May 2008 17:24:22 -0000 1.28
@@ -73,7 +73,7 @@
Version
*******
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -97,8 +97,8 @@
even if you write in another programming language. The rules often
state reasons for writing in a certain way.
- This release of the GNU Coding Standards was last updated February
-23, 2008.
+ This release of the GNU Coding Standards was last updated May 5,
+2008.
If you did not obtain this file directly from the GNU project and
recently, please check for a newer version. You can get the GNU Coding
@@ -284,12 +284,13 @@
the program is written in that language, too. The Emacs editor
pioneered this technique.
- The standard extensibility interpreter for GNU software is GUILE
+ The standard extensibility interpreter for GNU software is Guile
(`http://www.gnu.org/software/guile/'), which implements the language
-Scheme (an especially clean and simple dialect of Lisp). We don't
-reject programs written in other "scripting languages" such as Perl and
-Python, but using GUILE is very important for the overall consistency
-of the GNU system.
+Scheme (an especially clean and simple dialect of Lisp). Guile also
+includes bindings for GTK+/GNOME, making it practical to write modern
+GUI functionality within Guile. We don't reject programs written in
+other "scripting languages" such as Perl and Python, but using Guile is
+very important for the overall consistency of the GNU system.
3.2 Compatibility with Other Implementations
============================================
@@ -884,6 +885,7 @@
means the GNU GPL version 3 or later, with the extra exception for
Guile.
+GPL/Ada
GNU GPL with the exception for Ada.
Apache
@@ -5111,135 +5113,136 @@
Index
*****
-#endif, commenting: See 5.2. (line 2253)
---help output: See 4.7.2. (line 935)
---version output: See 4.7.1. (line 786)
--Wall compiler option: See 5.3. (line 2286)
+#endif, commenting: See 5.2. (line 2255)
+--help output: See 4.7.2. (line 937)
+--version output: See 4.7.1. (line 787)
+-Wall compiler option: See 5.3. (line 2288)
accepting contributions: See 2.2. (line 174)
-address for bug reports: See 4.7.2. (line 940)
-ANSI C standard: See 3.4. (line 362)
-arbitrary limits on data: See 4.2. (line 517)
-ASCII characters: See 5.9. (line 2796)
-autoconf: See 5.5. (line 2455)
+address for bug reports: See 4.7.2. (line 942)
+ANSI C standard: See 3.4. (line 363)
+arbitrary limits on data: See 4.2. (line 518)
+ASCII characters: See 5.9. (line 2798)
+autoconf: See 5.5. (line 2457)
avoiding proprietary code: See 2.1. (line 140)
-behavior, dependent on program's name: See 4.5. (line 702)
-binary packages: See 7.2.7. (line 4476)
-bindir: See 7.2.5. (line 3824)
-braces, in C source: See 5.1. (line 2079)
-bug reports: See 4.7.2. (line 940)
-canonical name of a program: See 4.7.1. (line 792)
-casting pointers to integers: See 5.6. (line 2577)
-CGI programs, standard options for: See 4.7. (line 777)
-change logs: See 6.8. (line 3082)
-change logs, conditional changes: See 6.8.4. (line 3226)
-change logs, style: See 6.8.2. (line 3133)
-character set: See 5.9. (line 2796)
-command-line arguments, decoding: See 4.2. (line 557)
-command-line interface: See 4.7. (line 752)
-commenting: See 5.2. (line 2199)
-compatibility with C and POSIX standards: See 3.2. (line 297)
-compiler warnings: See 5.3. (line 2286)
-conditional changes, and change logs: See 6.8.4. (line 3226)
-conditionals, comments for: See 5.2. (line 2253)
-configure: See 7.1. (line 3344)
-control-L: See 5.1. (line 2191)
-conventions for makefiles: See 7.2. (line 3517)
-corba: See 4.6. (line 743)
-credits for manuals: See 6.5. (line 3047)
-data types, and portability: See 5.6. (line 2494)
-declaration for system functions: See 5.7. (line 2604)
-DESTDIR: See 7.2.4. (line 3730)
-documentation: See 6. (line 2858)
-doschk: See 5.4. (line 2424)
+behavior, dependent on program's name: See 4.5. (line 703)
+binary packages: See 7.2.7. (line 4478)
+bindir: See 7.2.5. (line 3826)
+braces, in C source: See 5.1. (line 2081)
+bug reports: See 4.7.2. (line 942)
+canonical name of a program: See 4.7.1. (line 793)
+casting pointers to integers: See 5.6. (line 2579)
+CGI programs, standard options for: See 4.7. (line 778)
+change logs: See 6.8. (line 3084)
+change logs, conditional changes: See 6.8.4. (line 3228)
+change logs, style: See 6.8.2. (line 3135)
+character set: See 5.9. (line 2798)
+command-line arguments, decoding: See 4.2. (line 558)
+command-line interface: See 4.7. (line 753)
+commenting: See 5.2. (line 2201)
+compatibility with C and POSIX standards: See 3.2. (line 298)
+compiler warnings: See 5.3. (line 2288)
+conditional changes, and change logs: See 6.8.4. (line 3228)
+conditionals, comments for: See 5.2. (line 2255)
+configure: See 7.1. (line 3346)
+control-L: See 5.1. (line 2193)
+conventions for makefiles: See 7.2. (line 3519)
+corba: See 4.6. (line 744)
+credits for manuals: See 6.5. (line 3049)
+data types, and portability: See 5.6. (line 2496)
+declaration for system functions: See 5.7. (line 2606)
+DESTDIR: See 7.2.4. (line 3732)
+documentation: See 6. (line 2860)
+doschk: See 5.4. (line 2426)
downloading this manual: See 1. (line 103)
-encodings: See 5.9. (line 2796)
-error messages: See 4.2. (line 530)
-error messages, formatting: See 4.4. (line 640)
-exec_prefix: See 7.2.5. (line 3806)
-expressions, splitting: See 5.1. (line 2154)
+encodings: See 5.9. (line 2798)
+error messages: See 4.2. (line 531)
+error messages, formatting: See 4.4. (line 641)
+exec_prefix: See 7.2.5. (line 3808)
+expressions, splitting: See 5.1. (line 2156)
FDL, GNU Free Documentation License: See Appendix A.
- (line 4685)
-file usage: See 4.10. (line 2057)
-file-name limitations: See 5.4. (line 2424)
-formatting error messages: See 4.4. (line 640)
-formatting source code: See 5.1. (line 2079)
-formfeed: See 5.1. (line 2191)
-function argument, declaring: See 5.3. (line 2282)
-function prototypes: See 3.4. (line 373)
-getopt: See 4.7. (line 752)
-gettext: See 5.8. (line 2701)
-gnome: See 4.6. (line 743)
-graphical user interface: See 4.6. (line 733)
-grave accent: See 5.10. (line 2811)
-gtk+: See 4.6. (line 733)
-GUILE: See 3.1. (line 287)
-implicit int: See 5.3. (line 2282)
-impossible conditions: See 4.2. (line 581)
-installations, staged: See 7.2.4. (line 3730)
-internationalization: See 5.8. (line 2701)
-left quote: See 5.10. (line 2811)
+ (line 4687)
+file usage: See 4.10. (line 2059)
+file-name limitations: See 5.4. (line 2426)
+formatting error messages: See 4.4. (line 641)
+formatting source code: See 5.1. (line 2081)
+formfeed: See 5.1. (line 2193)
+function argument, declaring: See 5.3. (line 2284)
+function prototypes: See 3.4. (line 374)
+getopt: See 4.7. (line 753)
+gettext: See 5.8. (line 2703)
+gnome: See 4.6. (line 744)
+GNOME and Guile: See 3.1. (line 287)
+graphical user interface: See 4.6. (line 734)
+grave accent: See 5.10. (line 2813)
+gtk+: See 4.6. (line 734)
+Guile: See 3.1. (line 287)
+implicit int: See 5.3. (line 2284)
+impossible conditions: See 4.2. (line 582)
+installations, staged: See 7.2.4. (line 3732)
+internationalization: See 5.8. (line 2703)
+left quote: See 5.10. (line 2813)
legal aspects: See 2. (line 134)
legal papers: See 2.2. (line 174)
-libexecdir: See 7.2.5. (line 3837)
-libraries: See 4.3. (line 612)
-library functions, and portability: See 5.7. (line 2589)
-license for manuals: See 6.4. (line 3028)
-lint: See 5.3. (line 2385)
-locale-specific quote characters: See 5.10. (line 2811)
-long option names: See 4.8. (line 948)
-long-named options: See 4.7. (line 758)
-makefile, conventions for: See 7.2. (line 3517)
-malloc return value: See 4.2. (line 536)
-man pages: See 6.9. (line 3270)
-manual structure: See 6.3. (line 3001)
-memory allocation failure: See 4.2. (line 536)
-memory usage: See 4.9. (line 2037)
-message text, and internationalization: See 5.8. (line 2724)
-mmap: See 5.11. (line 2842)
-multiple variables in a line: See 5.3. (line 2311)
-names of variables, functions, and files: See 5.4. (line 2392)
-NEWS file: See 6.7. (line 3068)
-non-ASCII characters: See 5.9. (line 2796)
-non-POSIX systems, and portability: See 5.5. (line 2464)
-non-standard extensions: See 3.3. (line 329)
-NUL characters: See 4.2. (line 522)
-open brace: See 5.1. (line 2079)
-optional features, configure-time: See 7.1. (line 3430)
-options for compatibility: See 3.2. (line 305)
-options, standard command-line: See 4.7. (line 777)
-output device and program's behavior: See 4.5. (line 709)
-packaging: See 7.3. (line 4503)
-PATH_INFO, specifying standard options as: See 4.7. (line 777)
-portability, and data types: See 5.6. (line 2494)
-portability, and library functions: See 5.7. (line 2589)
-portability, between system types: See 5.5. (line 2438)
-POSIX compatibility: See 3.2. (line 297)
-POSIXLY_CORRECT, environment variable: See 3.2. (line 312)
-post-installation commands: See 7.2.7. (line 4402)
-pre-installation commands: See 7.2.7. (line 4402)
-prefix: See 7.2.5. (line 3796)
-program configuration: See 7.1. (line 3344)
+libexecdir: See 7.2.5. (line 3839)
+libraries: See 4.3. (line 613)
+library functions, and portability: See 5.7. (line 2591)
+license for manuals: See 6.4. (line 3030)
+lint: See 5.3. (line 2387)
+locale-specific quote characters: See 5.10. (line 2813)
+long option names: See 4.8. (line 950)
+long-named options: See 4.7. (line 759)
+makefile, conventions for: See 7.2. (line 3519)
+malloc return value: See 4.2. (line 537)
+man pages: See 6.9. (line 3272)
+manual structure: See 6.3. (line 3003)
+memory allocation failure: See 4.2. (line 537)
+memory usage: See 4.9. (line 2039)
+message text, and internationalization: See 5.8. (line 2726)
+mmap: See 5.11. (line 2844)
+multiple variables in a line: See 5.3. (line 2313)
+names of variables, functions, and files: See 5.4. (line 2394)
+NEWS file: See 6.7. (line 3070)
+non-ASCII characters: See 5.9. (line 2798)
+non-POSIX systems, and portability: See 5.5. (line 2466)
+non-standard extensions: See 3.3. (line 330)
+NUL characters: See 4.2. (line 523)
+open brace: See 5.1. (line 2081)
+optional features, configure-time: See 7.1. (line 3432)
+options for compatibility: See 3.2. (line 306)
+options, standard command-line: See 4.7. (line 778)
+output device and program's behavior: See 4.5. (line 710)
+packaging: See 7.3. (line 4505)
+PATH_INFO, specifying standard options as: See 4.7. (line 778)
+portability, and data types: See 5.6. (line 2496)
+portability, and library functions: See 5.7. (line 2591)
+portability, between system types: See 5.5. (line 2440)
+POSIX compatibility: See 3.2. (line 298)
+POSIXLY_CORRECT, environment variable: See 3.2. (line 313)
+post-installation commands: See 7.2.7. (line 4404)
+pre-installation commands: See 7.2.7. (line 4404)
+prefix: See 7.2.5. (line 3798)
+program configuration: See 7.1. (line 3346)
program design: See 3. (line 249)
-program name and its behavior: See 4.5. (line 702)
-program's canonical name: See 4.7.1. (line 792)
+program name and its behavior: See 4.5. (line 703)
+program's canonical name: See 4.7.1. (line 793)
programming languages: See 3.1. (line 255)
proprietary programs: See 2.1. (line 140)
-quote characters: See 5.10. (line 2811)
-README file: See 7.3. (line 4518)
-references to non-free material: See 8. (line 4579)
-releasing: See 7. (line 3333)
-sbindir: See 7.2.5. (line 3830)
-signal handling: See 4.2. (line 570)
-spaces before open-paren: See 5.1. (line 2148)
-staged installs: See 7.2.4. (line 3730)
-standard command-line options: See 4.7. (line 777)
-standards for makefiles: See 7.2. (line 3517)
-string library functions: See 5.7. (line 2638)
-syntactic conventions: See 5.3. (line 2282)
-table of long options: See 4.8. (line 948)
-temporary files: See 4.2. (line 595)
-temporary variables: See 5.3. (line 2299)
-texinfo.tex, in a distribution: See 7.3. (line 4567)
-TMPDIR environment variable: See 4.2. (line 595)
+quote characters: See 5.10. (line 2813)
+README file: See 7.3. (line 4520)
+references to non-free material: See 8. (line 4581)
+releasing: See 7. (line 3335)
+sbindir: See 7.2.5. (line 3832)
+signal handling: See 4.2. (line 571)
+spaces before open-paren: See 5.1. (line 2150)
+staged installs: See 7.2.4. (line 3732)
+standard command-line options: See 4.7. (line 778)
+standards for makefiles: See 7.2. (line 3519)
+string library functions: See 5.7. (line 2640)
+syntactic conventions: See 5.3. (line 2284)
+table of long options: See 4.8. (line 950)
+temporary files: See 4.2. (line 596)
+temporary variables: See 5.3. (line 2301)
+texinfo.tex, in a distribution: See 7.3. (line 4569)
+TMPDIR environment variable: See 4.2. (line 596)
trademarks: See 2.3. (line 219)
where to obtain standards.texi: See 1. (line 103)
Index: standards.txt.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.txt.gz,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
Binary files /tmp/cvsxZRcjk and /tmp/cvsMmkNHM differ
Index: html_node/CPU-Portability.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/CPU-Portability.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/CPU-Portability.html 25 Apr 2008 18:41:44 -0000 1.25
+++ html_node/CPU-Portability.html 5 May 2008 17:25:43 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="System-Functions.html#System-Functions" title="System
Functions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.6 Portability between <span class="sc">cpu</span>s</h3>
-<p><a name="index-data-types_002c-and-portability-80"></a><a
name="index-portability_002c-and-data-types-81"></a>Even GNU systems will
differ because of differences among <span class="sc">cpu</span>
+<p><a name="index-data-types_002c-and-portability-81"></a><a
name="index-portability_002c-and-data-types-82"></a>Even GNU systems will
differ because of differences among <span class="sc">cpu</span>
types—for example, difference in byte ordering and alignment
requirements. It is absolutely essential to handle these differences.
However, don't make any effort to cater to the possibility that an
@@ -133,7 +133,7 @@
return fp;
}
</pre>
- <p><a name="index-casting-pointers-to-integers-82"></a>Avoid casting
pointers to integers if you can. Such casts greatly
+ <p><a name="index-casting-pointers-to-integers-83"></a>Avoid casting
pointers to integers if you can. Such casts greatly
reduce portability, and in most programs they are easy to avoid. In the
cases where casting pointers to integers is essential—such as, a Lisp
interpreter which stores type information as well as an address in one
Index: html_node/Change-Log-Concepts.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Change-Log-Concepts.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Change-Log-Concepts.html 25 Apr 2008 18:41:45 -0000 1.25
+++ html_node/Change-Log-Concepts.html 5 May 2008 17:25:44 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Style-of-Change-Logs.html#Style-of-Change-Logs"
title="Style of Change Logs">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Change-Logs.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Change-Logs.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Change-Logs.html 25 Apr 2008 18:41:45 -0000 1.25
+++ html_node/Change-Logs.html 5 May 2008 17:25:44 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Man-Pages.html#Man-Pages" title="Man Pages">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">6.8 Change Logs</h3>
-<p><a name="index-change-logs-104"></a>
+<p><a name="index-change-logs-105"></a>
Keep a change log to describe all the changes made to program source
files. The purpose of this is so that people investigating bugs in the
future will know about the changes that might have introduced the bug.
Index: html_node/Character-Set.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Character-Set.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- html_node/Character-Set.html 25 Apr 2008 18:41:45 -0000 1.17
+++ html_node/Character-Set.html 5 May 2008 17:25:44 -0000 1.18
@@ -10,7 +10,7 @@
<link rel="next" href="Quote-Characters.html#Quote-Characters" title="Quote
Characters">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.9 Character Set</h3>
-<p><a name="index-character-set-90"></a><a name="index-encodings-91"></a><a
name="index-ASCII-characters-92"></a><a
name="index-non_002dASCII-characters-93"></a>
+<p><a name="index-character-set-91"></a><a name="index-encodings-92"></a><a
name="index-ASCII-characters-93"></a><a
name="index-non_002dASCII-characters-94"></a>
Sticking to the ASCII character set (plain text, 7-bit characters) is
preferred in GNU source code comments, text documents, and other
contexts, unless there is good reason to do something else because of
Index: html_node/Command-Variables.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Command-Variables.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Command-Variables.html 25 Apr 2008 18:41:45 -0000 1.25
+++ html_node/Command-Variables.html 5 May 2008 17:25:44 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="DESTDIR.html#DESTDIR" title="DESTDIR">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Command_002dLine-Interfaces.html
===================================================================
RCS file:
/web/www/www/prep/standards/html_node/Command_002dLine-Interfaces.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Command_002dLine-Interfaces.html 25 Apr 2008 18:41:45 -0000
1.25
+++ html_node/Command_002dLine-Interfaces.html 5 May 2008 17:25:44 -0000
1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Option-Table.html#Option-Table" title="Option Table">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -49,15 +49,15 @@
<h3 class="section">4.7 Standards for Command Line Interfaces</h3>
-<p><a name="index-command_002dline-interface-39"></a>
-<a name="index-getopt-40"></a>It is a good idea to follow the <span
class="sc">posix</span> guidelines for the
+<p><a name="index-command_002dline-interface-40"></a>
+<a name="index-getopt-41"></a>It is a good idea to follow the <span
class="sc">posix</span> guidelines for the
command-line options of a program. The easiest way to do this is to use
<code>getopt</code> to parse them. Note that the GNU version of
<code>getopt</code>
will normally permit options anywhere among the arguments unless the
special argument ‘<samp><span class="samp">--</span></samp>’ is
used. This is not what <span class="sc">posix</span>
specifies; it is a GNU extension.
- <p><a name="index-long_002dnamed-options-41"></a>Please define long-named
options that are equivalent to the
+ <p><a name="index-long_002dnamed-options-42"></a>Please define long-named
options that are equivalent to the
single-letter Unix-style options. We hope to make GNU more user
friendly this way. This is easy to do with the GNU function
<code>getopt_long</code>.
@@ -76,7 +76,7 @@
option as another way to specify it. This will lead to more consistency
among GNU utilities, and fewer idiosyncrasies for users to remember.
- <p><a name="index-standard-command_002dline-options-42"></a><a
name="index-options_002c-standard-command_002dline-43"></a><a
name="index-CGI-programs_002c-standard-options-for-44"></a><a
name="index-PATH_005fINFO_002c-specifying-standard-options-as-45"></a>All
programs should support two standard options: ‘<samp><span
class="samp">--version</span></samp>’
+ <p><a name="index-standard-command_002dline-options-43"></a><a
name="index-options_002c-standard-command_002dline-44"></a><a
name="index-CGI-programs_002c-standard-options-for-45"></a><a
name="index-PATH_005fINFO_002c-specifying-standard-options-as-46"></a>All
programs should support two standard options: ‘<samp><span
class="samp">--version</span></samp>’
and ‘<samp><span class="samp">--help</span></samp>’. CGI programs
should accept these as command-line
options, and also if given as the <samp><span
class="env">PATH_INFO</span></samp>; for instance,
visiting <a
href="http://example.org/p.cgi/--help">http://example.org/p.cgi/–help</a>
in a browser should
Index: html_node/Comments.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Comments.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Comments.html 25 Apr 2008 18:41:45 -0000 1.25
+++ html_node/Comments.html 5 May 2008 17:25:44 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Syntactic-Conventions.html#Syntactic-Conventions"
title="Syntactic Conventions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.2 Commenting Your Work</h3>
-<p><a name="index-commenting-63"></a>
+<p><a name="index-commenting-64"></a>
Every program should start with a comment saying briefly what it is for.
Example: ‘<samp><span class="samp">fmt - filter for simple filling of
text</span></samp>’. This comment
should be at the top of the source file containing the ‘<samp><span
class="samp">main</span></samp>’
@@ -103,7 +103,7 @@
zero means continue them. */
int truncate_lines;
</pre>
- <p><a name="index-conditionals_002c-comments-for-64"></a><a
name="index-g_t_0040code_007b_0023endif_007d_002c-commenting-65"></a>Every
‘<samp><span class="samp">#endif</span></samp>’ should have a
comment, except in the case of short
+ <p><a name="index-conditionals_002c-comments-for-65"></a><a
name="index-g_t_0040code_007b_0023endif_007d_002c-commenting-66"></a>Every
‘<samp><span class="samp">#endif</span></samp>’ should have a
comment, except in the case of short
conditionals (just a few lines) that are not nested. The comment should
state the condition of the conditional that is ending, <em>including
its sense</em>. ‘<samp><span class="samp">#else</span></samp>’
should have a comment describing the condition
Index: html_node/Compatibility.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Compatibility.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Compatibility.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Compatibility.html 5 May 2008 17:25:44 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Using-Extensions.html#Using-Extensions" title="Using
Extensions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">3.2 Compatibility with Other Implementations</h3>
-<p><a
name="index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-12"></a><a
name="index-g_t_0040sc_007bposix_007d-compatibility-13"></a>
+<p><a
name="index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-13"></a><a
name="index-g_t_0040sc_007bposix_007d-compatibility-14"></a>
With occasional exceptions, utility programs and libraries for GNU
should be upward compatible with those in Berkeley Unix, and upward
compatible with Standard C if Standard C specifies their
@@ -58,14 +58,14 @@
<p>When these standards conflict, it is useful to offer compatibility
modes for each of them.
- <p><a name="index-options-for-compatibility-14"></a>Standard C and <span
class="sc">posix</span> prohibit many kinds of extensions. Feel
+ <p><a name="index-options-for-compatibility-15"></a>Standard C and <span
class="sc">posix</span> prohibit many kinds of extensions. Feel
free to make the extensions anyway, and include a ‘<samp><span
class="samp">--ansi</span></samp>’,
‘<samp><span class="samp">--posix</span></samp>’, or
‘<samp><span class="samp">--compatible</span></samp>’ option to
turn them off.
However, if the extension has a significant chance of breaking any real
programs or scripts, then it is not really upward compatible. So you
should try to redesign its interface to make it upward compatible.
- <p><a
name="index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-15"></a>Many
GNU programs suppress extensions that conflict with <span
class="sc">posix</span> if the
+ <p><a
name="index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-16"></a>Many
GNU programs suppress extensions that conflict with <span
class="sc">posix</span> if the
environment variable <code>POSIXLY_CORRECT</code> is defined (even if it is
defined with a null value). Please make your program recognize this
variable if appropriate.
Index: html_node/Conditional-Changes.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Conditional-Changes.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Conditional-Changes.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Conditional-Changes.html 5 May 2008 17:25:45 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next"
href="Indicating-the-Part-Changed.html#Indicating-the-Part-Changed"
title="Indicating the Part Changed">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h4 class="subsection">6.8.4 Conditional Changes</h4>
-<p><a name="index-conditional-changes_002c-and-change-logs-106"></a><a
name="index-change-logs_002c-conditional-changes-107"></a>
+<p><a name="index-conditional-changes_002c-and-change-logs-107"></a><a
name="index-change-logs_002c-conditional-changes-108"></a>
C programs often contain compile-time <code>#if</code> conditionals. Many
changes are conditional; sometimes you add a new definition which is
entirely contained in a conditional. It is very useful to indicate in
Index: html_node/Conditional-Compilation.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Conditional-Compilation.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Conditional-Compilation.html 25 Apr 2008 18:41:46 -0000
1.25
+++ html_node/Conditional-Compilation.html 5 May 2008 17:25:45 -0000
1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Standard-C.html#Standard-C" title="Standard C">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Configuration.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Configuration.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Configuration.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Configuration.html 5 May 2008 17:25:45 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,8 +46,8 @@
<h3 class="section">7.1 How Configuration Should Work</h3>
-<p><a name="index-program-configuration-110"></a>
-<a name="index-configure-111"></a>Each GNU distribution should come with a
shell script named
+<p><a name="index-program-configuration-111"></a>
+<a name="index-configure-112"></a>Each GNU distribution should come with a
shell script named
<code>configure</code>. This script is given arguments which describe the
kind of machine and system you want to compile the program for.
@@ -134,7 +134,7 @@
the shell script
<a
href="http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD"><samp><span
class="file">config.guess</span></samp></a>.
- <p><a name="index-optional-features_002c-configure_002dtime-112"></a>Other
options are permitted to specify in more detail the software
+ <p><a name="index-optional-features_002c-configure_002dtime-113"></a>Other
options are permitted to specify in more detail the software
or hardware present on the machine, to include or exclude optional parts
of the package, or to adjust the name of some tools or arguments to them:
Index: html_node/Contributions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Contributions.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Contributions.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Contributions.html 5 May 2008 17:25:45 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Trademarks.html#Trademarks" title="Trademarks">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/DESTDIR.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/DESTDIR.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- html_node/DESTDIR.html 25 Apr 2008 18:41:46 -0000 1.14
+++ html_node/DESTDIR.html 5 May 2008 17:25:45 -0000 1.15
@@ -10,7 +10,7 @@
<link rel="next" href="Directory-Variables.html#Directory-Variables"
title="Directory Variables">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h4 class="subsection">7.2.4 <code>DESTDIR</code>: support for staged
installs</h4>
-<p><a name="index-DESTDIR-116"></a><a name="index-staged-installs-117"></a><a
name="index-installations_002c-staged-118"></a>
+<p><a name="index-DESTDIR-117"></a><a name="index-staged-installs-118"></a><a
name="index-installations_002c-staged-119"></a>
<code>DESTDIR</code> is a variable prepended to each installed target file,
like this:
Index: html_node/Design-Advice.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Design-Advice.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Design-Advice.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Design-Advice.html 5 May 2008 17:25:45 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Directory-Variables.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Directory-Variables.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- html_node/Directory-Variables.html 25 Apr 2008 18:41:46 -0000 1.26
+++ html_node/Directory-Variables.html 5 May 2008 17:25:45 -0000 1.27
@@ -10,7 +10,7 @@
<link rel="next" href="Standard-Targets.html#Standard-Targets" title="Standard
Targets">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -69,7 +69,7 @@
directories.
<dl>
-<dt><code>prefix</code><dd><a name="index-prefix-119"></a>A prefix used in
constructing the default values of the variables listed
+<dt><code>prefix</code><dd><a name="index-prefix-120"></a>A prefix used in
constructing the default values of the variables listed
below. The default value of <code>prefix</code> should be <samp><span
class="file">/usr/local</span></samp>.
When building the complete GNU system, the prefix will be empty and
<samp><span class="file">/usr</span></samp> will be a symbolic link to
<samp><span class="file">/</span></samp>.
@@ -79,7 +79,7 @@
the one used to build the program should <em>not</em> recompile the
program.
- <br><dt><code>exec_prefix</code><dd><a
name="index-exec_005fprefix-120"></a>A prefix used in constructing the default
values of some of the
+ <br><dt><code>exec_prefix</code><dd><a
name="index-exec_005fprefix-121"></a>A prefix used in constructing the default
values of some of the
variables listed below. The default value of <code>exec_prefix</code> should
be <code>$(prefix)</code>.
(If you are using Autoconf, write it as ‘<samp><span
class="samp">@exec_prefix@</span></samp>’.)
@@ -96,18 +96,18 @@
<p>Executable programs are installed in one of the following directories.
<dl>
-<dt><code>bindir</code><dd><a name="index-bindir-121"></a>The directory for
installing executable programs that users can run.
+<dt><code>bindir</code><dd><a name="index-bindir-122"></a>The directory for
installing executable programs that users can run.
This should normally be <samp><span class="file">/usr/local/bin</span></samp>,
but write it as
<samp><span class="file">$(exec_prefix)/bin</span></samp>.
(If you are using Autoconf, write it as ‘<samp><span
class="samp">@bindir@</span></samp>’.)
- <br><dt><code>sbindir</code><dd><a name="index-sbindir-122"></a>The
directory for installing executable programs that can be run from
+ <br><dt><code>sbindir</code><dd><a name="index-sbindir-123"></a>The
directory for installing executable programs that can be run from
the shell, but are only generally useful to system administrators. This
should normally be <samp><span class="file">/usr/local/sbin</span></samp>, but
write it as
<samp><span class="file">$(exec_prefix)/sbin</span></samp>.
(If you are using Autoconf, write it as ‘<samp><span
class="samp">@sbindir@</span></samp>’.)
- <br><dt><code>libexecdir</code><dd><a
name="index-libexecdir-123"></a><!-- This paragraph adjusted to avoid overfull
hbox -roland 5jul94 -->
+ <br><dt><code>libexecdir</code><dd><a
name="index-libexecdir-124"></a><!-- This paragraph adjusted to avoid overfull
hbox -roland 5jul94 -->
The directory for installing executable programs to be run by other
programs rather than by users. This directory should normally be
<samp><span class="file">/usr/local/libexec</span></samp>, but write it as
<samp><span class="file">$(exec_prefix)/libexec</span></samp>.
Index: html_node/Doc-Strings-and-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Doc-Strings-and-Manuals.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Doc-Strings-and-Manuals.html 25 Apr 2008 18:41:46 -0000
1.25
+++ html_node/Doc-Strings-and-Manuals.html 5 May 2008 17:25:46 -0000
1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Manual-Structure-Details.html#Manual-Structure-Details"
title="Manual Structure Details">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Documentation.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Documentation.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Documentation.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Documentation.html 5 May 2008 17:25:46 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Managing-Releases.html#Managing-Releases"
title="Managing Releases">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -47,7 +47,7 @@
<h2 class="chapter">6 Documenting Programs</h2>
-<p><a name="index-documentation-99"></a>
+<p><a name="index-documentation-100"></a>
A GNU program should ideally come with full free documentation, adequate
for both reference and tutorial purposes. If the package can be
programmed or extended, the documentation should cover programming or
Index: html_node/Errors.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Errors.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Errors.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Errors.html 5 May 2008 17:25:46 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="User-Interfaces.html#User-Interfaces" title="User
Interfaces">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">4.4 Formatting Error Messages</h3>
-<p><a name="index-formatting-error-messages-30"></a><a
name="index-error-messages_002c-formatting-31"></a>
+<p><a name="index-formatting-error-messages-31"></a><a
name="index-error-messages_002c-formatting-32"></a>
Error messages from compilers should look like this:
<pre class="example"> <var>source-file-name</var>:<var>lineno</var>:
<var>message</var>
Index: html_node/File-Usage.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/File-Usage.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/File-Usage.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/File-Usage.html 5 May 2008 17:25:46 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Memory-Usage.html#Memory-Usage" title="Memory Usage">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,7 +46,7 @@
<h3 class="section">4.10 File Usage</h3>
-<p><a name="index-file-usage-55"></a>
+<p><a name="index-file-usage-56"></a>
Programs should be prepared to operate when <samp><span
class="file">/usr</span></samp> and <samp><span class="file">/etc</span></samp>
are read-only file systems. Thus, if the program manages log files,
lock files, backup files, score files, or any other files which are
Index: html_node/Formatting.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Formatting.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Formatting.html 25 Apr 2008 18:41:46 -0000 1.25
+++ html_node/Formatting.html 5 May 2008 17:25:46 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Comments.html#Comments" title="Comments">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,8 +46,8 @@
<h3 class="section">5.1 Formatting Your Source Code</h3>
-<p><a name="index-formatting-source-code-56"></a>
-<a name="index-open-brace-57"></a><a
name="index-braces_002c-in-C-source-58"></a>It is important to put the
open-brace that starts the body of a C
+<p><a name="index-formatting-source-code-57"></a>
+<a name="index-open-brace-58"></a><a
name="index-braces_002c-in-C-source-59"></a>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
functions. These tools will not work on code not formatted that way.
@@ -116,13 +116,13 @@
return ++x + bar ();
}
</pre>
- <p><a name="index-spaces-before-open_002dparen-59"></a>We find it easier to
read a program when it has spaces before the
+ <p><a name="index-spaces-before-open_002dparen-60"></a>We find it easier to
read a program when it has spaces before the
open-parentheses and after the commas. Especially after the commas.
<p>When you split an expression into multiple lines, split it
before an operator, not after one. Here is the right way:
- <p><a name="index-expressions_002c-splitting-60"></a>
+ <p><a name="index-expressions_002c-splitting-61"></a>
<pre class="example"> if (foo_this_is_long && bar > win (x, y,
z)
&& remaining_condition)
</pre>
@@ -159,7 +159,7 @@
}
while (a > 0);
</pre>
- <p><a name="index-formfeed-61"></a><a
name="index-control_002dL-62"></a>Please use formfeed characters (control-L) to
divide the program into
+ <p><a name="index-formfeed-62"></a><a
name="index-control_002dL-63"></a>Please use formfeed characters (control-L) to
divide the program into
pages at logical places (but not within a function). It does not matter
just how long the pages are, since they do not have to fit on a printed
page. The formfeeds should appear alone on lines by themselves.
Index: html_node/GNU-Free-Documentation-License.html
===================================================================
RCS file:
/web/www/www/prep/standards/html_node/GNU-Free-Documentation-License.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- html_node/GNU-Free-Documentation-License.html 25 Apr 2008 18:41:47
-0000 1.26
+++ html_node/GNU-Free-Documentation-License.html 5 May 2008 17:25:46
-0000 1.27
@@ -9,7 +9,7 @@
<link rel="next" href="Index.html#Index" title="Index">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -47,7 +47,7 @@
<h2 class="appendix">Appendix A GNU Free Documentation License</h2>
-<p><a name="index-FDL_002c-GNU-Free-Documentation-License-131"></a>
+<p><a name="index-FDL_002c-GNU-Free-Documentation-License-132"></a>
<!-- The GNU Free Documentation License. -->
<div align="center">Version 1.2, November 2002</div>
Index: html_node/GNU-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/GNU-Manuals.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- html_node/GNU-Manuals.html 25 Apr 2008 18:41:47 -0000 1.26
+++ html_node/GNU-Manuals.html 5 May 2008 17:25:46 -0000 1.27
@@ -9,7 +9,7 @@
<link rel="next" href="Doc-Strings-and-Manuals.html#Doc-Strings-and-Manuals"
title="Doc Strings and Manuals">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Graphical-Interfaces.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Graphical-Interfaces.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Graphical-Interfaces.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Graphical-Interfaces.html 5 May 2008 17:25:46 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next"
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces"
title="Command-Line Interfaces">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,8 +48,8 @@
<h3 class="section">4.6 Standards for Graphical Interfaces</h3>
-<p><a name="index-graphical-user-interface-35"></a>
-<a name="index-gtk_002b-36"></a>When you write a program that provides a
graphical user interface,
+<p><a name="index-graphical-user-interface-36"></a>
+<a name="index-gtk_002b-37"></a>When you write a program that provides a
graphical user interface,
please make it work with X Windows and the GTK+ toolkit unless the
functionality specifically requires some alternative (for example,
“displaying jpeg images while in console mode”).
@@ -59,7 +59,7 @@
separate program which invokes the command-line program.) This is
so that the same jobs can be done from scripts.
- <p><a name="index-corba-37"></a><a name="index-gnome-38"></a>Please also
consider providing a CORBA interface (for use from GNOME), a
+ <p><a name="index-corba-38"></a><a name="index-gnome-39"></a>Please also
consider providing a CORBA interface (for use from GNOME), a
library interface (for use from C), and perhaps a keyboard-driven
console interface (for use by users from console mode). Once you are
doing the work to provide the functionality and the graphical interface,
Index: html_node/Index.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Index.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Index.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Index.html 5 May 2008 17:25:47 -0000 1.26
@@ -8,7 +8,7 @@
<link rel="prev"
href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License"
title="GNU Free Documentation License">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,135 +46,136 @@
<h2 class="unnumbered">Index</h2>
<ul class="index-cp" compact>
-<li><a
href="Comments.html#index-g_t_0040code_007b_0023endif_007d_002c-commenting-65"><code>#endif</code>,
commenting</a>: <a href="Comments.html#Comments">Comments</a></li>
-<li><a
href="_002d_002dhelp.html#index-g_t_0040samp_007b_002d_002dhelp_007d-output-49">‘<samp><span
class="samp">--help</span></samp>’ output</a>: <a
href="_002d_002dhelp.html#g_t_002d_002dhelp">--help</a></li>
-<li><a
href="_002d_002dversion.html#index-g_t_0040samp_007b_002d_002dversion_007d-output-46">‘<samp><span
class="samp">--version</span></samp>’ output</a>: <a
href="_002d_002dversion.html#g_t_002d_002dversion">--version</a></li>
-<li><a
href="Syntactic-Conventions.html#index-g_t_0040samp_007b_002dWall_007d-compiler-option-70">‘<samp><span
class="samp">-Wall</span></samp>’ compiler option</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a
href="Comments.html#index-g_t_0040code_007b_0023endif_007d_002c-commenting-66"><code>#endif</code>,
commenting</a>: <a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="_002d_002dhelp.html#index-g_t_0040samp_007b_002d_002dhelp_007d-output-50">‘<samp><span
class="samp">--help</span></samp>’ output</a>: <a
href="_002d_002dhelp.html#g_t_002d_002dhelp">--help</a></li>
+<li><a
href="_002d_002dversion.html#index-g_t_0040samp_007b_002d_002dversion_007d-output-47">‘<samp><span
class="samp">--version</span></samp>’ output</a>: <a
href="_002d_002dversion.html#g_t_002d_002dversion">--version</a></li>
+<li><a
href="Syntactic-Conventions.html#index-g_t_0040samp_007b_002dWall_007d-compiler-option-71">‘<samp><span
class="samp">-Wall</span></samp>’ compiler option</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
<li><a href="Contributions.html#index-accepting-contributions-7">accepting
contributions</a>: <a
href="Contributions.html#Contributions">Contributions</a></li>
-<li><a href="_002d_002dhelp.html#index-address-for-bug-reports-50">address for
bug reports</a>: <a href="_002d_002dhelp.html#g_t_002d_002dhelp">--help</a></li>
-<li><a
href="Standard-C.html#index-g_t_0040sc_007bansi_007d-C-standard-17"><span
class="sc">ansi</span> C standard</a>: <a
href="Standard-C.html#Standard-C">Standard C</a></li>
-<li><a href="Semantics.html#index-arbitrary-limits-on-data-19">arbitrary
limits on data</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="Character-Set.html#index-ASCII-characters-92">ASCII
characters</a>: <a href="Character-Set.html#Character-Set">Character
Set</a></li>
-<li><a
href="System-Portability.html#index-autoconf-78"><code>autoconf</code></a>: <a
href="System-Portability.html#System-Portability">System Portability</a></li>
+<li><a href="_002d_002dhelp.html#index-address-for-bug-reports-51">address for
bug reports</a>: <a href="_002d_002dhelp.html#g_t_002d_002dhelp">--help</a></li>
+<li><a
href="Standard-C.html#index-g_t_0040sc_007bansi_007d-C-standard-18"><span
class="sc">ansi</span> C standard</a>: <a
href="Standard-C.html#Standard-C">Standard C</a></li>
+<li><a href="Semantics.html#index-arbitrary-limits-on-data-20">arbitrary
limits on data</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Character-Set.html#index-ASCII-characters-93">ASCII
characters</a>: <a href="Character-Set.html#Character-Set">Character
Set</a></li>
+<li><a
href="System-Portability.html#index-autoconf-79"><code>autoconf</code></a>: <a
href="System-Portability.html#System-Portability">System Portability</a></li>
<li><a
href="Reading-Non_002dFree-Code.html#index-avoiding-proprietary-code-5">avoiding
proprietary code</a>: <a
href="Reading-Non_002dFree-Code.html#Reading-Non_002dFree-Code">Reading
Non-Free Code</a></li>
-<li><a
href="User-Interfaces.html#index-behavior_002c-dependent-on-program_0027s-name-33">behavior,
dependent on program's name</a>: <a
href="User-Interfaces.html#User-Interfaces">User Interfaces</a></li>
-<li><a href="Install-Command-Categories.html#index-binary-packages-126">binary
packages</a>: <a
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a></li>
-<li><a
href="Directory-Variables.html#index-bindir-121"><code>bindir</code></a>: <a
href="Directory-Variables.html#Directory-Variables">Directory Variables</a></li>
-<li><a href="Formatting.html#index-braces_002c-in-C-source-58">braces, in C
source</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
-<li><a href="_002d_002dhelp.html#index-bug-reports-51">bug reports</a>: <a
href="_002d_002dhelp.html#g_t_002d_002dhelp">--help</a></li>
-<li><a
href="_002d_002dversion.html#index-canonical-name-of-a-program-47">canonical
name of a program</a>: <a
href="_002d_002dversion.html#g_t_002d_002dversion">--version</a></li>
-<li><a
href="CPU-Portability.html#index-casting-pointers-to-integers-82">casting
pointers to integers</a>: <a href="CPU-Portability.html#CPU-Portability">CPU
Portability</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-CGI-programs_002c-standard-options-for-44">CGI
programs, standard options for</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a href="Change-Logs.html#index-change-logs-104">change logs</a>: <a
href="Change-Logs.html#Change-Logs">Change Logs</a></li>
-<li><a
href="Conditional-Changes.html#index-change-logs_002c-conditional-changes-107">change
logs, conditional changes</a>: <a
href="Conditional-Changes.html#Conditional-Changes">Conditional Changes</a></li>
-<li><a
href="Style-of-Change-Logs.html#index-change-logs_002c-style-105">change logs,
style</a>: <a href="Style-of-Change-Logs.html#Style-of-Change-Logs">Style of
Change Logs</a></li>
-<li><a href="Character-Set.html#index-character-set-90">character set</a>: <a
href="Character-Set.html#Character-Set">Character Set</a></li>
-<li><a
href="Semantics.html#index-command_002dline-arguments_002c-decoding-24">command-line
arguments, decoding</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-command_002dline-interface-39">command-line
interface</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a href="Comments.html#index-commenting-63">commenting</a>: <a
href="Comments.html#Comments">Comments</a></li>
-<li><a
href="Compatibility.html#index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-12">compatibility
with C and <span class="sc">posix</span> standards</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
-<li><a href="Syntactic-Conventions.html#index-compiler-warnings-69">compiler
warnings</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a
href="Conditional-Changes.html#index-conditional-changes_002c-and-change-logs-106">conditional
changes, and change logs</a>: <a
href="Conditional-Changes.html#Conditional-Changes">Conditional Changes</a></li>
-<li><a
href="Comments.html#index-conditionals_002c-comments-for-64">conditionals,
comments for</a>: <a href="Comments.html#Comments">Comments</a></li>
-<li><a
href="Configuration.html#index-configure-111"><code>configure</code></a>: <a
href="Configuration.html#Configuration">Configuration</a></li>
-<li><a href="Formatting.html#index-control_002dL-62">control-L</a>: <a
href="Formatting.html#Formatting">Formatting</a></li>
-<li><a
href="Makefile-Conventions.html#index-conventions-for-makefiles-114">conventions
for makefiles</a>: <a
href="Makefile-Conventions.html#Makefile-Conventions">Makefile
Conventions</a></li>
-<li><a href="Graphical-Interfaces.html#index-corba-37">corba</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
-<li><a href="Manual-Credits.html#index-credits-for-manuals-102">credits for
manuals</a>: <a href="Manual-Credits.html#Manual-Credits">Manual
Credits</a></li>
-<li><a
href="CPU-Portability.html#index-data-types_002c-and-portability-80">data
types, and portability</a>: <a href="CPU-Portability.html#CPU-Portability">CPU
Portability</a></li>
-<li><a
href="System-Functions.html#index-declaration-for-system-functions-85">declaration
for system functions</a>: <a
href="System-Functions.html#System-Functions">System Functions</a></li>
-<li><a href="DESTDIR.html#index-DESTDIR-116"><code>DESTDIR</code></a>: <a
href="DESTDIR.html#DESTDIR">DESTDIR</a></li>
-<li><a href="Documentation.html#index-documentation-99">documentation</a>: <a
href="Documentation.html#Documentation">Documentation</a></li>
-<li><a href="Names.html#index-doschk-76"><code>doschk</code></a>: <a
href="Names.html#Names">Names</a></li>
+<li><a
href="User-Interfaces.html#index-behavior_002c-dependent-on-program_0027s-name-34">behavior,
dependent on program's name</a>: <a
href="User-Interfaces.html#User-Interfaces">User Interfaces</a></li>
+<li><a href="Install-Command-Categories.html#index-binary-packages-127">binary
packages</a>: <a
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a></li>
+<li><a
href="Directory-Variables.html#index-bindir-122"><code>bindir</code></a>: <a
href="Directory-Variables.html#Directory-Variables">Directory Variables</a></li>
+<li><a href="Formatting.html#index-braces_002c-in-C-source-59">braces, in C
source</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
+<li><a href="_002d_002dhelp.html#index-bug-reports-52">bug reports</a>: <a
href="_002d_002dhelp.html#g_t_002d_002dhelp">--help</a></li>
+<li><a
href="_002d_002dversion.html#index-canonical-name-of-a-program-48">canonical
name of a program</a>: <a
href="_002d_002dversion.html#g_t_002d_002dversion">--version</a></li>
+<li><a
href="CPU-Portability.html#index-casting-pointers-to-integers-83">casting
pointers to integers</a>: <a href="CPU-Portability.html#CPU-Portability">CPU
Portability</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-CGI-programs_002c-standard-options-for-45">CGI
programs, standard options for</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a href="Change-Logs.html#index-change-logs-105">change logs</a>: <a
href="Change-Logs.html#Change-Logs">Change Logs</a></li>
+<li><a
href="Conditional-Changes.html#index-change-logs_002c-conditional-changes-108">change
logs, conditional changes</a>: <a
href="Conditional-Changes.html#Conditional-Changes">Conditional Changes</a></li>
+<li><a
href="Style-of-Change-Logs.html#index-change-logs_002c-style-106">change logs,
style</a>: <a href="Style-of-Change-Logs.html#Style-of-Change-Logs">Style of
Change Logs</a></li>
+<li><a href="Character-Set.html#index-character-set-91">character set</a>: <a
href="Character-Set.html#Character-Set">Character Set</a></li>
+<li><a
href="Semantics.html#index-command_002dline-arguments_002c-decoding-25">command-line
arguments, decoding</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-command_002dline-interface-40">command-line
interface</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a href="Comments.html#index-commenting-64">commenting</a>: <a
href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Compatibility.html#index-compatibility-with-C-and-_0040sc_007bposix_007d-standards-13">compatibility
with C and <span class="sc">posix</span> standards</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
+<li><a href="Syntactic-Conventions.html#index-compiler-warnings-70">compiler
warnings</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a
href="Conditional-Changes.html#index-conditional-changes_002c-and-change-logs-107">conditional
changes, and change logs</a>: <a
href="Conditional-Changes.html#Conditional-Changes">Conditional Changes</a></li>
+<li><a
href="Comments.html#index-conditionals_002c-comments-for-65">conditionals,
comments for</a>: <a href="Comments.html#Comments">Comments</a></li>
+<li><a
href="Configuration.html#index-configure-112"><code>configure</code></a>: <a
href="Configuration.html#Configuration">Configuration</a></li>
+<li><a href="Formatting.html#index-control_002dL-63">control-L</a>: <a
href="Formatting.html#Formatting">Formatting</a></li>
+<li><a
href="Makefile-Conventions.html#index-conventions-for-makefiles-115">conventions
for makefiles</a>: <a
href="Makefile-Conventions.html#Makefile-Conventions">Makefile
Conventions</a></li>
+<li><a href="Graphical-Interfaces.html#index-corba-38">corba</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
+<li><a href="Manual-Credits.html#index-credits-for-manuals-103">credits for
manuals</a>: <a href="Manual-Credits.html#Manual-Credits">Manual
Credits</a></li>
+<li><a
href="CPU-Portability.html#index-data-types_002c-and-portability-81">data
types, and portability</a>: <a href="CPU-Portability.html#CPU-Portability">CPU
Portability</a></li>
+<li><a
href="System-Functions.html#index-declaration-for-system-functions-86">declaration
for system functions</a>: <a
href="System-Functions.html#System-Functions">System Functions</a></li>
+<li><a href="DESTDIR.html#index-DESTDIR-117"><code>DESTDIR</code></a>: <a
href="DESTDIR.html#DESTDIR">DESTDIR</a></li>
+<li><a href="Documentation.html#index-documentation-100">documentation</a>: <a
href="Documentation.html#Documentation">Documentation</a></li>
+<li><a href="Names.html#index-doschk-77"><code>doschk</code></a>: <a
href="Names.html#Names">Names</a></li>
<li><a href="Preface.html#index-downloading-this-manual-2">downloading this
manual</a>: <a href="Preface.html#Preface">Preface</a></li>
-<li><a href="Character-Set.html#index-encodings-91">encodings</a>: <a
href="Character-Set.html#Character-Set">Character Set</a></li>
-<li><a href="Semantics.html#index-error-messages-21">error messages</a>: <a
href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="Errors.html#index-error-messages_002c-formatting-31">error
messages, formatting</a>: <a href="Errors.html#Errors">Errors</a></li>
-<li><a
href="Directory-Variables.html#index-exec_005fprefix-120"><code>exec_prefix</code></a>:
<a href="Directory-Variables.html#Directory-Variables">Directory
Variables</a></li>
-<li><a href="Formatting.html#index-expressions_002c-splitting-60">expressions,
splitting</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
-<li><a
href="GNU-Free-Documentation-License.html#index-FDL_002c-GNU-Free-Documentation-License-131">FDL,
GNU Free Documentation License</a>: <a
href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU
Free Documentation License</a></li>
-<li><a href="File-Usage.html#index-file-usage-55">file usage</a>: <a
href="File-Usage.html#File-Usage">File Usage</a></li>
-<li><a href="Names.html#index-file_002dname-limitations-75">file-name
limitations</a>: <a href="Names.html#Names">Names</a></li>
-<li><a href="Errors.html#index-formatting-error-messages-30">formatting error
messages</a>: <a href="Errors.html#Errors">Errors</a></li>
-<li><a href="Formatting.html#index-formatting-source-code-56">formatting
source code</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
-<li><a href="Formatting.html#index-formfeed-61">formfeed</a>: <a
href="Formatting.html#Formatting">Formatting</a></li>
-<li><a
href="Syntactic-Conventions.html#index-function-argument_002c-declaring-68">function
argument, declaring</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a href="Standard-C.html#index-function-prototypes-18">function
prototypes</a>: <a href="Standard-C.html#Standard-C">Standard C</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-getopt-40"><code>getopt</code></a>:
<a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a
href="Internationalization.html#index-gettext-88"><code>gettext</code></a>: <a
href="Internationalization.html#Internationalization">Internationalization</a></li>
-<li><a href="Graphical-Interfaces.html#index-gnome-38">gnome</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
-<li><a
href="Graphical-Interfaces.html#index-graphical-user-interface-35">graphical
user interface</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
-<li><a href="Quote-Characters.html#index-grave-accent-97">grave accent</a>: <a
href="Quote-Characters.html#Quote-Characters">Quote Characters</a></li>
-<li><a href="Graphical-Interfaces.html#index-gtk_002b-36">gtk+</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
-<li><a href="Source-Language.html#index-GUILE-11">GUILE</a>: <a
href="Source-Language.html#Source-Language">Source Language</a></li>
-<li><a
href="Syntactic-Conventions.html#index-implicit-_0040code_007bint_007d-67">implicit
<code>int</code></a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a href="Semantics.html#index-impossible-conditions-26">impossible
conditions</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="DESTDIR.html#index-installations_002c-staged-118">installations,
staged</a>: <a href="DESTDIR.html#DESTDIR">DESTDIR</a></li>
-<li><a
href="Internationalization.html#index-internationalization-87">internationalization</a>:
<a
href="Internationalization.html#Internationalization">Internationalization</a></li>
-<li><a href="Quote-Characters.html#index-left-quote-96">left quote</a>: <a
href="Quote-Characters.html#Quote-Characters">Quote Characters</a></li>
+<li><a href="Character-Set.html#index-encodings-92">encodings</a>: <a
href="Character-Set.html#Character-Set">Character Set</a></li>
+<li><a href="Semantics.html#index-error-messages-22">error messages</a>: <a
href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Errors.html#index-error-messages_002c-formatting-32">error
messages, formatting</a>: <a href="Errors.html#Errors">Errors</a></li>
+<li><a
href="Directory-Variables.html#index-exec_005fprefix-121"><code>exec_prefix</code></a>:
<a href="Directory-Variables.html#Directory-Variables">Directory
Variables</a></li>
+<li><a href="Formatting.html#index-expressions_002c-splitting-61">expressions,
splitting</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
+<li><a
href="GNU-Free-Documentation-License.html#index-FDL_002c-GNU-Free-Documentation-License-132">FDL,
GNU Free Documentation License</a>: <a
href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU
Free Documentation License</a></li>
+<li><a href="File-Usage.html#index-file-usage-56">file usage</a>: <a
href="File-Usage.html#File-Usage">File Usage</a></li>
+<li><a href="Names.html#index-file_002dname-limitations-76">file-name
limitations</a>: <a href="Names.html#Names">Names</a></li>
+<li><a href="Errors.html#index-formatting-error-messages-31">formatting error
messages</a>: <a href="Errors.html#Errors">Errors</a></li>
+<li><a href="Formatting.html#index-formatting-source-code-57">formatting
source code</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
+<li><a href="Formatting.html#index-formfeed-62">formfeed</a>: <a
href="Formatting.html#Formatting">Formatting</a></li>
+<li><a
href="Syntactic-Conventions.html#index-function-argument_002c-declaring-69">function
argument, declaring</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a href="Standard-C.html#index-function-prototypes-19">function
prototypes</a>: <a href="Standard-C.html#Standard-C">Standard C</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-getopt-41"><code>getopt</code></a>:
<a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a
href="Internationalization.html#index-gettext-89"><code>gettext</code></a>: <a
href="Internationalization.html#Internationalization">Internationalization</a></li>
+<li><a href="Graphical-Interfaces.html#index-gnome-39">gnome</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
+<li><a href="Source-Language.html#index-GNOME-and-Guile-12">GNOME and
Guile</a>: <a href="Source-Language.html#Source-Language">Source
Language</a></li>
+<li><a
href="Graphical-Interfaces.html#index-graphical-user-interface-36">graphical
user interface</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
+<li><a href="Quote-Characters.html#index-grave-accent-98">grave accent</a>: <a
href="Quote-Characters.html#Quote-Characters">Quote Characters</a></li>
+<li><a href="Graphical-Interfaces.html#index-gtk_002b-37">gtk+</a>: <a
href="Graphical-Interfaces.html#Graphical-Interfaces">Graphical
Interfaces</a></li>
+<li><a href="Source-Language.html#index-Guile-11">Guile</a>: <a
href="Source-Language.html#Source-Language">Source Language</a></li>
+<li><a
href="Syntactic-Conventions.html#index-implicit-_0040code_007bint_007d-68">implicit
<code>int</code></a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a href="Semantics.html#index-impossible-conditions-27">impossible
conditions</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="DESTDIR.html#index-installations_002c-staged-119">installations,
staged</a>: <a href="DESTDIR.html#DESTDIR">DESTDIR</a></li>
+<li><a
href="Internationalization.html#index-internationalization-88">internationalization</a>:
<a
href="Internationalization.html#Internationalization">Internationalization</a></li>
+<li><a href="Quote-Characters.html#index-left-quote-97">left quote</a>: <a
href="Quote-Characters.html#Quote-Characters">Quote Characters</a></li>
<li><a href="Legal-Issues.html#index-legal-aspects-3">legal aspects</a>: <a
href="Legal-Issues.html#Legal-Issues">Legal Issues</a></li>
<li><a href="Contributions.html#index-legal-papers-6">legal papers</a>: <a
href="Contributions.html#Contributions">Contributions</a></li>
-<li><a
href="Directory-Variables.html#index-libexecdir-123"><code>libexecdir</code></a>:
<a href="Directory-Variables.html#Directory-Variables">Directory
Variables</a></li>
-<li><a href="Libraries.html#index-libraries-29">libraries</a>: <a
href="Libraries.html#Libraries">Libraries</a></li>
-<li><a
href="System-Functions.html#index-library-functions_002c-and-portability-83">library
functions, and portability</a>: <a
href="System-Functions.html#System-Functions">System Functions</a></li>
-<li><a href="License-for-Manuals.html#index-license-for-manuals-101">license
for manuals</a>: <a href="License-for-Manuals.html#License-for-Manuals">License
for Manuals</a></li>
-<li><a href="Syntactic-Conventions.html#index-lint-73"><code>lint</code></a>:
<a href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a
href="Quote-Characters.html#index-locale_002dspecific-quote-characters-95">locale-specific
quote characters</a>: <a href="Quote-Characters.html#Quote-Characters">Quote
Characters</a></li>
-<li><a href="Option-Table.html#index-long-option-names-52">long option
names</a>: <a href="Option-Table.html#Option-Table">Option Table</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-long_002dnamed-options-41">long-named
options</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a
href="Makefile-Conventions.html#index-makefile_002c-conventions-for-113">makefile,
conventions for</a>: <a
href="Makefile-Conventions.html#Makefile-Conventions">Makefile
Conventions</a></li>
-<li><a
href="Semantics.html#index-g_t_0040code_007bmalloc_007d-return-value-22"><code>malloc</code>
return value</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="Man-Pages.html#index-man-pages-108">man pages</a>: <a
href="Man-Pages.html#Man-Pages">Man Pages</a></li>
-<li><a href="Manual-Structure-Details.html#index-manual-structure-100">manual
structure</a>: <a
href="Manual-Structure-Details.html#Manual-Structure-Details">Manual Structure
Details</a></li>
-<li><a href="Semantics.html#index-memory-allocation-failure-23">memory
allocation failure</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="Memory-Usage.html#index-memory-usage-54">memory usage</a>: <a
href="Memory-Usage.html#Memory-Usage">Memory Usage</a></li>
-<li><a
href="Internationalization.html#index-message-text_002c-and-internationalization-89">message
text, and internationalization</a>: <a
href="Internationalization.html#Internationalization">Internationalization</a></li>
-<li><a href="Mmap.html#index-mmap-98"><code>mmap</code></a>: <a
href="Mmap.html#Mmap">Mmap</a></li>
-<li><a
href="Syntactic-Conventions.html#index-multiple-variables-in-a-line-72">multiple
variables in a line</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a
href="Names.html#index-names-of-variables_002c-functions_002c-and-files-74">names
of variables, functions, and files</a>: <a
href="Names.html#Names">Names</a></li>
-<li><a
href="NEWS-File.html#index-g_t_0040file_007bNEWS_007d-file-103"><samp><span
class="file">NEWS</span></samp> file</a>: <a
href="NEWS-File.html#NEWS-File">NEWS File</a></li>
-<li><a href="Character-Set.html#index-non_002dASCII-characters-93">non-ASCII
characters</a>: <a href="Character-Set.html#Character-Set">Character
Set</a></li>
-<li><a
href="System-Portability.html#index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-79">non-<span
class="sc">posix</span> systems, and portability</a>: <a
href="System-Portability.html#System-Portability">System Portability</a></li>
-<li><a
href="Using-Extensions.html#index-non_002dstandard-extensions-16">non-standard
extensions</a>: <a href="Using-Extensions.html#Using-Extensions">Using
Extensions</a></li>
-<li><a
href="Semantics.html#index-g_t_0040code_007bNUL_007d-characters-20"><code>NUL</code>
characters</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="Formatting.html#index-open-brace-57">open brace</a>: <a
href="Formatting.html#Formatting">Formatting</a></li>
-<li><a
href="Configuration.html#index-optional-features_002c-configure_002dtime-112">optional
features, configure-time</a>: <a
href="Configuration.html#Configuration">Configuration</a></li>
-<li><a href="Compatibility.html#index-options-for-compatibility-14">options
for compatibility</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-options_002c-standard-command_002dline-43">options,
standard command-line</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a
href="User-Interfaces.html#index-output-device-and-program_0027s-behavior-34">output
device and program's behavior</a>: <a
href="User-Interfaces.html#User-Interfaces">User Interfaces</a></li>
-<li><a href="Releases.html#index-packaging-127">packaging</a>: <a
href="Releases.html#Releases">Releases</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-PATH_005fINFO_002c-specifying-standard-options-as-45">PATH_INFO,
specifying standard options as</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a
href="CPU-Portability.html#index-portability_002c-and-data-types-81">portability,
and data types</a>: <a href="CPU-Portability.html#CPU-Portability">CPU
Portability</a></li>
-<li><a
href="System-Functions.html#index-portability_002c-and-library-functions-84">portability,
and library functions</a>: <a
href="System-Functions.html#System-Functions">System Functions</a></li>
-<li><a
href="System-Portability.html#index-portability_002c-between-system-types-77">portability,
between system types</a>: <a
href="System-Portability.html#System-Portability">System Portability</a></li>
-<li><a
href="Compatibility.html#index-g_t_0040sc_007bposix_007d-compatibility-13"><span
class="sc">posix</span> compatibility</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
-<li><a
href="Compatibility.html#index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-15"><code>POSIXLY_CORRECT</code>,
environment variable</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
-<li><a
href="Install-Command-Categories.html#index-post_002dinstallation-commands-125">post-installation
commands</a>: <a
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a></li>
-<li><a
href="Install-Command-Categories.html#index-pre_002dinstallation-commands-124">pre-installation
commands</a>: <a
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a></li>
-<li><a
href="Directory-Variables.html#index-prefix-119"><code>prefix</code></a>: <a
href="Directory-Variables.html#Directory-Variables">Directory Variables</a></li>
-<li><a href="Configuration.html#index-program-configuration-110">program
configuration</a>: <a
href="Configuration.html#Configuration">Configuration</a></li>
+<li><a
href="Directory-Variables.html#index-libexecdir-124"><code>libexecdir</code></a>:
<a href="Directory-Variables.html#Directory-Variables">Directory
Variables</a></li>
+<li><a href="Libraries.html#index-libraries-30">libraries</a>: <a
href="Libraries.html#Libraries">Libraries</a></li>
+<li><a
href="System-Functions.html#index-library-functions_002c-and-portability-84">library
functions, and portability</a>: <a
href="System-Functions.html#System-Functions">System Functions</a></li>
+<li><a href="License-for-Manuals.html#index-license-for-manuals-102">license
for manuals</a>: <a href="License-for-Manuals.html#License-for-Manuals">License
for Manuals</a></li>
+<li><a href="Syntactic-Conventions.html#index-lint-74"><code>lint</code></a>:
<a href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a
href="Quote-Characters.html#index-locale_002dspecific-quote-characters-96">locale-specific
quote characters</a>: <a href="Quote-Characters.html#Quote-Characters">Quote
Characters</a></li>
+<li><a href="Option-Table.html#index-long-option-names-53">long option
names</a>: <a href="Option-Table.html#Option-Table">Option Table</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-long_002dnamed-options-42">long-named
options</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a
href="Makefile-Conventions.html#index-makefile_002c-conventions-for-114">makefile,
conventions for</a>: <a
href="Makefile-Conventions.html#Makefile-Conventions">Makefile
Conventions</a></li>
+<li><a
href="Semantics.html#index-g_t_0040code_007bmalloc_007d-return-value-23"><code>malloc</code>
return value</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Man-Pages.html#index-man-pages-109">man pages</a>: <a
href="Man-Pages.html#Man-Pages">Man Pages</a></li>
+<li><a href="Manual-Structure-Details.html#index-manual-structure-101">manual
structure</a>: <a
href="Manual-Structure-Details.html#Manual-Structure-Details">Manual Structure
Details</a></li>
+<li><a href="Semantics.html#index-memory-allocation-failure-24">memory
allocation failure</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Memory-Usage.html#index-memory-usage-55">memory usage</a>: <a
href="Memory-Usage.html#Memory-Usage">Memory Usage</a></li>
+<li><a
href="Internationalization.html#index-message-text_002c-and-internationalization-90">message
text, and internationalization</a>: <a
href="Internationalization.html#Internationalization">Internationalization</a></li>
+<li><a href="Mmap.html#index-mmap-99"><code>mmap</code></a>: <a
href="Mmap.html#Mmap">Mmap</a></li>
+<li><a
href="Syntactic-Conventions.html#index-multiple-variables-in-a-line-73">multiple
variables in a line</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a
href="Names.html#index-names-of-variables_002c-functions_002c-and-files-75">names
of variables, functions, and files</a>: <a
href="Names.html#Names">Names</a></li>
+<li><a
href="NEWS-File.html#index-g_t_0040file_007bNEWS_007d-file-104"><samp><span
class="file">NEWS</span></samp> file</a>: <a
href="NEWS-File.html#NEWS-File">NEWS File</a></li>
+<li><a href="Character-Set.html#index-non_002dASCII-characters-94">non-ASCII
characters</a>: <a href="Character-Set.html#Character-Set">Character
Set</a></li>
+<li><a
href="System-Portability.html#index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-80">non-<span
class="sc">posix</span> systems, and portability</a>: <a
href="System-Portability.html#System-Portability">System Portability</a></li>
+<li><a
href="Using-Extensions.html#index-non_002dstandard-extensions-17">non-standard
extensions</a>: <a href="Using-Extensions.html#Using-Extensions">Using
Extensions</a></li>
+<li><a
href="Semantics.html#index-g_t_0040code_007bNUL_007d-characters-21"><code>NUL</code>
characters</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Formatting.html#index-open-brace-58">open brace</a>: <a
href="Formatting.html#Formatting">Formatting</a></li>
+<li><a
href="Configuration.html#index-optional-features_002c-configure_002dtime-113">optional
features, configure-time</a>: <a
href="Configuration.html#Configuration">Configuration</a></li>
+<li><a href="Compatibility.html#index-options-for-compatibility-15">options
for compatibility</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-options_002c-standard-command_002dline-44">options,
standard command-line</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a
href="User-Interfaces.html#index-output-device-and-program_0027s-behavior-35">output
device and program's behavior</a>: <a
href="User-Interfaces.html#User-Interfaces">User Interfaces</a></li>
+<li><a href="Releases.html#index-packaging-128">packaging</a>: <a
href="Releases.html#Releases">Releases</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-PATH_005fINFO_002c-specifying-standard-options-as-46">PATH_INFO,
specifying standard options as</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a
href="CPU-Portability.html#index-portability_002c-and-data-types-82">portability,
and data types</a>: <a href="CPU-Portability.html#CPU-Portability">CPU
Portability</a></li>
+<li><a
href="System-Functions.html#index-portability_002c-and-library-functions-85">portability,
and library functions</a>: <a
href="System-Functions.html#System-Functions">System Functions</a></li>
+<li><a
href="System-Portability.html#index-portability_002c-between-system-types-78">portability,
between system types</a>: <a
href="System-Portability.html#System-Portability">System Portability</a></li>
+<li><a
href="Compatibility.html#index-g_t_0040sc_007bposix_007d-compatibility-14"><span
class="sc">posix</span> compatibility</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
+<li><a
href="Compatibility.html#index-g_t_0040code_007bPOSIXLY_005fCORRECT_007d_002c-environment-variable-16"><code>POSIXLY_CORRECT</code>,
environment variable</a>: <a
href="Compatibility.html#Compatibility">Compatibility</a></li>
+<li><a
href="Install-Command-Categories.html#index-post_002dinstallation-commands-126">post-installation
commands</a>: <a
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a></li>
+<li><a
href="Install-Command-Categories.html#index-pre_002dinstallation-commands-125">pre-installation
commands</a>: <a
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a></li>
+<li><a
href="Directory-Variables.html#index-prefix-120"><code>prefix</code></a>: <a
href="Directory-Variables.html#Directory-Variables">Directory Variables</a></li>
+<li><a href="Configuration.html#index-program-configuration-111">program
configuration</a>: <a
href="Configuration.html#Configuration">Configuration</a></li>
<li><a href="Design-Advice.html#index-program-design-9">program design</a>: <a
href="Design-Advice.html#Design-Advice">Design Advice</a></li>
-<li><a
href="User-Interfaces.html#index-program-name-and-its-behavior-32">program name
and its behavior</a>: <a href="User-Interfaces.html#User-Interfaces">User
Interfaces</a></li>
-<li><a
href="_002d_002dversion.html#index-program_0027s-canonical-name-48">program's
canonical name</a>: <a
href="_002d_002dversion.html#g_t_002d_002dversion">--version</a></li>
+<li><a
href="User-Interfaces.html#index-program-name-and-its-behavior-33">program name
and its behavior</a>: <a href="User-Interfaces.html#User-Interfaces">User
Interfaces</a></li>
+<li><a
href="_002d_002dversion.html#index-program_0027s-canonical-name-49">program's
canonical name</a>: <a
href="_002d_002dversion.html#g_t_002d_002dversion">--version</a></li>
<li><a href="Source-Language.html#index-programming-languages-10">programming
languages</a>: <a href="Source-Language.html#Source-Language">Source
Language</a></li>
<li><a
href="Reading-Non_002dFree-Code.html#index-proprietary-programs-4">proprietary
programs</a>: <a
href="Reading-Non_002dFree-Code.html#Reading-Non_002dFree-Code">Reading
Non-Free Code</a></li>
-<li><a href="Quote-Characters.html#index-quote-characters-94">quote
characters</a>: <a href="Quote-Characters.html#Quote-Characters">Quote
Characters</a></li>
-<li><a
href="Releases.html#index-g_t_0040file_007bREADME_007d-file-128"><samp><span
class="file">README</span></samp> file</a>: <a
href="Releases.html#Releases">Releases</a></li>
-<li><a
href="References.html#index-references-to-non_002dfree-material-130">references
to non-free material</a>: <a
href="References.html#References">References</a></li>
-<li><a href="Managing-Releases.html#index-releasing-109">releasing</a>: <a
href="Managing-Releases.html#Managing-Releases">Managing Releases</a></li>
-<li><a
href="Directory-Variables.html#index-sbindir-122"><code>sbindir</code></a>: <a
href="Directory-Variables.html#Directory-Variables">Directory Variables</a></li>
-<li><a href="Semantics.html#index-signal-handling-25">signal handling</a>: <a
href="Semantics.html#Semantics">Semantics</a></li>
-<li><a href="Formatting.html#index-spaces-before-open_002dparen-59">spaces
before open-paren</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
-<li><a href="DESTDIR.html#index-staged-installs-117">staged installs</a>: <a
href="DESTDIR.html#DESTDIR">DESTDIR</a></li>
-<li><a
href="Command_002dLine-Interfaces.html#index-standard-command_002dline-options-42">standard
command-line options</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
-<li><a
href="Makefile-Conventions.html#index-standards-for-makefiles-115">standards
for makefiles</a>: <a
href="Makefile-Conventions.html#Makefile-Conventions">Makefile
Conventions</a></li>
-<li><a href="System-Functions.html#index-string-library-functions-86">string
library functions</a>: <a href="System-Functions.html#System-Functions">System
Functions</a></li>
-<li><a
href="Syntactic-Conventions.html#index-syntactic-conventions-66">syntactic
conventions</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a href="Option-Table.html#index-table-of-long-options-53">table of long
options</a>: <a href="Option-Table.html#Option-Table">Option Table</a></li>
-<li><a href="Semantics.html#index-temporary-files-27">temporary files</a>: <a
href="Semantics.html#Semantics">Semantics</a></li>
-<li><a
href="Syntactic-Conventions.html#index-temporary-variables-71">temporary
variables</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
-<li><a
href="Releases.html#index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-129"><samp><span
class="file">texinfo.tex</span></samp>, in a distribution</a>: <a
href="Releases.html#Releases">Releases</a></li>
-<li><a
href="Semantics.html#index-g_t_0040code_007bTMPDIR_007d-environment-variable-28"><code>TMPDIR</code>
environment variable</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Quote-Characters.html#index-quote-characters-95">quote
characters</a>: <a href="Quote-Characters.html#Quote-Characters">Quote
Characters</a></li>
+<li><a
href="Releases.html#index-g_t_0040file_007bREADME_007d-file-129"><samp><span
class="file">README</span></samp> file</a>: <a
href="Releases.html#Releases">Releases</a></li>
+<li><a
href="References.html#index-references-to-non_002dfree-material-131">references
to non-free material</a>: <a
href="References.html#References">References</a></li>
+<li><a href="Managing-Releases.html#index-releasing-110">releasing</a>: <a
href="Managing-Releases.html#Managing-Releases">Managing Releases</a></li>
+<li><a
href="Directory-Variables.html#index-sbindir-123"><code>sbindir</code></a>: <a
href="Directory-Variables.html#Directory-Variables">Directory Variables</a></li>
+<li><a href="Semantics.html#index-signal-handling-26">signal handling</a>: <a
href="Semantics.html#Semantics">Semantics</a></li>
+<li><a href="Formatting.html#index-spaces-before-open_002dparen-60">spaces
before open-paren</a>: <a href="Formatting.html#Formatting">Formatting</a></li>
+<li><a href="DESTDIR.html#index-staged-installs-118">staged installs</a>: <a
href="DESTDIR.html#DESTDIR">DESTDIR</a></li>
+<li><a
href="Command_002dLine-Interfaces.html#index-standard-command_002dline-options-43">standard
command-line options</a>: <a
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces">Command-Line
Interfaces</a></li>
+<li><a
href="Makefile-Conventions.html#index-standards-for-makefiles-116">standards
for makefiles</a>: <a
href="Makefile-Conventions.html#Makefile-Conventions">Makefile
Conventions</a></li>
+<li><a href="System-Functions.html#index-string-library-functions-87">string
library functions</a>: <a href="System-Functions.html#System-Functions">System
Functions</a></li>
+<li><a
href="Syntactic-Conventions.html#index-syntactic-conventions-67">syntactic
conventions</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a href="Option-Table.html#index-table-of-long-options-54">table of long
options</a>: <a href="Option-Table.html#Option-Table">Option Table</a></li>
+<li><a href="Semantics.html#index-temporary-files-28">temporary files</a>: <a
href="Semantics.html#Semantics">Semantics</a></li>
+<li><a
href="Syntactic-Conventions.html#index-temporary-variables-72">temporary
variables</a>: <a
href="Syntactic-Conventions.html#Syntactic-Conventions">Syntactic
Conventions</a></li>
+<li><a
href="Releases.html#index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-130"><samp><span
class="file">texinfo.tex</span></samp>, in a distribution</a>: <a
href="Releases.html#Releases">Releases</a></li>
+<li><a
href="Semantics.html#index-g_t_0040code_007bTMPDIR_007d-environment-variable-29"><code>TMPDIR</code>
environment variable</a>: <a href="Semantics.html#Semantics">Semantics</a></li>
<li><a href="Trademarks.html#index-trademarks-8">trademarks</a>: <a
href="Trademarks.html#Trademarks">Trademarks</a></li>
<li><a
href="Preface.html#index-where-to-obtain-_0040code_007bstandards_002etexi_007d-1">where
to obtain <code>standards.texi</code></a>: <a
href="Preface.html#Preface">Preface</a></li>
</ul></body></html>
Index: html_node/Indicating-the-Part-Changed.html
===================================================================
RCS file:
/web/www/www/prep/standards/html_node/Indicating-the-Part-Changed.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Indicating-the-Part-Changed.html 25 Apr 2008 18:41:47 -0000
1.25
+++ html_node/Indicating-the-Part-Changed.html 5 May 2008 17:25:47 -0000
1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Conditional-Changes.html#Conditional-Changes"
title="Conditional Changes">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Install-Command-Categories.html
===================================================================
RCS file:
/web/www/www/prep/standards/html_node/Install-Command-Categories.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Install-Command-Categories.html 25 Apr 2008 18:41:47 -0000
1.25
+++ html_node/Install-Command-Categories.html 5 May 2008 17:25:47 -0000
1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Standard-Targets.html#Standard-Targets" title="Standard
Targets">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,7 +46,7 @@
<h4 class="subsection">7.2.7 Install Command Categories</h4>
-<p><a name="index-pre_002dinstallation-commands-124"></a><a
name="index-post_002dinstallation-commands-125"></a>When writing the
<code>install</code> target, you must classify all the
+<p><a name="index-pre_002dinstallation-commands-125"></a><a
name="index-post_002dinstallation-commands-126"></a>When writing the
<code>install</code> target, you must classify all the
commands into three categories: normal ones, <dfn>pre-installation</dfn>
commands and <dfn>post-installation</dfn> commands.
@@ -119,7 +119,7 @@
mkdir mkfifo mknod mv printenv pwd rm rmdir sed sort tee
test touch true uname xargs yes
</pre>
- <p><a name="index-binary-packages-126"></a>The reason for distinguishing
the commands in this way is for the sake
+ <p><a name="index-binary-packages-127"></a>The reason for distinguishing
the commands in this way is for the sake
of making binary packages. Typically a binary package contains all the
executables and other files that need to be installed, and has its own
method of installing them—so it does not need to run the normal
Index: html_node/Internationalization.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Internationalization.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Internationalization.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Internationalization.html 5 May 2008 17:25:47 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Character-Set.html#Character-Set" title="Character Set">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,8 +48,8 @@
<h3 class="section">5.8 Internationalization</h3>
-<p><a name="index-internationalization-87"></a>
-<a name="index-gettext-88"></a>GNU has a library called GNU gettext that makes
it easy to translate the
+<p><a name="index-internationalization-88"></a>
+<a name="index-gettext-89"></a>GNU has a library called GNU gettext that makes
it easy to translate the
messages in a program into various languages. You should use this
library in every program. Use English for the messages as they appear
in the program, and let gettext provide the way to translate them into
@@ -72,7 +72,7 @@
Normally, the text domain name should be the same as the name of the
package—for example, ‘<samp><span
class="samp">coreutils</span></samp>’ for the GNU core utilities.
- <p><a name="index-message-text_002c-and-internationalization-89"></a>To
enable gettext to work well, avoid writing code that makes
+ <p><a name="index-message-text_002c-and-internationalization-90"></a>To
enable gettext to work well, avoid writing code that makes
assumptions about the structure of words or sentences. When you want
the precise text of a sentence to vary depending on the data, use two or
more alternative string constants each containing a complete sentences,
Index: html_node/Legal-Issues.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Legal-Issues.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Legal-Issues.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Legal-Issues.html 5 May 2008 17:25:47 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Design-Advice.html#Design-Advice" title="Design Advice">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Libraries.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Libraries.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Libraries.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Libraries.html 5 May 2008 17:25:47 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Errors.html#Errors" title="Errors">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">4.3 Library Behavior</h3>
-<p><a name="index-libraries-29"></a>
+<p><a name="index-libraries-30"></a>
Try to make library functions reentrant. If they need to do dynamic
storage allocation, at least try to avoid any nonreentrancy aside from
that of <code>malloc</code> itself.
Index: html_node/License-for-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/License-for-Manuals.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/License-for-Manuals.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/License-for-Manuals.html 5 May 2008 17:25:47 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Manual-Credits.html#Manual-Credits" title="Manual
Credits">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">6.4 License for Manuals</h3>
-<p><a name="index-license-for-manuals-101"></a>
+<p><a name="index-license-for-manuals-102"></a>
Please use the GNU Free Documentation License for all GNU manuals that
are more than a few pages long. Likewise for a collection of short
documents—you only need one copy of the GNU FDL for the whole
Index: html_node/Makefile-Basics.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Makefile-Basics.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Makefile-Basics.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Makefile-Basics.html 5 May 2008 17:25:47 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Utilities-in-Makefiles.html#Utilities-in-Makefiles"
title="Utilities in Makefiles">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Makefile-Conventions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Makefile-Conventions.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- html_node/Makefile-Conventions.html 25 Apr 2008 18:41:47 -0000 1.26
+++ html_node/Makefile-Conventions.html 5 May 2008 17:25:47 -0000 1.27
@@ -10,7 +10,7 @@
<link rel="next" href="Releases.html#Releases" title="Releases">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -49,7 +49,7 @@
<h3 class="section">7.2 Makefile Conventions</h3>
<!-- standards.texi does not print an index, but make.texinfo does. -->
-<p><a name="index-makefile_002c-conventions-for-113"></a><a
name="index-conventions-for-makefiles-114"></a><a
name="index-standards-for-makefiles-115"></a>
+<p><a name="index-makefile_002c-conventions-for-114"></a><a
name="index-conventions-for-makefiles-115"></a><a
name="index-standards-for-makefiles-116"></a>
<!-- Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2001, -->
<!-- 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. -->
Index: html_node/Man-Pages.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Man-Pages.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Man-Pages.html 25 Apr 2008 18:41:47 -0000 1.25
+++ html_node/Man-Pages.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Reading-other-Manuals.html#Reading-other-Manuals"
title="Reading other Manuals">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">6.9 Man Pages</h3>
-<p><a name="index-man-pages-108"></a>
+<p><a name="index-man-pages-109"></a>
In the GNU project, man pages are secondary. It is not necessary or
expected for every GNU program to have a man page, but some of them do.
It's your choice whether to include a man page in your program.
Index: html_node/Managing-Releases.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Managing-Releases.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Managing-Releases.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Managing-Releases.html 5 May 2008 17:25:48 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="References.html#References" title="References">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -47,7 +47,7 @@
<h2 class="chapter">7 The Release Process</h2>
-<p><a name="index-releasing-109"></a>
+<p><a name="index-releasing-110"></a>
Making a release is more than just bundling up your source files in a
tar file and putting it up for FTP. You should set up your software so
that it can be configured to run on a variety of systems. Your Makefile
Index: html_node/Manual-Credits.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Manual-Credits.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Manual-Credits.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Manual-Credits.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Printed-Manuals.html#Printed-Manuals" title="Printed
Manuals">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">6.5 Manual Credits</h3>
-<p><a name="index-credits-for-manuals-102"></a>
+<p><a name="index-credits-for-manuals-103"></a>
Please credit the principal human writers of the manual as the authors,
on the title page of the manual. If a company sponsored the work, thank
the company in a suitable place in the manual, but do not cite the
Index: html_node/Manual-Structure-Details.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Manual-Structure-Details.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Manual-Structure-Details.html 25 Apr 2008 18:41:48 -0000
1.25
+++ html_node/Manual-Structure-Details.html 5 May 2008 17:25:48 -0000
1.26
@@ -10,7 +10,7 @@
<link rel="next" href="License-for-Manuals.html#License-for-Manuals"
title="License for Manuals">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">6.3 Manual Structure Details</h3>
-<p><a name="index-manual-structure-100"></a>
+<p><a name="index-manual-structure-101"></a>
The title page of the manual should state the version of the programs or
packages documented in the manual. The Top node of the manual should
also contain this information. If the manual is changing more
Index: html_node/Memory-Usage.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Memory-Usage.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Memory-Usage.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Memory-Usage.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="File-Usage.html#File-Usage" title="File Usage">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">4.9 Memory Usage</h3>
-<p><a name="index-memory-usage-54"></a>
+<p><a name="index-memory-usage-55"></a>
If a program typically uses just a few meg of memory, don't bother making any
effort to reduce memory usage. For example, if it is impractical for
other reasons to operate on files more than a few meg long, it is
Index: html_node/Mmap.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Mmap.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Mmap.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Mmap.html 5 May 2008 17:25:48 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Quote-Characters.html#Quote-Characters" title="Quote
Characters">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,7 +46,7 @@
<h3 class="section">5.11 Mmap</h3>
-<p><a name="index-mmap-98"></a>
+<p><a name="index-mmap-99"></a>
Don't assume that <code>mmap</code> either works on all files or fails
for all files. It may work on some files and fail on others.
Index: html_node/NEWS-File.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/NEWS-File.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/NEWS-File.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/NEWS-File.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Change-Logs.html#Change-Logs" title="Change Logs">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">6.7 The NEWS File</h3>
-<p><a name="index-g_t_0040file_007bNEWS_007d-file-103"></a>
+<p><a name="index-g_t_0040file_007bNEWS_007d-file-104"></a>
In addition to its manual, the package should have a file named
<samp><span class="file">NEWS</span></samp> which contains a list of
user-visible changes worth
mentioning. In each new release, add items to the front of the file and
Index: html_node/Names.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Names.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Names.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Names.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="System-Portability.html#System-Portability"
title="System Portability">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.4 Naming Variables, Functions, and Files</h3>
-<p><a name="index-names-of-variables_002c-functions_002c-and-files-74"></a>The
names of global variables and functions in a program serve as
+<p><a name="index-names-of-variables_002c-functions_002c-and-files-75"></a>The
names of global variables and functions in a program serve as
comments of a sort. So don't choose terse names—instead, look for
names that give useful information about the meaning of the variable or
function. In a GNU program, names should be English, like other
@@ -81,7 +81,7 @@
<code>enum</code> rather than ‘<samp><span
class="samp">#define</span></samp>’. GDB knows about enumeration
constants.
- <p><a name="index-file_002dname-limitations-75"></a><a
name="index-doschk-76"></a>You might want to make sure that none of the file
names would conflict
+ <p><a name="index-file_002dname-limitations-76"></a><a
name="index-doschk-77"></a>You might want to make sure that none of the file
names would conflict
if the files were loaded onto an MS-DOS file system which shortens the
names. You can use the program <code>doschk</code> to test for this.
Index: html_node/Non_002dGNU-Standards.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Non_002dGNU-Standards.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -b -r1.15 -r1.16
--- html_node/Non_002dGNU-Standards.html 25 Apr 2008 18:41:48 -0000
1.15
+++ html_node/Non_002dGNU-Standards.html 5 May 2008 17:25:48 -0000
1.16
@@ -9,7 +9,7 @@
<link rel="next" href="Semantics.html#Semantics" title="Semantics">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Option-Table.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Option-Table.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Option-Table.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Option-Table.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Memory-Usage.html#Memory-Usage" title="Memory Usage">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">4.8 Table of Long Options</h3>
-<p><a name="index-long-option-names-52"></a><a
name="index-table-of-long-options-53"></a>
+<p><a name="index-long-option-names-53"></a><a
name="index-table-of-long-options-54"></a>
Here is a table of long options used by GNU programs. It is surely
incomplete, but we aim to list all the options that a new program might
want to be compatible with. If you use names not already in the table,
Index: html_node/Preface.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Preface.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Preface.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Preface.html 5 May 2008 17:25:48 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Legal-Issues.html#Legal-Issues" title="Legal Issues">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -56,7 +56,7 @@
state reasons for writing in a certain way.
<p>This release of the GNU Coding Standards was last updated
-February 23, 2008.
+May 5, 2008.
<p><a
name="index-where-to-obtain-_0040code_007bstandards_002etexi_007d-1"></a><a
name="index-downloading-this-manual-2"></a>If you did not obtain this file
directly from the GNU project and
recently, please check for a newer version. You can get the GNU
Index: html_node/Printed-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Printed-Manuals.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Printed-Manuals.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Printed-Manuals.html 5 May 2008 17:25:48 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="NEWS-File.html#NEWS-File" title="NEWS File">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Program-Behavior.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Program-Behavior.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Program-Behavior.html 25 Apr 2008 18:41:48 -0000 1.25
+++ html_node/Program-Behavior.html 5 May 2008 17:25:48 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Writing-C.html#Writing-C" title="Writing C">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Quote-Characters.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Quote-Characters.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- html_node/Quote-Characters.html 25 Apr 2008 18:41:48 -0000 1.17
+++ html_node/Quote-Characters.html 5 May 2008 17:25:48 -0000 1.18
@@ -10,7 +10,7 @@
<link rel="next" href="Mmap.html#Mmap" title="Mmap">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.10 Quote Characters</h3>
-<p><a name="index-quote-characters-94"></a><a
name="index-locale_002dspecific-quote-characters-95"></a><a
name="index-left-quote-96"></a><a name="index-grave-accent-97"></a>
+<p><a name="index-quote-characters-95"></a><a
name="index-locale_002dspecific-quote-characters-96"></a><a
name="index-left-quote-97"></a><a name="index-grave-accent-98"></a>
In the C locale, GNU programs should stick to plain ASCII for quotation
characters in messages to users: preferably 0x60 (‘<samp><span
class="samp">`</span></samp>’) for left
quotes and 0x27 (‘<samp><span class="samp">'</span></samp>’) for
right quotes. It is ok, but not
Index: html_node/Reading-Non_002dFree-Code.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Reading-Non_002dFree-Code.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Reading-Non_002dFree-Code.html 25 Apr 2008 18:41:49 -0000
1.25
+++ html_node/Reading-Non_002dFree-Code.html 5 May 2008 17:25:49 -0000
1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Contributions.html#Contributions" title="Contributions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Reading-other-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Reading-other-Manuals.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Reading-other-Manuals.html 25 Apr 2008 18:41:49 -0000
1.25
+++ html_node/Reading-other-Manuals.html 5 May 2008 17:25:49 -0000
1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Man-Pages.html#Man-Pages" title="Man Pages">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/References.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/References.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/References.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/References.html 5 May 2008 17:25:49 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next"
href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License"
title="GNU Free Documentation License">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -47,7 +47,7 @@
<h2 class="chapter">8 References to Non-Free Software and Documentation</h2>
-<p><a name="index-references-to-non_002dfree-material-130"></a>
+<p><a name="index-references-to-non_002dfree-material-131"></a>
A GNU program should not recommend, promote, or grant legitimacy to
the use of any non-free program. Proprietary software is a social and
ethical problem, and our aim is to put an end to that problem. We
Index: html_node/Releases.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Releases.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Releases.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Releases.html 5 May 2008 17:25:49 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -46,7 +46,7 @@
<h3 class="section">7.3 Making Releases</h3>
-<p><a name="index-packaging-127"></a>
+<p><a name="index-packaging-128"></a>
You should identify each release with a pair of version numbers, a
major version and a minor. We have no objection to using more than
two numbers, but it is very unlikely that you really need them.
@@ -62,7 +62,7 @@
and never changed automatically; non-source files are produced from
source files by programs under the control of the Makefile.
- <p><a name="index-g_t_0040file_007bREADME_007d-file-128"></a>The
distribution should contain a file named <samp><span
class="file">README</span></samp> which gives
+ <p><a name="index-g_t_0040file_007bREADME_007d-file-129"></a>The
distribution should contain a file named <samp><span
class="file">README</span></samp> which gives
the name of the package, and a general description of what it does. It
is also good to explain the purpose of each of the first-level
subdirectories in the package, if there are any. The <samp><span
class="file">README</span></samp> file
@@ -113,7 +113,7 @@
are truncated to <samp><span class="file">foobarha.c</span></samp> and
<samp><span class="file">foobarha.o</span></samp>, which are
distinct.
- <p><a
name="index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-129"></a>Include
in your distribution a copy of the <samp><span
class="file">texinfo.tex</span></samp> you used
+ <p><a
name="index-g_t_0040file_007btexinfo_002etex_007d_002c-in-a-distribution-130"></a>Include
in your distribution a copy of the <samp><span
class="file">texinfo.tex</span></samp> you used
to test print any <samp><span class="file">*.texinfo</span></samp> or
<samp><span class="file">*.texi</span></samp> files.
<p>Likewise, if your program uses small GNU software packages like regex,
Index: html_node/Semantics.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Semantics.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Semantics.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Semantics.html 5 May 2008 17:25:49 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Libraries.html#Libraries" title="Libraries">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,12 +48,12 @@
<h3 class="section">4.2 Writing Robust Programs</h3>
-<p><a name="index-arbitrary-limits-on-data-19"></a>Avoid arbitrary limits on
the length or number of <em>any</em> data
+<p><a name="index-arbitrary-limits-on-data-20"></a>Avoid arbitrary limits on
the length or number of <em>any</em> data
structure, including file names, lines, files, and symbols, by allocating
all data structures dynamically. In most Unix utilities, “long lines
are silently truncated”. This is not acceptable in a GNU utility.
- <p><a name="index-g_t_0040code_007bNUL_007d-characters-20"></a>Utilities
reading files should not drop NUL characters, or any other
+ <p><a name="index-g_t_0040code_007bNUL_007d-characters-21"></a>Utilities
reading files should not drop NUL characters, or any other
nonprinting characters <em>including those with codes above 0177</em>.
The only sensible exceptions would be utilities specifically intended
for interface to certain types of terminals or printers
@@ -62,14 +62,14 @@
sequences of bytes that represent multibyte characters, using encodings
such as UTF-8 and others.
- <p><a name="index-error-messages-21"></a>Check every system call for an
error return, unless you know you wish to
+ <p><a name="index-error-messages-22"></a>Check every system call for an
error return, unless you know you wish to
ignore errors. Include the system error text (from <code>perror</code> or
equivalent) in <em>every</em> error message resulting from a failing
system call, as well as the name of the file if any and the name of the
utility. Just “cannot open foo.c” or “stat failed” is
not
sufficient.
- <p><a name="index-g_t_0040code_007bmalloc_007d-return-value-22"></a><a
name="index-memory-allocation-failure-23"></a>Check every call to
<code>malloc</code> or <code>realloc</code> to see if it
+ <p><a name="index-g_t_0040code_007bmalloc_007d-return-value-23"></a><a
name="index-memory-allocation-failure-24"></a>Check every call to
<code>malloc</code> or <code>realloc</code> to see if it
returned zero. Check <code>realloc</code> even if you are making the block
smaller; in a system that rounds block sizes to a power of 2,
<code>realloc</code> may get a different block if you ask for less space.
@@ -90,7 +90,7 @@
reader loop. This allows the user to kill other processes to free up
virtual memory, and then try the command again.
- <p><a name="index-command_002dline-arguments_002c-decoding-24"></a>Use
<code>getopt_long</code> to decode arguments, unless the argument syntax
+ <p><a name="index-command_002dline-arguments_002c-decoding-25"></a>Use
<code>getopt_long</code> to decode arguments, unless the argument syntax
makes this unreasonable.
<p>When static storage is to be written in during program execution, use
@@ -104,7 +104,7 @@
in a directory, use <code>readdir</code> or some other high-level interface.
These are supported compatibly by GNU.
- <p><a name="index-signal-handling-25"></a>The preferred signal handling
facilities are the BSD variant of
+ <p><a name="index-signal-handling-26"></a>The preferred signal handling
facilities are the BSD variant of
<code>signal</code>, and the <span class="sc">posix</span>
<code>sigaction</code> function; the
alternative USG <code>signal</code> interface is an inferior design.
@@ -115,7 +115,7 @@
behavior. It is up to you whether to support systems where
<code>signal</code> has only the USG behavior, or give up on them.
- <p><a name="index-impossible-conditions-26"></a>In error checks that detect
“impossible” conditions, just abort.
+ <p><a name="index-impossible-conditions-27"></a>In error checks that detect
“impossible” conditions, just abort.
There is usually no point in printing any message. These checks
indicate the existence of bugs. Whoever wants to fix the bugs will have
to read the source code and run a debugger. So explain the problem with
@@ -129,7 +129,7 @@
errors; if you try to return 256 as the exit status, the parent process
will see 0 as the status, and it will appear that the program succeeded.
- <p><a name="index-temporary-files-27"></a><a
name="index-g_t_0040code_007bTMPDIR_007d-environment-variable-28"></a>If you
make temporary files, check the <code>TMPDIR</code> environment
+ <p><a name="index-temporary-files-28"></a><a
name="index-g_t_0040code_007bTMPDIR_007d-environment-variable-29"></a>If you
make temporary files, check the <code>TMPDIR</code> environment
variable; if that variable is defined, use the specified directory
instead of <samp><span class="file">/tmp</span></samp>.
Index: html_node/Simple-Changes.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Simple-Changes.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Simple-Changes.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Simple-Changes.html 5 May 2008 17:25:49 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Conditional-Changes.html#Conditional-Changes"
title="Conditional Changes">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Source-Language.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Source-Language.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Source-Language.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Source-Language.html 5 May 2008 17:25:49 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Compatibility.html#Compatibility" title="Compatibility">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -80,12 +80,14 @@
is written in that language, too. The Emacs editor pioneered this
technique.
- <p><a name="index-GUILE-11"></a>The standard extensibility interpreter for
GNU software is GUILE
+ <p><a name="index-Guile-11"></a><a name="index-GNOME-and-Guile-12"></a>The
standard extensibility interpreter for GNU software is Guile
(<a
href="http://www.gnu.org/software/guile/">http://www.gnu.org/software/guile/</a>),
which implements the
-language Scheme (an especially clean and simple dialect of Lisp). We
-don't reject programs written in other “scripting languages” such
as
-Perl and Python, but using GUILE is very important for the overall
-consistency of the GNU system.
+language Scheme (an especially clean and simple dialect of Lisp).
+Guile also includes bindings for GTK+/GNOME, making it practical to
+write modern GUI functionality within Guile. We don't reject programs
+written in other “scripting languages” such as Perl and Python, but
+using Guile is very important for the overall consistency of the GNU
+system.
</body></html>
Index: html_node/Standard-C.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Standard-C.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Standard-C.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Standard-C.html 5 May 2008 17:25:49 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Conditional-Compilation.html#Conditional-Compilation"
title="Conditional Compilation">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">3.4 Standard C and Pre-Standard C</h3>
-<p><a name="index-g_t_0040sc_007bansi_007d-C-standard-17"></a>
+<p><a name="index-g_t_0040sc_007bansi_007d-C-standard-18"></a>
1989 Standard C is widespread enough now that it is ok to use its
features in new programs. There is one exception: do not ever use the
“trigraph” feature of Standard C.
@@ -60,7 +60,7 @@
so if you know how to do that, feel free. If a program you are
maintaining has such support, you should try to keep it working.
- <p><a name="index-function-prototypes-18"></a>To support pre-standard C,
instead of writing function definitions in
+ <p><a name="index-function-prototypes-19"></a>To support pre-standard C,
instead of writing function definitions in
standard prototype form,
<pre class="example"> int
Index: html_node/Standard-Targets.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Standard-Targets.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Standard-Targets.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Standard-Targets.html 5 May 2008 17:25:49 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next"
href="Install-Command-Categories.html#Install-Command-Categories"
title="Install Command Categories">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Style-of-Change-Logs.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Style-of-Change-Logs.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Style-of-Change-Logs.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/Style-of-Change-Logs.html 5 May 2008 17:25:49 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Simple-Changes.html#Simple-Changes" title="Simple
Changes">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h4 class="subsection">6.8.2 Style of Change Logs</h4>
-<p><a name="index-change-logs_002c-style-105"></a>
+<p><a name="index-change-logs_002c-style-106"></a>
Here are some simple examples of change log entries, starting with the
header line that says who made the change and when it was installed,
followed by descriptions of specific changes. (These examples are
Index: html_node/Syntactic-Conventions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Syntactic-Conventions.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Syntactic-Conventions.html 25 Apr 2008 18:41:49 -0000
1.25
+++ html_node/Syntactic-Conventions.html 5 May 2008 17:25:50 -0000
1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Names.html#Names" title="Names">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,13 +48,13 @@
<h3 class="section">5.3 Clean Use of C Constructs</h3>
-<p><a name="index-syntactic-conventions-66"></a>
-<a name="index-implicit-_0040code_007bint_007d-67"></a><a
name="index-function-argument_002c-declaring-68"></a>Please explicitly declare
the types of all objects. For example, you
+<p><a name="index-syntactic-conventions-67"></a>
+<a name="index-implicit-_0040code_007bint_007d-68"></a><a
name="index-function-argument_002c-declaring-69"></a>Please explicitly declare
the types of all objects. For example, you
should explicitly declare all arguments to functions, and you should
declare functions to return <code>int</code> rather than omitting the
<code>int</code>.
- <p><a name="index-compiler-warnings-69"></a><a
name="index-g_t_0040samp_007b_002dWall_007d-compiler-option-70"></a>Some
programmers like to use the GCC ‘<samp><span
class="samp">-Wall</span></samp>’ option, and change the
+ <p><a name="index-compiler-warnings-70"></a><a
name="index-g_t_0040samp_007b_002dWall_007d-compiler-option-71"></a>Some
programmers like to use the GCC ‘<samp><span
class="samp">-Wall</span></samp>’ option, and change the
code whenever it issues a warning. If you want to do this, then do.
Other programmers prefer not to use ‘<samp><span
class="samp">-Wall</span></samp>’, because it gives
warnings for valid and legitimate code which they do not want to change.
@@ -67,7 +67,7 @@
should go in a header file. Don't put <code>extern</code> declarations inside
functions.
- <p><a name="index-temporary-variables-71"></a>It used to be common practice
to use the same local variables (with
+ <p><a name="index-temporary-variables-72"></a>It used to be common practice
to use the same local variables (with
names like <code>tem</code>) over and over for different values within one
function. Instead of doing this, it is better to declare a separate local
variable for each distinct purpose, and give it a name which is
@@ -78,7 +78,7 @@
<p>Don't use local variables or parameters that shadow global identifiers.
- <p><a name="index-multiple-variables-in-a-line-72"></a>Don't declare
multiple variables in one declaration that spans lines.
+ <p><a name="index-multiple-variables-in-a-line-73"></a>Don't declare
multiple variables in one declaration that spans lines.
Start a new declaration on each line, instead. For example, instead
of this:
@@ -153,7 +153,7 @@
if (foo == 0)
fatal ("virtual memory exhausted");
</pre>
- <p><a name="index-lint-73"></a>Don't make the program ugly to placate
<code>lint</code>. Please don't insert any
+ <p><a name="index-lint-74"></a>Don't make the program ugly to placate
<code>lint</code>. Please don't insert any
casts to <code>void</code>. Zero without a cast is perfectly fine as a null
pointer constant, except when calling a varargs function.
Index: html_node/System-Functions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/System-Functions.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/System-Functions.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/System-Functions.html 5 May 2008 17:25:50 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Internationalization.html#Internationalization"
title="Internationalization">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.7 Calling System Functions</h3>
-<p><a name="index-library-functions_002c-and-portability-83"></a><a
name="index-portability_002c-and-library-functions-84"></a>
+<p><a name="index-library-functions_002c-and-portability-84"></a><a
name="index-portability_002c-and-library-functions-85"></a>
C implementations differ substantially. Standard C reduces but does
not eliminate the incompatibilities; meanwhile, many GNU packages still
support pre-standard compilers because this is not hard to do. This
@@ -65,7 +65,7 @@
terminate either by calling <code>exit</code> or by returning the integer
status code; make sure it cannot ever return an undefined value.
- <p><a name="index-declaration-for-system-functions-85"></a><li>Don't
declare system functions explicitly.
+ <p><a name="index-declaration-for-system-functions-86"></a><li>Don't
declare system functions explicitly.
<p>Almost any declaration for a system function is wrong on some system.
To minimize conflicts, leave it to the system header files to declare
@@ -100,7 +100,7 @@
<code>realloc</code>—or put these declarations in configuration files
specific to those systems.
- <p><a name="index-string-library-functions-86"></a><li>The string
functions require special treatment. Some Unix systems have
+ <p><a name="index-string-library-functions-87"></a><li>The string
functions require special treatment. Some Unix systems have
a header file <samp><span class="file">string.h</span></samp>; others have
<samp><span class="file">strings.h</span></samp>. Neither
file name is portable. There are two things you can do: use Autoconf to
figure out which file to include, or don't include either file.
Index: html_node/System-Portability.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/System-Portability.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/System-Portability.html 25 Apr 2008 18:41:49 -0000 1.25
+++ html_node/System-Portability.html 5 May 2008 17:25:50 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="CPU-Portability.html#CPU-Portability" title="CPU
Portability">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">5.5 Portability between System Types</h3>
-<p><a name="index-portability_002c-between-system-types-77"></a>
+<p><a name="index-portability_002c-between-system-types-78"></a>
In the Unix world, “portability” refers to porting to different
Unix
versions. For a GNU program, this kind of portability is desirable, but
not paramount.
@@ -66,7 +66,7 @@
But you don't have to consider it an obligation, if it does turn out to
be hard.
- <p><a name="index-autoconf-78"></a>The easiest way to achieve portability
to most Unix-like systems is to
+ <p><a name="index-autoconf-79"></a>The easiest way to achieve portability
to most Unix-like systems is to
use Autoconf. It's unlikely that your program needs to know more
information about the host platform than Autoconf can provide, simply
because most of the programs that need such knowledge have already been
@@ -75,7 +75,7 @@
<p>Avoid using the format of semi-internal data bases (e.g., directories)
when there is a higher-level alternative (<code>readdir</code>).
- <p><a
name="index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-79"></a>As
for systems that are not like Unix, such as MSDOS, Windows, VMS, MVS,
+ <p><a
name="index-non_002d_0040sc_007bposix_007d-systems_002c-and-portability-80"></a>As
for systems that are not like Unix, such as MSDOS, Windows, VMS, MVS,
and older Macintosh systems, supporting them is often a lot of work.
When that is the case, it is better to spend your time adding features
that will be useful on GNU and GNU/Linux, rather than on supporting
Index: html_node/Trademarks.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Trademarks.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Trademarks.html 25 Apr 2008 18:41:50 -0000 1.25
+++ html_node/Trademarks.html 5 May 2008 17:25:50 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="prev" href="Contributions.html#Contributions" title="Contributions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/User-Interfaces.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/User-Interfaces.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/User-Interfaces.html 25 Apr 2008 18:41:50 -0000 1.25
+++ html_node/User-Interfaces.html 5 May 2008 17:25:50 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Graphical-Interfaces.html#Graphical-Interfaces"
title="Graphical Interfaces">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,14 +48,14 @@
<h3 class="section">4.5 Standards for Interfaces Generally</h3>
-<p><a name="index-program-name-and-its-behavior-32"></a><a
name="index-behavior_002c-dependent-on-program_0027s-name-33"></a>Please don't
make the behavior of a utility depend on the name used
+<p><a name="index-program-name-and-its-behavior-33"></a><a
name="index-behavior_002c-dependent-on-program_0027s-name-34"></a>Please don't
make the behavior of a utility depend on the name used
to invoke it. It is useful sometimes to make a link to a utility
with a different name, and that should not change what it does.
<p>Instead, use a run time option or a compilation switch or both
to select among the alternate behaviors.
- <p><a
name="index-output-device-and-program_0027s-behavior-34"></a>Likewise, please
don't make the behavior of the program depend on the
+ <p><a
name="index-output-device-and-program_0027s-behavior-35"></a>Likewise, please
don't make the behavior of the program depend on the
type of output device it is used with. Device independence is an
important principle of the system's design; do not compromise it merely
to save someone from typing an option now and then. (Variation in error
Index: html_node/Using-Extensions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Using-Extensions.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Using-Extensions.html 25 Apr 2008 18:41:50 -0000 1.25
+++ html_node/Using-Extensions.html 5 May 2008 17:25:50 -0000 1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Standard-C.html#Standard-C" title="Standard C">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -48,7 +48,7 @@
<h3 class="section">3.3 Using Non-standard Features</h3>
-<p><a name="index-non_002dstandard-extensions-16"></a>
+<p><a name="index-non_002dstandard-extensions-17"></a>
Many GNU facilities that already exist support a number of convenient
extensions over the comparable Unix facilities. Whether to use these
extensions in implementing your program is a difficult question.
Index: html_node/Utilities-in-Makefiles.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Utilities-in-Makefiles.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Utilities-in-Makefiles.html 25 Apr 2008 18:41:50 -0000
1.25
+++ html_node/Utilities-in-Makefiles.html 5 May 2008 17:25:50 -0000
1.26
@@ -10,7 +10,7 @@
<link rel="next" href="Command-Variables.html#Command-Variables"
title="Command Variables">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/Writing-C.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Writing-C.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/Writing-C.html 25 Apr 2008 18:41:50 -0000 1.25
+++ html_node/Writing-C.html 5 May 2008 17:25:50 -0000 1.26
@@ -9,7 +9,7 @@
<link rel="next" href="Documentation.html#Documentation" title="Documentation">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Index: html_node/_002d_002dhelp.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/_002d_002dhelp.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -b -r1.9 -r1.10
--- html_node/_002d_002dhelp.html 25 Apr 2008 18:41:50 -0000 1.9
+++ html_node/_002d_002dhelp.html 5 May 2008 17:25:50 -0000 1.10
@@ -9,7 +9,7 @@
<link rel="prev" href="_002d_002dversion.html#g_t_002d_002dversion"
title="--version">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -47,13 +47,13 @@
<h4 class="subsection">4.7.2 <samp><span
class="option">--help</span></samp></h4>
-<p><a name="index-g_t_0040samp_007b_002d_002dhelp_007d-output-49"></a>
+<p><a name="index-g_t_0040samp_007b_002d_002dhelp_007d-output-50"></a>
The standard <code>--help</code> option should output brief documentation
for how to invoke the program, on standard output, then exit
successfully. Other options and arguments should be ignored once this
is seen, and the program should not perform its normal function.
- <p><a name="index-address-for-bug-reports-50"></a><a
name="index-bug-reports-51"></a>Near the end of the ‘<samp><span
class="samp">--help</span></samp>’ option's output there should be a line
+ <p><a name="index-address-for-bug-reports-51"></a><a
name="index-bug-reports-52"></a>Near the end of the ‘<samp><span
class="samp">--help</span></samp>’ option's output there should be a line
that says where to mail bug reports. It should have this format:
<pre class="example"> Report bugs to <var>mailing-address</var>.
Index: html_node/_002d_002dversion.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/_002d_002dversion.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- html_node/_002d_002dversion.html 25 Apr 2008 18:41:50 -0000 1.10
+++ html_node/_002d_002dversion.html 5 May 2008 17:25:50 -0000 1.11
@@ -9,7 +9,7 @@
<link rel="next" href="_002d_002dhelp.html#g_t_002d_002dhelp" title="--help">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -47,14 +47,14 @@
<h4 class="subsection">4.7.1 <samp><span
class="option">--version</span></samp></h4>
-<p><a name="index-g_t_0040samp_007b_002d_002dversion_007d-output-46"></a>
+<p><a name="index-g_t_0040samp_007b_002d_002dversion_007d-output-47"></a>
The standard <code>--version</code> option should direct the program to
print information about its name, version, origin and legal status,
all on standard output, and then exit successfully. Other options and
arguments should be ignored once this is seen, and the program should
not perform its normal function.
- <p><a name="index-canonical-name-of-a-program-47"></a><a
name="index-program_0027s-canonical-name-48"></a>The first line is meant to be
easy for a program to parse; the version
+ <p><a name="index-canonical-name-of-a-program-48"></a><a
name="index-program_0027s-canonical-name-49"></a>The first line is meant to be
easy for a program to parse; the version
number proper starts after the last space. In addition, it contains
the canonical name for this program, in this format:
@@ -146,7 +146,7 @@
<br><dt>GPL/Guile<dd>GNU GPL with the exception for Guile; for example,
GPLv3+/Guile means
the GNU GPL version 3 or later, with the extra exception for Guile.
- <p>GNU GPL with the exception for Ada.
+ <br><dt>GPL/Ada<dd>GNU GPL with the exception for Ada.
<br><dt>Apache<dd>The Apache Software Foundation license,
<a href="http://www.apache.org/licenses">http://www.apache.org/licenses</a>.
Index: html_node/index.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/index.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- html_node/index.html 25 Apr 2008 18:41:50 -0000 1.25
+++ html_node/index.html 5 May 2008 17:25:50 -0000 1.26
@@ -7,7 +7,7 @@
<link title="Top" rel="start" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated February 23, 2008.
+The GNU coding standards, last updated May 5, 2008.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
@@ -139,7 +139,7 @@
<h2 class="unnumbered">Version</h2>
-<p>The GNU coding standards, last updated February 23, 2008.
+<p>The GNU coding standards, last updated May 5, 2008.
<p>Copyright © 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- www/prep/standards index.html standards.dvi.gz ...,
Karl Berry <=