[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: |
Sat, 19 Aug 2006 17:43:59 +0000 |
CVSROOT: /web/www
Module name: www
Changes by: Karl Berry <karl> 06/08/19 17:43:59
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
Copying-This-Manual.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 index.html
Log message:
plurals, configure var=value
CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/index.html?cvsroot=www&r1=1.15&r2=1.16
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.dvi.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.html?cvsroot=www&r1=1.14&r2=1.15
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.html.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.html_node.tar.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.info.tar.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.pdf?cvsroot=www&rev=1.15
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.ps.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.texi.tar.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.txt?cvsroot=www&r1=1.14&r2=1.15
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/standards.txt.gz?cvsroot=www&rev=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/CPU-Portability.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Change-Log-Concepts.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Change-Logs.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Character-Set.html?cvsroot=www&r1=1.4&r2=1.5
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Command-Variables.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Command_002dLine-Interfaces.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Comments.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Compatibility.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Conditional-Changes.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Conditional-Compilation.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Configuration.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Contributions.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Copying-This-Manual.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/DESTDIR.html?cvsroot=www&r1=1.1&r2=1.2
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Design-Advice.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Directory-Variables.html?cvsroot=www&r1=1.13&r2=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Doc-Strings-and-Manuals.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Documentation.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Errors.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/File-Usage.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Formatting.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/GNU-Free-Documentation-License.html?cvsroot=www&r1=1.13&r2=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/GNU-Manuals.html?cvsroot=www&r1=1.13&r2=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Graphical-Interfaces.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Index.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Indicating-the-Part-Changed.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Install-Command-Categories.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Internationalization.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Legal-Issues.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Libraries.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/License-for-Manuals.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Makefile-Basics.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Makefile-Conventions.html?cvsroot=www&r1=1.13&r2=1.14
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Man-Pages.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Managing-Releases.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Manual-Credits.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Manual-Structure-Details.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Memory-Usage.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Mmap.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/NEWS-File.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Names.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Non_002dGNU-Standards.html?cvsroot=www&r1=1.2&r2=1.3
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Option-Table.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Preface.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Printed-Manuals.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Program-Behavior.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Quote-Characters.html?cvsroot=www&r1=1.4&r2=1.5
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Reading-Non_002dFree-Code.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Reading-other-Manuals.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/References.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Releases.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Semantics.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Simple-Changes.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Source-Language.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Standard-C.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Standard-Targets.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Style-of-Change-Logs.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Syntactic-Conventions.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/System-Functions.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/System-Portability.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Trademarks.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/User-Interfaces.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Using-Extensions.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Utilities-in-Makefiles.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/Writing-C.html?cvsroot=www&r1=1.12&r2=1.13
http://web.cvs.savannah.gnu.org/viewcvs/www/prep/standards/html_node/index.html?cvsroot=www&r1=1.12&r2=1.13
Patches:
Index: index.html
===================================================================
RCS file: /web/www/www/prep/standards/index.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -b -r1.15 -r1.16
--- index.html 8 May 2006 13:25:01 -0000 1.15
+++ index.html 19 Aug 2006 17:43:54 -0000 1.16
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<!-- $Id: index.html,v 1.15 2006/05/08 13:25:01 karl Exp $ -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
@@ -22,7 +21,7 @@
<h3>GNU coding standards</h3>
<address>Free Software Foundation</address>
-<address>last updated May 08, 2006</address>
+<address>last updated August 19, 2006</address>
<p>
<a href="/graphics/gnu-head.jpg">
<img src="/graphics/gnu-head-sm.jpg"
@@ -37,7 +36,7 @@
<ul>
<li><a href="standards.html">HTML
- (312K characters)</a> - entirely on one web page.</li>
+ (316K characters)</a> - entirely on one web page.</li>
<li><a href="html_node/index.html">HTML</a> - with one web page per
node.</li>
<li><a href="standards.html.gz">HTML compressed
@@ -55,14 +54,14 @@
<li><a href="standards.dvi.gz">TeX dvi file
(108K characters gzipped)</a>.</li>
<li><a href="standards.ps.gz">PostScript file
- (236K characters gzipped)</a>.</li>
+ (240K characters gzipped)</a>.</li>
<li><a href="standards.pdf">PDF file
- (424K characters)</a>.</li>
+ (428K characters)</a>.</li>
<li><a href="standards.texi.tar.gz">Texinfo source
- (68K characters gzipped tar file)</a></li>
+ (72K characters gzipped tar file)</a></li>
</ul>
-<p>(This page generated by the <a
href="http://savannah.gnu.org/cgi-bin/viewcvs/texinfo/texinfo/util/gendocs.sh">gendocs.sh
+<p>(This page generated by the <a
href="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs.sh">gendocs.sh
script</a>.)</p>
<div class="copyright">
@@ -81,19 +80,13 @@
</p>
<p>
-Copyright (C) 2004 Free Software Foundation, Inc.,
+Copyright (C) 2006 Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02111, USA
<br />
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.
</p>
-<p>
-Updated:
-<!-- timestamp start -->
-$Date: 2006/05/08 13:25:01 $ $Author: karl $
-<!-- timestamp end -->
-</p>
</div>
</body>
Index: standards.dvi.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.dvi.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvsnARnh2 and /tmp/cvsDjzBlP differ
Index: standards.html
===================================================================
RCS file: /web/www/www/prep/standards/standards.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- standards.html 8 May 2006 13:25:01 -0000 1.14
+++ standards.html 19 Aug 2006 17:43:54 -0000 1.15
@@ -3,17 +3,17 @@
<title>GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -140,13 +140,13 @@
<h2 class="unnumbered">Version</h2>
-<p>The GNU coding standards, last updated April 23, 2006.
+<p>The GNU coding standards, last updated August 19, 2006.
<p>Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
<p>Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -187,7 +187,7 @@
state reasons for writing in a certain way.
<p>This release of the GNU Coding Standards was last updated
-April 23, 2006.
+August 19, 2006.
<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
@@ -1055,7 +1055,7 @@
(preferably ‘<samp><span class="samp">-o</span></samp>’ or
‘<samp><span class="samp">--output</span></samp>’). Even if you
allow an output
file name as an ordinary argument for compatibility, try to provide an
option as another way to specify it. This will lead to more consistency
-among GNU utilities, and fewer idiosyncracies for users to remember.
+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>’
and ‘<samp><span class="samp">--help</span></samp>’. CGI programs
should accept these as command-line
@@ -1798,7 +1798,7 @@
<br><dt>‘<samp><span
class="samp">socket</span></samp>’<dd>Specify a file descriptor for a
network server to use for its socket,
instead of opening and binding a new socket. This provides a way to
-run, in a nonpriveledged process, a server that normally needs a
+run, in a non-privileged process, a server that normally needs a
reserved port number.
<br><dt>‘<samp><span class="samp">sort</span></samp>’<dd>Used
in <code>ls</code>.
@@ -2714,7 +2714,7 @@
name</dfn> for the package. The text domain name is used to separate the
translations for this package from the translations for other packages.
Normally, the text domain name should be the same as the name of the
-package—for example, ‘<samp><span
class="samp">fileutils</span></samp>’ for the GNU file utilities.
+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
assumptions about the structure of words or sentences. When you want
@@ -2725,33 +2725,24 @@
<p>Here is an example of what not to do:
-<pre class="example"> printf ("%d file%s processed", nfiles,
- nfiles != 1 ? "s" : "");
+<pre class="smallexample"> printf ("%s is full", capacity > 5000000 ?
"disk" : "floppy disk");
</pre>
- <p class="noindent">The problem with that example is that it assumes that
plurals are made
-by adding `s'. If you apply gettext to the format string, like this,
+ <p>If you apply gettext to all strings, like this,
-<pre class="example"> printf (gettext ("%d file%s processed"), nfiles,
- nfiles != 1 ? "s" : "");
+<pre class="smallexample"> printf (gettext ("%s is full"),
+ capacity > 5000000 ? gettext ("disk") : gettext ("floppy
disk"));
</pre>
- <p class="noindent">the message can use different words, but it will still
be forced to use
-`s' for the plural. Here is a better way:
+ <p class="noindent">the translator will hardly know that "disk" and "floppy
disk" are meant to
+be substituted in the other string. Worse, in some languages (like French)
+the construction will not work: the translation of the word "full" depends
+on the gender of the first part of the sentence; it happens to be not the
+same for "disk" as for "floppy disk".
-<pre class="example"> printf ((nfiles != 1 ? "%d files processed"
- : "%d file processed"),
- nfiles);
-</pre>
- <p class="noindent">This way, you can apply gettext to each of the two
strings
-independently:
+ <p>Complete sentences can be translated without problems:
-<pre class="example"> printf ((nfiles != 1 ? gettext ("%d files processed")
- : gettext ("%d file processed")),
- nfiles);
+<pre class="example"> printf (capacity > 5000000 ? gettext ("disk is
full")
+ : gettext ("floppy disk is full"));
</pre>
- <p class="noindent">This can be any method of forming the plural of the
word for “file”, and
-also handles languages that require agreement in the word for
-“processed”.
-
<p>A similar problem appears at the level of sentence structure with this
code:
@@ -2761,13 +2752,39 @@
<p class="noindent">Adding <code>gettext</code> calls to this code cannot
give correct results for
all languages, because negation in some languages requires adding words
at more than one place in the sentence. By contrast, adding
-<code>gettext</code> calls does the job straightfowardly if the code starts
+<code>gettext</code> calls does the job straightforwardly if the code starts
out like this:
<pre class="example"> printf (f->tried_implicit
? "# Implicit rule search has been done.\n",
: "# Implicit rule search has not been done.\n");
</pre>
+ <p>Another example is this one:
+
+<pre class="example"> printf ("%d file%s processed", nfiles,
+ nfiles != 1 ? "s" : "");
+</pre>
+ <p class="noindent">The problem with this example is that it assumes that
plurals are made
+by adding `s'. If you apply gettext to the format string, like this,
+
+<pre class="example"> printf (gettext ("%d file%s processed"), nfiles,
+ nfiles != 1 ? "s" : "");
+</pre>
+ <p class="noindent">the message can use different words, but it will still
be forced to use
+`s' for the plural. Here is a better way, with gettext being applied to
+the two strings independently:
+
+<pre class="example"> printf ((nfiles != 1 ? gettext ("%d files processed")
+ : gettext ("%d file processed")),
+ nfiles);
+</pre>
+ <p class="noindent">But this still doesn't work for languages like Polish,
which has three
+plural forms: one for nfiles == 1, one for nfiles == 2, 3, 4, 22, 23, 24, ...
+and one for the rest. The GNU <code>ngettext</code> function solves this
problem:
+
+<pre class="example"> printf (ngettext ("%d files processed", "%d file
processed", nfiles),
+ nfiles);
+</pre>
<div class="node">
<p><hr>
<a name="Character-Set"></a>
@@ -3031,7 +3048,7 @@
variables. The previous descriptions of functions and variables in the
section will also have given information about the topic. A description
written to stand alone would repeat some of that information; this
-redundance looks bad. Meanwhile, the informality that is acceptable in
+redundancy looks bad. Meanwhile, the informality that is acceptable in
a documentation string is totally unacceptable in a manual.
<p>The only good way to use documentation strings in writing a good manual
@@ -3602,8 +3619,8 @@
<a
href="http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/config/config/config.guess"><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
-or hardware present on the machine, and include or exclude optional
-parts of the package:
+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:
<dl>
<dt>‘<samp><span class="samp">--enable-</span><var>feature</var><span
class="samp">[=</span><var>parameter</var><span
class="samp">]</span></samp>’<dd>Configure the package to build and
install an optional user-level
@@ -3633,14 +3650,29 @@
<p>Do not use a ‘<samp><span
class="samp">--with</span></samp>’ option to specify the file name to use
to
find certain files. That is outside the scope of what ‘<samp><span
class="samp">--with</span></samp>’
options are for.
+
+ <br><dt>‘<samp><var>variable</var><span
class="samp">=</span><var>value</var></samp>’<dd>Set the value of the
variable <var>variable</var> to <var>value</var>. This is
+used to override the default values of commands or arguments in the
+build process. For example, the user could issue ‘<samp><span
class="samp">configure
+CFLAGS=-g CXXFLAGS=-g</span></samp>’ to build with debugging information
and without
+the default optimization.
+
+ <p>Specifying variables as arguments to <code>configure</code>, like this:
+ <pre class="example"> ./configure CC=gcc
+</pre>
+ <p>is preferable to setting them in environment variables:
+ <pre class="example"> CC=gcc ./configure
+</pre>
+ <p>as it helps to recreate the same configuration later with
+<samp><span class="file">config.status</span></samp>.
</dl>
- <p>All <code>configure</code> scripts should accept all of these
“detail”
-options, whether or not they make any difference to the particular
-package at hand. In particular, they should accept any option that
-starts with ‘<samp><span class="samp">--with-</span></samp>’ or
‘<samp><span class="samp">--enable-</span></samp>’. This is so
users will
-be able to configure an entire GNU source tree at once with a single set
-of options.
+ <p>All <code>configure</code> scripts should accept all of the
“detail”
+options and the variable settings, whether or not they make any
+difference to the particular package at hand. In particular, they
+should accept any option that starts with ‘<samp><span
class="samp">--with-</span></samp>’ or
+‘<samp><span class="samp">--enable-</span></samp>’. This is so
users will be able to configure an
+entire GNU source tree at once with a single set of options.
<p>You will note that the categories ‘<samp><span
class="samp">--with-</span></samp>’ and ‘<samp><span
class="samp">--enable-</span></samp>’
are narrow: they <strong>do not</strong> provide a place for any sort of option
@@ -3700,7 +3732,7 @@
<!-- 2004, 2005, 2006 Free Software Foundation, Inc. -->
<!-- Permission is granted to copy, distribute and/or modify this document -->
-<!-- under the terms of the GNU Free Documentation License, Version 1.1 -->
+<!-- under the terms of the GNU Free Documentation License, Version 1.2 -->
<!-- or any later version published by the Free Software Foundation; -->
<!-- with no Invariant Sections, with no -->
<!-- Front-Cover Texts, and with no Back-Cover Texts. -->
@@ -3715,8 +3747,8 @@
<li><a accesskey="1" href="#Makefile-Basics">Makefile Basics</a>:
General conventions for Makefiles.
<li><a accesskey="2" href="#Utilities-in-Makefiles">Utilities in
Makefiles</a>: Utilities to be used in Makefiles.
<li><a accesskey="3" href="#Command-Variables">Command Variables</a>:
Variables for specifying commands.
-<li><a accesskey="4" href="#Directory-Variables">Directory Variables</a>:
Variables for installation directories.
-<li><a accesskey="5" href="#DESTDIR">DESTDIR</a>:
Supporting staged installs.
+<li><a accesskey="4" href="#DESTDIR">DESTDIR</a>:
Supporting staged installs.
+<li><a accesskey="5" href="#Directory-Variables">Directory Variables</a>:
Variables for installation directories.
<li><a accesskey="6" href="#Standard-Targets">Standard Targets</a>:
Standard targets for users.
<li><a accesskey="7" href="#Install-Command-Categories">Install Command
Categories</a>: Three categories of commands in the `install'
rule: normal, pre-install and post-install.
@@ -3873,7 +3905,7 @@
<div class="node">
<p><hr>
<a name="Command-Variables"></a>
-Next: <a rel="next" accesskey="n" href="#Directory-Variables">Directory
Variables</a>,
+Next: <a rel="next" accesskey="n" href="#DESTDIR">DESTDIR</a>,
Previous: <a rel="previous" accesskey="p"
href="#Utilities-in-Makefiles">Utilities in Makefiles</a>,
Up: <a rel="up" accesskey="u" href="#Makefile-Conventions">Makefile
Conventions</a>
@@ -3935,7 +3967,7 @@
and <code>INSTALL_DATA</code>. (The default for <code>INSTALL_PROGRAM</code>
should
be <code>$(INSTALL)</code>; the default for <code>INSTALL_DATA</code> should be
<code>${INSTALL} -m 644</code>.) Then it should use those variables as the
-commands for actual installation, for executables and nonexecutables
+commands for actual installation, for executables and non-executables
respectively. Minimal use of these variables is as follows:
<pre class="example"> $(INSTALL_PROGRAM) foo $(bindir)/foo
@@ -3951,8 +3983,8 @@
<div class="node">
<p><hr>
<a name="DESTDIR"></a>
-Next: <a rel="next" accesskey="n" href="#Standard-Targets">Standard
Targets</a>,
-Previous: <a rel="previous" accesskey="p"
href="#Directory-Variables">Directory Variables</a>,
+Next: <a rel="next" accesskey="n" href="#Directory-Variables">Directory
Variables</a>,
+Previous: <a rel="previous" accesskey="p"
href="#Command-Variables">Command Variables</a>,
Up: <a rel="up" accesskey="u" href="#Makefile-Conventions">Makefile
Conventions</a>
</div>
@@ -3966,14 +3998,14 @@
<pre class="example"> $(INSTALL_PROGRAM) foo $(DESTDIR)$(bindir)/foo
$(INSTALL_DATA) libfoo.a $(DESTDIR)$(libdir)/libfoo.a
</pre>
- <p>The <code>DESTDIR</code> variable is specified by the user, either to the
-<samp><span class="file">configure</span></samp> script or, more commonly, on
the <code>make</code> command
-line. For example:
+ <p>The <code>DESTDIR</code> variable is specified by the user on the
<code>make</code>
+command line. For example:
<pre class="example"> make DESTDIR=/tmp/stage install
</pre>
- <p class="noindent">(Since the value of <code>DESTDIR</code> is only used
during installation it
-is not necessary to provide it with other <code>make</code> commands.)
+ <p class="noindent"><code>DESTDIR</code> should be supported only in the
<code>install*</code> and
+<code>uninstall*</code> targets, as those are the only targets where it is
+useful.
<p>If your installation step would normally install
<samp><span class="file">/usr/local/bin/foo</span></samp> and <samp><span
class="file">/usr/local/lib/libfoo.a</span></samp>, then an
@@ -4001,14 +4033,14 @@
those permissions. Finally, it can be useful with tools such as
<code>stow</code>, where code is installed in one place but made to appear
to be installed somewhere else using symbolic links or special mount
-operations. So, we recommend GNU packages support <code>DESTDIR</code>,
-though it is not an absolute requirement.
+operations. So, we strongly recommend GNU packages support
+<code>DESTDIR</code>, though it is not an absolute requirement.
<div class="node">
<p><hr>
<a name="Directory-Variables"></a>
-Next: <a rel="next" accesskey="n" href="#DESTDIR">DESTDIR</a>,
-Previous: <a rel="previous" accesskey="p"
href="#Command-Variables">Command Variables</a>,
+Next: <a rel="next" accesskey="n" href="#Standard-Targets">Standard
Targets</a>,
+Previous: <a rel="previous" accesskey="p" href="#DESTDIR">DESTDIR</a>,
Up: <a rel="up" accesskey="u" href="#Makefile-Conventions">Makefile
Conventions</a>
</div>
@@ -4213,8 +4245,7 @@
<code>docdir</code> for compatibility with existing practice.
<br><dt>‘<samp><span
class="samp">htmldir</span></samp>’<dt>‘<samp><span
class="samp">dvidir</span></samp>’<dt>‘<samp><span
class="samp">pdfdir</span></samp>’<dt>‘<samp><span
class="samp">psdir</span></samp>’<dd>Directories for installing
documentation files in the particular
-format. (It is not required to support documentation in all these
-formats.) They should all be set to <code>$(docdir)</code> by default. (If
+format. They should all be set to <code>$(docdir)</code> by default. (If
you are using Autoconf, write them as ‘<samp><span
class="samp">@htmldir@</span></samp>’,
‘<samp><span class="samp">@dvidir@</span></samp>’, etc.) Packages
which supply several translations
of their documentation should install them in
@@ -4277,7 +4308,7 @@
<dl>
<dt>‘<samp><span class="samp">srcdir</span></samp>’<dd>The
directory for the sources being compiled. The value of this
variable is normally inserted by the <code>configure</code> shell script.
-(If you are using Autconf, use ‘<samp><span class="samp">srcdir =
@srcdir@</span></samp>’.)
+(If you are using Autoconf, use ‘<samp><span class="samp">srcdir =
@srcdir@</span></samp>’.)
</dl>
<p>For example:
@@ -4309,19 +4340,19 @@
order for this to be useful, all the packages must be designed so that
they will work sensibly when the user does so.
- <p>Not all of these variables may be implemented in the current release
-of Autoconf and/or Automake; right now, that includes at least
-<code>docdir</code>, <code>psdir</code>, <code>pdfdir</code>,
<code>htmldir</code>,
-<code>dvidir</code>. In these cases, the descriptions here serve as
-specifications for what Autoconf will implement. As a programmer, you
-can either use a development version of Autoconf or avoid using these
-variables until a stable release is made which supports them.
+ <p>At times, not all of these variables may be implemented in the current
+release of Autoconf and/or Automake; but as of Autoconf 2.60, we
+believe all of them are. When any are missing, the descriptions here
+serve as specifications for what Autoconf will implement. As a
+programmer, you can either use a development version of Autoconf or
+avoid using these variables until a stable release is made which
+supports them.
<div class="node">
<p><hr>
<a name="Standard-Targets"></a>
Next: <a rel="next" accesskey="n"
href="#Install-Command-Categories">Install Command Categories</a>,
-Previous: <a rel="previous" accesskey="p" href="#DESTDIR">DESTDIR</a>,
+Previous: <a rel="previous" accesskey="p"
href="#Directory-Variables">Directory Variables</a>,
Up: <a rel="up" accesskey="u" href="#Makefile-Conventions">Makefile
Conventions</a>
</div>
@@ -4333,8 +4364,9 @@
<dl>
<dt>‘<samp><span class="samp">all</span></samp>’<dd>Compile the
entire program. This should be the default target. This
target need not rebuild any documentation files; Info files should
-normally be included in the distribution, and DVI files should be made
-only when explicitly asked for.
+normally be included in the distribution, and DVI (and other
+documentation format) files should be made only when explicitly asked
+for.
<p>By default, the Make rules should compile and link with
‘<samp><span class="samp">-g</span></samp>’, so
that executable programs have debugging symbols. Users who don't mind
@@ -4372,7 +4404,7 @@
Here is a sample rule to install an Info file:
<!-- This example has been carefully formatted for the Make manual. -->
-<!-- Please do not reformat it without talking to address@hidden -->
+<!-- Please do not reformat it without talking to address@hidden -->
<pre class="smallexample"> $(DESTDIR)$(infodir)/foo.info: foo.info
$(POST_INSTALL)
# There may be a newer info file in . than in srcdir.
@@ -4408,6 +4440,10 @@
certainly want to use subdirectories, or two nodes with the same name
in different manuals will overwrite each other.
+ <p>Please make these <code>install-</code><var>format</var> targets
invoke the
+commands for the <var>format</var> target, for example, by making
+<var>format</var> a dependency.
+
<br><dt>‘<samp><span
class="samp">uninstall</span></samp>’<dd>Delete all the installed
files—the copies that the ‘<samp><span
class="samp">install</span></samp>’
and ‘<samp><span class="samp">install-*</span></samp>’ targets
create.
@@ -4514,8 +4550,12 @@
users build the package, ordinarily Make will not update the Info files
because they will already be up to date.
- <br><dt>‘<samp><span
class="samp">dvi</span></samp>’<dt>‘<samp><span
class="samp">html</span></samp>’<dt>‘<samp><span
class="samp">pdf</span></samp>’<dt>‘<samp><span
class="samp">ps</span></samp>’<dd>Generate documentation files in the
given format, if possible.
-Here's an example rule for generating DVI files from Texinfo:
+ <br><dt>‘<samp><span
class="samp">dvi</span></samp>’<dt>‘<samp><span
class="samp">html</span></samp>’<dt>‘<samp><span
class="samp">pdf</span></samp>’<dt>‘<samp><span
class="samp">ps</span></samp>’<dd>Generate documentation files in the
given format. These targets
+should always exist, but any or all can be a no-op if the given output
+format cannot be generated. These targets should not be dependencies
+of the <code>all</code> target; the user must manually invoke them.
+
+ <p>Here's an example rule for generating DVI files from Texinfo:
<pre class="smallexample"> dvi: foo.dvi
@@ -5471,7 +5511,7 @@
<a name="texinfo-footnotes-in-document"></a><h4>Footnotes</h4><p
class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small>
<code>texi2dvi</code> uses TeX to do the real work
of formatting. TeX is not distributed with Texinfo.</p>
- <p><hr></div>
+ <hr></div>
</body></html>
Index: standards.html.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.html.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvsDS0ld8 and /tmp/cvsJMnIqV differ
Index: standards.html_node.tar.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.html_node.tar.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvssl5u58 and /tmp/cvsXUDQkW differ
Index: standards.info.tar.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.info.tar.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvsRXwqq7 and /tmp/cvsvlxBHU differ
Index: standards.pdf
===================================================================
RCS file: /web/www/www/prep/standards/standards.pdf,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
Binary files /tmp/cvsgw3PAa and /tmp/cvsPYZSZX differ
Index: standards.ps.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.ps.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvstz4eHb and /tmp/cvsli6ibZ differ
Index: standards.texi.tar.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.texi.tar.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvsKurJJf and /tmp/cvsJlsZf3 differ
Index: standards.txt
===================================================================
RCS file: /web/www/www/prep/standards/standards.txt,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- standards.txt 8 May 2006 13:25:02 -0000 1.14
+++ standards.txt 19 Aug 2006 17:43:55 -0000 1.15
@@ -73,13 +73,13 @@
Version
*******
-The GNU coding standards, last updated April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
+under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU
@@ -96,7 +96,7 @@
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 April 23,
+ This release of the GNU Coding Standards was last updated August 19,
2006.
If you did not obtain this file directly from the GNU project and
@@ -771,7 +771,7 @@
options (preferably `-o' or `--output'). Even if you allow an output
file name as an ordinary argument for compatibility, try to provide an
option as another way to specify it. This will lead to more consistency
-among GNU utilities, and fewer idiosyncracies for users to remember.
+among GNU utilities, and fewer idiosyncrasies for users to remember.
All programs should support two standard options: `--version' and
`--help'. CGI programs should accept these as command-line options,
@@ -1775,7 +1775,7 @@
`socket'
Specify a file descriptor for a network server to use for its
socket, instead of opening and binding a new socket. This
- provides a way to run, in a nonpriveledged process, a server that
+ provides a way to run, in a non-privileged process, a server that
normally needs a reserved port number.
`sort'
@@ -2640,7 +2640,7 @@
name" for the package. The text domain name is used to separate the
translations for this package from the translations for other packages.
Normally, the text domain name should be the same as the name of the
-package--for example, `fileutils' for the GNU file utilities.
+package--for example, `coreutils' for the GNU core utilities.
To enable gettext to work well, avoid writing code that makes
assumptions about the structure of words or sentences. When you want
@@ -2651,32 +2651,23 @@
Here is an example of what not to do:
- printf ("%d file%s processed", nfiles,
- nfiles != 1 ? "s" : "");
+ printf ("%s is full", capacity > 5000000 ? "disk" : "floppy disk");
-The problem with that example is that it assumes that plurals are made
-by adding `s'. If you apply gettext to the format string, like this,
+ If you apply gettext to all strings, like this,
- printf (gettext ("%d file%s processed"), nfiles,
- nfiles != 1 ? "s" : "");
+ printf (gettext ("%s is full"),
+ capacity > 5000000 ? gettext ("disk") : gettext ("floppy disk"));
-the message can use different words, but it will still be forced to use
-`s' for the plural. Here is a better way:
+the translator will hardly know that "disk" and "floppy disk" are meant
+to be substituted in the other string. Worse, in some languages (like
+French) the construction will not work: the translation of the word
+"full" depends on the gender of the first part of the sentence; it
+happens to be not the same for "disk" as for "floppy disk".
- printf ((nfiles != 1 ? "%d files processed"
- : "%d file processed"),
- nfiles);
+ Complete sentences can be translated without problems:
-This way, you can apply gettext to each of the two strings
-independently:
-
- printf ((nfiles != 1 ? gettext ("%d files processed")
- : gettext ("%d file processed")),
- nfiles);
-
-This can be any method of forming the plural of the word for "file", and
-also handles languages that require agreement in the word for
-"processed".
+ printf (capacity > 5000000 ? gettext ("disk is full")
+ : gettext ("floppy disk is full"));
A similar problem appears at the level of sentence structure with
this code:
@@ -2687,12 +2678,39 @@
Adding `gettext' calls to this code cannot give correct results for all
languages, because negation in some languages requires adding words at
more than one place in the sentence. By contrast, adding `gettext'
-calls does the job straightfowardly if the code starts out like this:
+calls does the job straightforwardly if the code starts out like this:
printf (f->tried_implicit
? "# Implicit rule search has been done.\n",
: "# Implicit rule search has not been done.\n");
+ Another example is this one:
+
+ printf ("%d file%s processed", nfiles,
+ nfiles != 1 ? "s" : "");
+
+The problem with this example is that it assumes that plurals are made
+by adding `s'. If you apply gettext to the format string, like this,
+
+ printf (gettext ("%d file%s processed"), nfiles,
+ nfiles != 1 ? "s" : "");
+
+the message can use different words, but it will still be forced to use
+`s' for the plural. Here is a better way, with gettext being applied to
+the two strings independently:
+
+ printf ((nfiles != 1 ? gettext ("%d files processed")
+ : gettext ("%d file processed")),
+ nfiles);
+
+But this still doesn't work for languages like Polish, which has three
+plural forms: one for nfiles == 1, one for nfiles == 2, 3, 4, 22, 23,
+24, ... and one for the rest. The GNU `ngettext' function solves this
+problem:
+
+ printf (ngettext ("%d files processed", "%d file processed", nfiles),
+ nfiles);
+
5.9 Character Set
=================
@@ -2892,7 +2910,7 @@
variables. The previous descriptions of functions and variables in the
section will also have given information about the topic. A description
written to stand alone would repeat some of that information; this
-redundance looks bad. Meanwhile, the informality that is acceptable in
+redundancy looks bad. Meanwhile, the informality that is acceptable in
a documentation string is totally unacceptable in a manual.
The only good way to use documentation strings in writing a good
@@ -3322,8 +3340,9 @@
(http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/config/config/config.guess).
Other options are permitted to specify in more detail the software
-or hardware present on the machine, and include or exclude optional
-parts of the package:
+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:
`--enable-FEATURE[=PARAMETER]'
Configure the package to build and install an optional user-level
@@ -3348,11 +3367,26 @@
find certain files. That is outside the scope of what `--with'
options are for.
- All `configure' scripts should accept all of these "detail" options,
-whether or not they make any difference to the particular package at
-hand. In particular, they should accept any option that starts with
-`--with-' or `--enable-'. This is so users will be able to configure
-an entire GNU source tree at once with a single set of options.
+`VARIABLE=VALUE'
+ Set the value of the variable VARIABLE to VALUE. This is used to
+ override the default values of commands or arguments in the build
+ process. For example, the user could issue `configure CFLAGS=-g
+ CXXFLAGS=-g' to build with debugging information and without the
+ default optimization.
+
+ Specifying variables as arguments to `configure', like this:
+ ./configure CC=gcc
+ is preferable to setting them in environment variables:
+ CC=gcc ./configure
+ as it helps to recreate the same configuration later with
+ `config.status'.
+
+ All `configure' scripts should accept all of the "detail" options
+and the variable settings, whether or not they make any difference to
+the particular package at hand. In particular, they should accept any
+option that starts with `--with-' or `--enable-'. This is so users
+will be able to configure an entire GNU source tree at once with a
+single set of options.
You will note that the categories `--with-' and `--enable-' are
narrow: they *do not* provide a place for any sort of option you might
@@ -3582,8 +3616,8 @@
and `INSTALL_DATA'. (The default for `INSTALL_PROGRAM' should be
`$(INSTALL)'; the default for `INSTALL_DATA' should be `${INSTALL} -m
644'.) Then it should use those variables as the commands for actual
-installation, for executables and nonexecutables respectively. Minimal
-use of these variables is as follows:
+installation, for executables and non-executables respectively.
+Minimal use of these variables is as follows:
$(INSTALL_PROGRAM) foo $(bindir)/foo
$(INSTALL_DATA) libfoo.a $(libdir)/libfoo.a
@@ -3604,14 +3638,13 @@
$(INSTALL_PROGRAM) foo $(DESTDIR)$(bindir)/foo
$(INSTALL_DATA) libfoo.a $(DESTDIR)$(libdir)/libfoo.a
- The `DESTDIR' variable is specified by the user, either to the
-`configure' script or, more commonly, on the `make' command line. For
-example:
+ The `DESTDIR' variable is specified by the user on the `make'
+command line. For example:
make DESTDIR=/tmp/stage install
-(Since the value of `DESTDIR' is only used during installation it is
-not necessary to provide it with other `make' commands.)
+`DESTDIR' should be supported only in the `install*' and `uninstall*'
+targets, as those are the only targets where it is useful.
If your installation step would normally install
`/usr/local/bin/foo' and `/usr/local/lib/libfoo.a', then an
@@ -3639,8 +3672,8 @@
those permissions. Finally, it can be useful with tools such as
`stow', where code is installed in one place but made to appear to be
installed somewhere else using symbolic links or special mount
-operations. So, we recommend GNU packages support `DESTDIR', though it
-is not an absolute requirement.
+operations. So, we strongly recommend GNU packages support `DESTDIR',
+though it is not an absolute requirement.
7.2.5 Variables for Installation Directories
--------------------------------------------
@@ -3850,8 +3883,7 @@
`pdfdir'
`psdir'
Directories for installing documentation files in the particular
- format. (It is not required to support documentation in all these
- formats.) They should all be set to `$(docdir)' by default. (If
+ format. They should all be set to `$(docdir)' by default. (If
you are using Autoconf, write them as address@hidden@', address@hidden@',
etc.) Packages which supply several translations of their
documentation should install them in `$(htmldir)/'LL,
@@ -3926,7 +3958,7 @@
`srcdir'
The directory for the sources being compiled. The value of this
variable is normally inserted by the `configure' shell script.
- (If you are using Autconf, use `srcdir = @srcdir@'.)
+ (If you are using Autoconf, use `srcdir = @srcdir@'.)
For example:
@@ -3955,13 +3987,13 @@
order for this to be useful, all the packages must be designed so that
they will work sensibly when the user does so.
- Not all of these variables may be implemented in the current release
-of Autoconf and/or Automake; right now, that includes at least
-`docdir', `psdir', `pdfdir', `htmldir', `dvidir'. In these cases, the
-descriptions here serve as specifications for what Autoconf will
-implement. As a programmer, you can either use a development version
-of Autoconf or avoid using these variables until a stable release is
-made which supports them.
+ At times, not all of these variables may be implemented in the
+current release of Autoconf and/or Automake; but as of Autoconf 2.60, we
+believe all of them are. When any are missing, the descriptions here
+serve as specifications for what Autoconf will implement. As a
+programmer, you can either use a development version of Autoconf or
+avoid using these variables until a stable release is made which
+supports them.
7.2.6 Standard Targets for Users
--------------------------------
@@ -3971,8 +4003,9 @@
`all'
Compile the entire program. This should be the default target.
This target need not rebuild any documentation files; Info files
- should normally be included in the distribution, and DVI files
- should be made only when explicitly asked for.
+ should normally be included in the distribution, and DVI (and other
+ documentation format) files should be made only when explicitly
+ asked for.
By default, the Make rules should compile and link with `-g', so
that executable programs have debugging symbols. Users who don't
@@ -4052,6 +4085,9 @@
or two nodes with the same name in different manuals will
overwrite each other.
+ Please make these `install-FORMAT' targets invoke the commands for
+ the FORMAT target, for example, by making FORMAT a dependency.
+
`uninstall'
Delete all the installed files--the copies that the `install' and
`install-*' targets create.
@@ -4168,7 +4204,12 @@
`html'
`pdf'
`ps'
- Generate documentation files in the given format, if possible.
+ Generate documentation files in the given format. These targets
+ should always exist, but any or all can be a no-op if the given
+ output format cannot be generated. These targets should not be
+ dependencies of the `all' target; the user must manually invoke
+ them.
+
Here's an example rule for generating DVI files from Texinfo:
dvi: foo.dvi
@@ -4963,45 +5004,45 @@
address for bug reports: See 4.7. (line 875)
ANSI C standard: See 3.4. (line 361)
arbitrary limits on data: See 4.2. (line 516)
-ASCII characters: See 5.9. (line 2699)
+ASCII characters: See 5.9. (line 2717)
autoconf: See 5.5. (line 2386)
avoiding proprietary code: See 2.1. (line 139)
behavior, dependent on program's name: See 4.5. (line 701)
-binary packages: See 7.2.7. (line 4338)
-bindir: See 7.2.5. (line 3696)
+binary packages: See 7.2.7. (line 4379)
+bindir: See 7.2.5. (line 3729)
braces, in C source: See 5.1. (line 2014)
bug reports: See 4.7. (line 875)
canonical name of a program: See 4.7. (line 789)
casting pointers to integers: See 5.6. (line 2498)
CGI programs, standard options for: See 4.7. (line 776)
-change logs: See 6.8. (line 2985)
-change logs, conditional changes: See 6.8.4. (line 3129)
-change logs, style: See 6.8.2. (line 3036)
-character set: See 5.9. (line 2699)
+change logs: See 6.8. (line 3003)
+change logs, conditional changes: See 6.8.4. (line 3147)
+change logs, style: See 6.8.2. (line 3054)
+character set: See 5.9. (line 2717)
command-line arguments, decoding: See 4.2. (line 556)
command-line interface: See 4.7. (line 751)
commenting: See 5.2. (line 2130)
compatibility with C and POSIX standards: See 3.2. (line 296)
compiler warnings: See 5.3. (line 2217)
-conditional changes, and change logs: See 6.8.4. (line 3129)
+conditional changes, and change logs: See 6.8.4. (line 3147)
conditionals, comments for: See 5.2. (line 2184)
-configure: See 7.1. (line 3247)
+configure: See 7.1. (line 3265)
control-L: See 5.1. (line 2122)
-conventions for makefiles: See 7.2. (line 3395)
+conventions for makefiles: See 7.2. (line 3429)
corba: See 4.6. (line 742)
-credits for manuals: See 6.5. (line 2950)
+credits for manuals: See 6.5. (line 2968)
data types, and portability: See 5.6. (line 2425)
declaration for system functions: See 5.7. (line 2525)
-DESTDIR: See 7.2.4. (line 3601)
-documentation: See 6. (line 2761)
+DESTDIR: See 7.2.4. (line 3635)
+documentation: See 6. (line 2779)
doschk: See 5.4. (line 2355)
downloading this manual: See 1. (line 102)
-encodings: See 5.9. (line 2699)
+encodings: See 5.9. (line 2717)
error messages: See 4.2. (line 529)
error messages, formatting: See 4.4. (line 639)
-exec_prefix: See 7.2.5. (line 3678)
+exec_prefix: See 7.2.5. (line 3711)
expressions, splitting: See 5.1. (line 2085)
-FDL, GNU Free Documentation License: See A.1. (line 4529)
+FDL, GNU Free Documentation License: See A.1. (line 4570)
file usage: See 4.10. (line 1992)
file-name limitations: See 5.4. (line 2355)
formatting error messages: See 4.4. (line 639)
@@ -5013,76 +5054,76 @@
gettext: See 5.8. (line 2622)
gnome: See 4.6. (line 742)
graphical user interface: See 4.6. (line 732)
-grave accent: See 5.10. (line 2714)
+grave accent: See 5.10. (line 2732)
gtk+: See 4.6. (line 732)
GUILE: See 3.1. (line 286)
implicit int: See 5.3. (line 2213)
impossible conditions: See 4.2. (line 580)
-installations, staged: See 7.2.4. (line 3601)
+installations, staged: See 7.2.4. (line 3635)
internationalization: See 5.8. (line 2622)
-left quote: See 5.10. (line 2714)
+left quote: See 5.10. (line 2732)
legal aspects: See 2. (line 133)
legal papers: See 2.2. (line 173)
-libexecdir: See 7.2.5. (line 3709)
+libexecdir: See 7.2.5. (line 3742)
libraries: See 4.3. (line 611)
library functions, and portability: See 5.7. (line 2510)
-license for manuals: See 6.4. (line 2931)
+license for manuals: See 6.4. (line 2949)
lint: See 5.3. (line 2316)
-locale-specific quote characters: See 5.10. (line 2714)
+locale-specific quote characters: See 5.10. (line 2732)
long option names: See 4.8. (line 883)
long-named options: See 4.7. (line 757)
-makefile, conventions for: See 7.2. (line 3395)
+makefile, conventions for: See 7.2. (line 3429)
malloc return value: See 4.2. (line 535)
-man pages: See 6.9. (line 3173)
-manual structure: See 6.3. (line 2904)
+man pages: See 6.9. (line 3191)
+manual structure: See 6.3. (line 2922)
memory allocation failure: See 4.2. (line 535)
memory usage: See 4.9. (line 1972)
message text, and internationalization: See 5.8. (line 2645)
-mmap: See 5.11. (line 2745)
+mmap: See 5.11. (line 2763)
multiple variables in a line: See 5.3. (line 2242)
names of variables, functions, and files: See 5.4. (line 2323)
-NEWS file: See 6.7. (line 2971)
-non-ASCII characters: See 5.9. (line 2699)
+NEWS file: See 6.7. (line 2989)
+non-ASCII characters: See 5.9. (line 2717)
non-POSIX systems, and portability: See 5.5. (line 2395)
non-standard extensions: See 3.3. (line 328)
NUL characters: See 4.2. (line 521)
open brace: See 5.1. (line 2014)
-optional features, configure-time: See 7.1. (line 3324)
+optional features, configure-time: See 7.1. (line 3342)
options for compatibility: See 3.2. (line 304)
options, standard command-line: See 4.7. (line 776)
output device and program's behavior: See 4.5. (line 708)
-packaging: See 7.3. (line 4365)
+packaging: See 7.3. (line 4406)
PATH_INFO, specifying standard options as: See 4.7. (line 776)
portability, and data types: See 5.6. (line 2425)
portability, and library functions: See 5.7. (line 2510)
portability, between system types: See 5.5. (line 2369)
POSIX compatibility: See 3.2. (line 296)
POSIXLY_CORRECT, environment variable: See 3.2. (line 311)
-post-installation commands: See 7.2.7. (line 4264)
-pre-installation commands: See 7.2.7. (line 4264)
-prefix: See 7.2.5. (line 3668)
-program configuration: See 7.1. (line 3247)
+post-installation commands: See 7.2.7. (line 4305)
+pre-installation commands: See 7.2.7. (line 4305)
+prefix: See 7.2.5. (line 3701)
+program configuration: See 7.1. (line 3265)
program design: See 3. (line 248)
program name and its behavior: See 4.5. (line 701)
program's canonical name: See 4.7. (line 789)
programming languages: See 3.1. (line 254)
proprietary programs: See 2.1. (line 139)
-quote characters: See 5.10. (line 2714)
-README file: See 7.3. (line 4380)
-references to non-free material: See 8. (line 4441)
-releasing: See 7. (line 3236)
-sbindir: See 7.2.5. (line 3702)
+quote characters: See 5.10. (line 2732)
+README file: See 7.3. (line 4421)
+references to non-free material: See 8. (line 4482)
+releasing: See 7. (line 3254)
+sbindir: See 7.2.5. (line 3735)
signal handling: See 4.2. (line 569)
spaces before open-paren: See 5.1. (line 2079)
-staged installs: See 7.2.4. (line 3601)
+staged installs: See 7.2.4. (line 3635)
standard command-line options: See 4.7. (line 776)
-standards for makefiles: See 7.2. (line 3395)
+standards for makefiles: See 7.2. (line 3429)
string library functions: See 5.7. (line 2559)
syntactic conventions: See 5.3. (line 2213)
table of long options: See 4.8. (line 883)
temporary files: See 4.2. (line 594)
temporary variables: See 5.3. (line 2230)
-texinfo.tex, in a distribution: See 7.3. (line 4429)
+texinfo.tex, in a distribution: See 7.3. (line 4470)
TMPDIR environment variable: See 4.2. (line 594)
trademarks: See 2.3. (line 218)
where to obtain standards.texi: See 1. (line 102)
Index: standards.txt.gz
===================================================================
RCS file: /web/www/www/prep/standards/standards.txt.gz,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
Binary files /tmp/cvsyyS8xi and /tmp/cvsf2jab6 differ
Index: html_node/CPU-Portability.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/CPU-Portability.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/CPU-Portability.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/CPU-Portability.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>CPU Portability - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="System-Portability.html#System-Portability"
title="System Portability">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Change-Log-Concepts.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Change-Log-Concepts.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Change-Log-Concepts.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Change-Log-Concepts.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Change Log Concepts - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Change-Logs.html#Change-Logs" title="Change Logs">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Change-Logs.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Change-Logs.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Change-Logs.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Change-Logs.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Change Logs - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="NEWS-File.html#NEWS-File" title="NEWS File">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Character-Set.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Character-Set.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- html_node/Character-Set.html 8 May 2006 13:26:00 -0000 1.4
+++ html_node/Character-Set.html 19 Aug 2006 17:43:57 -0000 1.5
@@ -3,20 +3,20 @@
<title>Character Set - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="Internationalization.html#Internationalization"
title="Internationalization">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Command-Variables.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Command-Variables.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Command-Variables.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Command-Variables.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Command Variables - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
<link rel="prev" href="Utilities-in-Makefiles.html#Utilities-in-Makefiles"
title="Utilities in Makefiles">
-<link rel="next" href="Directory-Variables.html#Directory-Variables"
title="Directory Variables">
+<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -39,7 +39,7 @@
<div class="node">
<p>
<a name="Command-Variables"></a>
-Next: <a rel="next" accesskey="n"
href="Directory-Variables.html#Directory-Variables">Directory Variables</a>,
+Next: <a rel="next" accesskey="n" href="DESTDIR.html#DESTDIR">DESTDIR</a>,
Previous: <a rel="previous" accesskey="p"
href="Utilities-in-Makefiles.html#Utilities-in-Makefiles">Utilities in
Makefiles</a>,
Up: <a rel="up" accesskey="u"
href="Makefile-Conventions.html#Makefile-Conventions">Makefile Conventions</a>
<hr>
@@ -101,7 +101,7 @@
and <code>INSTALL_DATA</code>. (The default for <code>INSTALL_PROGRAM</code>
should
be <code>$(INSTALL)</code>; the default for <code>INSTALL_DATA</code> should be
<code>${INSTALL} -m 644</code>.) Then it should use those variables as the
-commands for actual installation, for executables and nonexecutables
+commands for actual installation, for executables and non-executables
respectively. Minimal use of these variables is as follows:
<pre class="example"> $(INSTALL_PROGRAM) foo $(bindir)/foo
Index: html_node/Command_002dLine-Interfaces.html
===================================================================
RCS file:
/web/www/www/prep/standards/html_node/Command_002dLine-Interfaces.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Command_002dLine-Interfaces.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Command_002dLine-Interfaces.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,20 +3,20 @@
<title>Command-Line Interfaces - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="Graphical-Interfaces.html#Graphical-Interfaces"
title="Graphical Interfaces">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -73,7 +73,7 @@
(preferably ‘<samp><span class="samp">-o</span></samp>’ or
‘<samp><span class="samp">--output</span></samp>’). Even if you
allow an output
file name as an ordinary argument for compatibility, try to provide an
option as another way to specify it. This will lead to more consistency
-among GNU utilities, and fewer idiosyncracies for users to remember.
+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>’
and ‘<samp><span class="samp">--help</span></samp>’. CGI programs
should accept these as command-line
Index: html_node/Comments.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Comments.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Comments.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Comments.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Comments - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="Formatting.html#Formatting" title="Formatting">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Compatibility.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Compatibility.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Compatibility.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Compatibility.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Compatibility - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Design-Advice.html#Design-Advice" title="Design Advice">
<link rel="prev" href="Source-Language.html#Source-Language" title="Source
Language">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Conditional-Changes.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Conditional-Changes.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Conditional-Changes.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Conditional-Changes.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Conditional Changes - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Change-Logs.html#Change-Logs" title="Change Logs">
<link rel="prev" href="Simple-Changes.html#Simple-Changes" title="Simple
Changes">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Conditional-Compilation.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Conditional-Compilation.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Conditional-Compilation.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Conditional-Compilation.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,19 +3,19 @@
<title>Conditional Compilation - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Design-Advice.html#Design-Advice" title="Design Advice">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Configuration.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Configuration.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Configuration.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Configuration.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Configuration - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Managing-Releases.html#Managing-Releases" title="Managing
Releases">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -125,8 +125,8 @@
<a
href="http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/config/config/config.guess"><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
-or hardware present on the machine, and include or exclude optional
-parts of the package:
+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:
<dl>
<dt>‘<samp><span class="samp">--enable-</span><var>feature</var><span
class="samp">[=</span><var>parameter</var><span
class="samp">]</span></samp>’<dd>Configure the package to build and
install an optional user-level
@@ -156,14 +156,29 @@
<p>Do not use a ‘<samp><span
class="samp">--with</span></samp>’ option to specify the file name to use
to
find certain files. That is outside the scope of what ‘<samp><span
class="samp">--with</span></samp>’
options are for.
+
+ <br><dt>‘<samp><var>variable</var><span
class="samp">=</span><var>value</var></samp>’<dd>Set the value of the
variable <var>variable</var> to <var>value</var>. This is
+used to override the default values of commands or arguments in the
+build process. For example, the user could issue ‘<samp><span
class="samp">configure
+CFLAGS=-g CXXFLAGS=-g</span></samp>’ to build with debugging information
and without
+the default optimization.
+
+ <p>Specifying variables as arguments to <code>configure</code>, like this:
+ <pre class="example"> ./configure CC=gcc
+</pre>
+ <p>is preferable to setting them in environment variables:
+ <pre class="example"> CC=gcc ./configure
+</pre>
+ <p>as it helps to recreate the same configuration later with
+<samp><span class="file">config.status</span></samp>.
</dl>
- <p>All <code>configure</code> scripts should accept all of these
“detail”
-options, whether or not they make any difference to the particular
-package at hand. In particular, they should accept any option that
-starts with ‘<samp><span class="samp">--with-</span></samp>’ or
‘<samp><span class="samp">--enable-</span></samp>’. This is so
users will
-be able to configure an entire GNU source tree at once with a single set
-of options.
+ <p>All <code>configure</code> scripts should accept all of the
“detail”
+options and the variable settings, whether or not they make any
+difference to the particular package at hand. In particular, they
+should accept any option that starts with ‘<samp><span
class="samp">--with-</span></samp>’ or
+‘<samp><span class="samp">--enable-</span></samp>’. This is so
users will be able to configure an
+entire GNU source tree at once with a single set of options.
<p>You will note that the categories ‘<samp><span
class="samp">--with-</span></samp>’ and ‘<samp><span
class="samp">--enable-</span></samp>’
are narrow: they <strong>do not</strong> provide a place for any sort of option
Index: html_node/Contributions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Contributions.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Contributions.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Contributions.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Contributions - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Legal-Issues.html#Legal-Issues" title="Legal Issues">
<link rel="prev"
href="Reading-Non_002dFree-Code.html#Reading-Non_002dFree-Code" title="Reading
Non-Free Code">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Copying-This-Manual.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Copying-This-Manual.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Copying-This-Manual.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Copying-This-Manual.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Copying This Manual - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="References.html#References" title="References">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/DESTDIR.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/DESTDIR.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- html_node/DESTDIR.html 8 May 2006 13:26:19 -0000 1.1
+++ html_node/DESTDIR.html 19 Aug 2006 17:43:57 -0000 1.2
@@ -3,20 +3,20 @@
<title>DESTDIR - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
-<link rel="prev" href="Directory-Variables.html#Directory-Variables"
title="Directory Variables">
-<link rel="next" href="Standard-Targets.html#Standard-Targets" title="Standard
Targets">
+<link rel="prev" href="Command-Variables.html#Command-Variables"
title="Command Variables">
+<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -39,8 +39,8 @@
<div class="node">
<p>
<a name="DESTDIR"></a>
-Next: <a rel="next" accesskey="n"
href="Standard-Targets.html#Standard-Targets">Standard Targets</a>,
-Previous: <a rel="previous" accesskey="p"
href="Directory-Variables.html#Directory-Variables">Directory Variables</a>,
+Next: <a rel="next" accesskey="n"
href="Directory-Variables.html#Directory-Variables">Directory Variables</a>,
+Previous: <a rel="previous" accesskey="p"
href="Command-Variables.html#Command-Variables">Command Variables</a>,
Up: <a rel="up" accesskey="u"
href="Makefile-Conventions.html#Makefile-Conventions">Makefile Conventions</a>
<hr>
</div>
@@ -54,14 +54,14 @@
<pre class="example"> $(INSTALL_PROGRAM) foo $(DESTDIR)$(bindir)/foo
$(INSTALL_DATA) libfoo.a $(DESTDIR)$(libdir)/libfoo.a
</pre>
- <p>The <code>DESTDIR</code> variable is specified by the user, either to the
-<samp><span class="file">configure</span></samp> script or, more commonly, on
the <code>make</code> command
-line. For example:
+ <p>The <code>DESTDIR</code> variable is specified by the user on the
<code>make</code>
+command line. For example:
<pre class="example"> make DESTDIR=/tmp/stage install
</pre>
- <p class="noindent">(Since the value of <code>DESTDIR</code> is only used
during installation it
-is not necessary to provide it with other <code>make</code> commands.)
+ <p class="noindent"><code>DESTDIR</code> should be supported only in the
<code>install*</code> and
+<code>uninstall*</code> targets, as those are the only targets where it is
+useful.
<p>If your installation step would normally install
<samp><span class="file">/usr/local/bin/foo</span></samp> and <samp><span
class="file">/usr/local/lib/libfoo.a</span></samp>, then an
@@ -89,8 +89,8 @@
those permissions. Finally, it can be useful with tools such as
<code>stow</code>, where code is installed in one place but made to appear
to be installed somewhere else using symbolic links or special mount
-operations. So, we recommend GNU packages support <code>DESTDIR</code>,
-though it is not an absolute requirement.
+operations. So, we strongly recommend GNU packages support
+<code>DESTDIR</code>, though it is not an absolute requirement.
</body></html>
Index: html_node/Design-Advice.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Design-Advice.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Design-Advice.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Design-Advice.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Design Advice - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Legal-Issues.html#Legal-Issues" title="Legal Issues">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Directory-Variables.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Directory-Variables.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- html_node/Directory-Variables.html 8 May 2006 13:26:00 -0000 1.13
+++ html_node/Directory-Variables.html 19 Aug 2006 17:43:57 -0000 1.14
@@ -3,20 +3,20 @@
<title>Directory Variables - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
-<link rel="prev" href="Command-Variables.html#Command-Variables"
title="Command Variables">
-<link rel="next" href="DESTDIR.html#DESTDIR" title="DESTDIR">
+<link rel="prev" href="DESTDIR.html#DESTDIR" title="DESTDIR">
+<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -39,8 +39,8 @@
<div class="node">
<p>
<a name="Directory-Variables"></a>
-Next: <a rel="next" accesskey="n" href="DESTDIR.html#DESTDIR">DESTDIR</a>,
-Previous: <a rel="previous" accesskey="p"
href="Command-Variables.html#Command-Variables">Command Variables</a>,
+Next: <a rel="next" accesskey="n"
href="Standard-Targets.html#Standard-Targets">Standard Targets</a>,
+Previous: <a rel="previous" accesskey="p"
href="DESTDIR.html#DESTDIR">DESTDIR</a>,
Up: <a rel="up" accesskey="u"
href="Makefile-Conventions.html#Makefile-Conventions">Makefile Conventions</a>
<hr>
</div>
@@ -245,8 +245,7 @@
<code>docdir</code> for compatibility with existing practice.
<br><dt>‘<samp><span
class="samp">htmldir</span></samp>’<dt>‘<samp><span
class="samp">dvidir</span></samp>’<dt>‘<samp><span
class="samp">pdfdir</span></samp>’<dt>‘<samp><span
class="samp">psdir</span></samp>’<dd>Directories for installing
documentation files in the particular
-format. (It is not required to support documentation in all these
-formats.) They should all be set to <code>$(docdir)</code> by default. (If
+format. They should all be set to <code>$(docdir)</code> by default. (If
you are using Autoconf, write them as ‘<samp><span
class="samp">@htmldir@</span></samp>’,
‘<samp><span class="samp">@dvidir@</span></samp>’, etc.) Packages
which supply several translations
of their documentation should install them in
@@ -309,7 +308,7 @@
<dl>
<dt>‘<samp><span class="samp">srcdir</span></samp>’<dd>The
directory for the sources being compiled. The value of this
variable is normally inserted by the <code>configure</code> shell script.
-(If you are using Autconf, use ‘<samp><span class="samp">srcdir =
@srcdir@</span></samp>’.)
+(If you are using Autoconf, use ‘<samp><span class="samp">srcdir =
@srcdir@</span></samp>’.)
</dl>
<p>For example:
@@ -341,13 +340,13 @@
order for this to be useful, all the packages must be designed so that
they will work sensibly when the user does so.
- <p>Not all of these variables may be implemented in the current release
-of Autoconf and/or Automake; right now, that includes at least
-<code>docdir</code>, <code>psdir</code>, <code>pdfdir</code>,
<code>htmldir</code>,
-<code>dvidir</code>. In these cases, the descriptions here serve as
-specifications for what Autoconf will implement. As a programmer, you
-can either use a development version of Autoconf or avoid using these
-variables until a stable release is made which supports them.
+ <p>At times, not all of these variables may be implemented in the current
+release of Autoconf and/or Automake; but as of Autoconf 2.60, we
+believe all of them are. When any are missing, the descriptions here
+serve as specifications for what Autoconf will implement. As a
+programmer, you can either use a development version of Autoconf or
+avoid using these variables until a stable release is made which
+supports them.
</body></html>
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.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Doc-Strings-and-Manuals.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Doc-Strings-and-Manuals.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,20 +3,20 @@
<title>Doc Strings and Manuals - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="GNU-Manuals.html#GNU-Manuals" title="GNU Manuals">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -65,7 +65,7 @@
variables. The previous descriptions of functions and variables in the
section will also have given information about the topic. A description
written to stand alone would repeat some of that information; this
-redundance looks bad. Meanwhile, the informality that is acceptable in
+redundancy looks bad. Meanwhile, the informality that is acceptable in
a documentation string is totally unacceptable in a manual.
<p>The only good way to use documentation strings in writing a good manual
Index: html_node/Documentation.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Documentation.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Documentation.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Documentation.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Documentation - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Writing-C.html#Writing-C" title="Writing C">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Errors.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Errors.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Errors.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Errors.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Errors - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="Libraries.html#Libraries" title="Libraries">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/File-Usage.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/File-Usage.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/File-Usage.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/File-Usage.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>File Usage - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Formatting.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Formatting.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Formatting.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Formatting.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Formatting - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
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.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- html_node/GNU-Free-Documentation-License.html 8 May 2006 13:26:00
-0000 1.13
+++ html_node/GNU-Free-Documentation-License.html 19 Aug 2006 17:43:57
-0000 1.14
@@ -3,18 +3,18 @@
<title>GNU Free Documentation License - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Copying-This-Manual.html#Copying-This-Manual"
title="Copying This Manual">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/GNU-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/GNU-Manuals.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- html_node/GNU-Manuals.html 8 May 2006 13:26:00 -0000 1.13
+++ html_node/GNU-Manuals.html 19 Aug 2006 17:43:57 -0000 1.14
@@ -3,19 +3,19 @@
<title>GNU Manuals - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Graphical-Interfaces.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Graphical-Interfaces.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Graphical-Interfaces.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Graphical-Interfaces.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Graphical Interfaces - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="User-Interfaces.html#User-Interfaces" title="User
Interfaces">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Index.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Index.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Index.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Index.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,18 +3,18 @@
<title>Index - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Copying-This-Manual.html#Copying-This-Manual"
title="Copying This Manual">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
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.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Indicating-the-Part-Changed.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Indicating-the-Part-Changed.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,19 +3,19 @@
<title>Indicating the Part Changed - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Change-Logs.html#Change-Logs" title="Change Logs">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Install-Command-Categories.html
===================================================================
RCS file:
/web/www/www/prep/standards/html_node/Install-Command-Categories.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Install-Command-Categories.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Install-Command-Categories.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,19 +3,19 @@
<title>Install Command Categories - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Internationalization.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Internationalization.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Internationalization.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Internationalization.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Internationalization - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="System-Functions.html#System-Functions" title="System
Functions">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -69,7 +69,7 @@
name</dfn> for the package. The text domain name is used to separate the
translations for this package from the translations for other packages.
Normally, the text domain name should be the same as the name of the
-package—for example, ‘<samp><span
class="samp">fileutils</span></samp>’ for the GNU file utilities.
+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
assumptions about the structure of words or sentences. When you want
@@ -80,33 +80,24 @@
<p>Here is an example of what not to do:
-<pre class="example"> printf ("%d file%s processed", nfiles,
- nfiles != 1 ? "s" : "");
+<pre class="smallexample"> printf ("%s is full", capacity > 5000000 ?
"disk" : "floppy disk");
</pre>
- <p class="noindent">The problem with that example is that it assumes that
plurals are made
-by adding `s'. If you apply gettext to the format string, like this,
+ <p>If you apply gettext to all strings, like this,
-<pre class="example"> printf (gettext ("%d file%s processed"), nfiles,
- nfiles != 1 ? "s" : "");
+<pre class="smallexample"> printf (gettext ("%s is full"),
+ capacity > 5000000 ? gettext ("disk") : gettext ("floppy
disk"));
</pre>
- <p class="noindent">the message can use different words, but it will still
be forced to use
-`s' for the plural. Here is a better way:
+ <p class="noindent">the translator will hardly know that "disk" and "floppy
disk" are meant to
+be substituted in the other string. Worse, in some languages (like French)
+the construction will not work: the translation of the word "full" depends
+on the gender of the first part of the sentence; it happens to be not the
+same for "disk" as for "floppy disk".
-<pre class="example"> printf ((nfiles != 1 ? "%d files processed"
- : "%d file processed"),
- nfiles);
-</pre>
- <p class="noindent">This way, you can apply gettext to each of the two
strings
-independently:
+ <p>Complete sentences can be translated without problems:
-<pre class="example"> printf ((nfiles != 1 ? gettext ("%d files processed")
- : gettext ("%d file processed")),
- nfiles);
+<pre class="example"> printf (capacity > 5000000 ? gettext ("disk is
full")
+ : gettext ("floppy disk is full"));
</pre>
- <p class="noindent">This can be any method of forming the plural of the
word for “file”, and
-also handles languages that require agreement in the word for
-“processed”.
-
<p>A similar problem appears at the level of sentence structure with this
code:
@@ -116,12 +107,38 @@
<p class="noindent">Adding <code>gettext</code> calls to this code cannot
give correct results for
all languages, because negation in some languages requires adding words
at more than one place in the sentence. By contrast, adding
-<code>gettext</code> calls does the job straightfowardly if the code starts
+<code>gettext</code> calls does the job straightforwardly if the code starts
out like this:
<pre class="example"> printf (f->tried_implicit
? "# Implicit rule search has been done.\n",
: "# Implicit rule search has not been done.\n");
</pre>
+ <p>Another example is this one:
+
+<pre class="example"> printf ("%d file%s processed", nfiles,
+ nfiles != 1 ? "s" : "");
+</pre>
+ <p class="noindent">The problem with this example is that it assumes that
plurals are made
+by adding `s'. If you apply gettext to the format string, like this,
+
+<pre class="example"> printf (gettext ("%d file%s processed"), nfiles,
+ nfiles != 1 ? "s" : "");
+</pre>
+ <p class="noindent">the message can use different words, but it will still
be forced to use
+`s' for the plural. Here is a better way, with gettext being applied to
+the two strings independently:
+
+<pre class="example"> printf ((nfiles != 1 ? gettext ("%d files processed")
+ : gettext ("%d file processed")),
+ nfiles);
+</pre>
+ <p class="noindent">But this still doesn't work for languages like Polish,
which has three
+plural forms: one for nfiles == 1, one for nfiles == 2, 3, 4, 22, 23, 24, ...
+and one for the rest. The GNU <code>ngettext</code> function solves this
problem:
+
+<pre class="example"> printf (ngettext ("%d files processed", "%d file
processed", nfiles),
+ nfiles);
+</pre>
</body></html>
Index: html_node/Legal-Issues.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Legal-Issues.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Legal-Issues.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Legal-Issues.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Legal Issues - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Preface.html#Preface" title="Preface">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Libraries.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Libraries.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Libraries.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Libraries.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Libraries - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="Semantics.html#Semantics" title="Semantics">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/License-for-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/License-for-Manuals.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/License-for-Manuals.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/License-for-Manuals.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>License for Manuals - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="Manual-Structure-Details.html#Manual-Structure-Details"
title="Manual Structure Details">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Makefile-Basics.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Makefile-Basics.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Makefile-Basics.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Makefile-Basics.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Makefile Basics - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Makefile-Conventions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Makefile-Conventions.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- html_node/Makefile-Conventions.html 8 May 2006 13:26:00 -0000 1.13
+++ html_node/Makefile-Conventions.html 19 Aug 2006 17:43:57 -0000 1.14
@@ -3,20 +3,20 @@
<title>Makefile Conventions - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Managing-Releases.html#Managing-Releases" title="Managing
Releases">
<link rel="prev" href="Configuration.html#Configuration" title="Configuration">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -53,7 +53,7 @@
<!-- 2004, 2005, 2006 Free Software Foundation, Inc. -->
<!-- Permission is granted to copy, distribute and/or modify this document -->
-<!-- under the terms of the GNU Free Documentation License, Version 1.1 -->
+<!-- under the terms of the GNU Free Documentation License, Version 1.2 -->
<!-- or any later version published by the Free Software Foundation; -->
<!-- with no Invariant Sections, with no -->
<!-- Front-Cover Texts, and with no Back-Cover Texts. -->
@@ -68,8 +68,8 @@
<li><a accesskey="1" href="Makefile-Basics.html#Makefile-Basics">Makefile
Basics</a>: General conventions for Makefiles.
<li><a accesskey="2"
href="Utilities-in-Makefiles.html#Utilities-in-Makefiles">Utilities in
Makefiles</a>: Utilities to be used in Makefiles.
<li><a accesskey="3" href="Command-Variables.html#Command-Variables">Command
Variables</a>: Variables for specifying commands.
-<li><a accesskey="4"
href="Directory-Variables.html#Directory-Variables">Directory Variables</a>:
Variables for installation directories.
-<li><a accesskey="5" href="DESTDIR.html#DESTDIR">DESTDIR</a>:
Supporting staged installs.
+<li><a accesskey="4" href="DESTDIR.html#DESTDIR">DESTDIR</a>:
Supporting staged installs.
+<li><a accesskey="5"
href="Directory-Variables.html#Directory-Variables">Directory Variables</a>:
Variables for installation directories.
<li><a accesskey="6" href="Standard-Targets.html#Standard-Targets">Standard
Targets</a>: Standard targets for users.
<li><a accesskey="7"
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a>: Three categories of commands in the `install'
rule: normal, pre-install and post-install.
Index: html_node/Man-Pages.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Man-Pages.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Man-Pages.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Man-Pages.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Man Pages - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="Change-Logs.html#Change-Logs" title="Change Logs">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Managing-Releases.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Managing-Releases.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Managing-Releases.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Managing-Releases.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Managing Releases - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Documentation.html#Documentation" title="Documentation">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Manual-Credits.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Manual-Credits.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Manual-Credits.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Manual-Credits.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Manual Credits - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="License-for-Manuals.html#License-for-Manuals"
title="License for Manuals">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Manual-Structure-Details.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Manual-Structure-Details.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Manual-Structure-Details.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Manual-Structure-Details.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,20 +3,20 @@
<title>Manual Structure Details - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="Doc-Strings-and-Manuals.html#Doc-Strings-and-Manuals"
title="Doc Strings and Manuals">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Memory-Usage.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Memory-Usage.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Memory-Usage.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Memory-Usage.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Memory Usage - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="Option-Table.html#Option-Table" title="Option Table">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Mmap.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Mmap.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Mmap.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Mmap.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Mmap - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/NEWS-File.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/NEWS-File.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/NEWS-File.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/NEWS-File.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>NEWS File - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="Printed-Manuals.html#Printed-Manuals" title="Printed
Manuals">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Names.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Names.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Names.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Names.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Names - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="Syntactic-Conventions.html#Syntactic-Conventions"
title="Syntactic Conventions">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Non_002dGNU-Standards.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Non_002dGNU-Standards.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- html_node/Non_002dGNU-Standards.html 8 May 2006 13:26:00 -0000
1.2
+++ html_node/Non_002dGNU-Standards.html 19 Aug 2006 17:43:57 -0000
1.3
@@ -3,19 +3,19 @@
<title>Non-GNU Standards - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Option-Table.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Option-Table.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Option-Table.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Option-Table.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Option Table - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev"
href="Command_002dLine-Interfaces.html#Command_002dLine-Interfaces"
title="Command-Line Interfaces">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -674,7 +674,7 @@
<br><dt>‘<samp><span
class="samp">socket</span></samp>’<dd>Specify a file descriptor for a
network server to use for its socket,
instead of opening and binding a new socket. This provides a way to
-run, in a nonpriveledged process, a server that normally needs a
+run, in a non-privileged process, a server that normally needs a
reserved port number.
<br><dt>‘<samp><span class="samp">sort</span></samp>’<dd>Used
in <code>ls</code>.
Index: html_node/Preface.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Preface.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Preface.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Preface.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Preface - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="index.html#Top" title="Top">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -55,7 +55,7 @@
state reasons for writing in a certain way.
<p>This release of the GNU Coding Standards was last updated
-April 23, 2006.
+August 19, 2006.
<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.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Printed-Manuals.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Printed-Manuals.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Printed Manuals - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<link rel="prev" href="Manual-Credits.html#Manual-Credits" title="Manual
Credits">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Program-Behavior.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Program-Behavior.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Program-Behavior.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Program-Behavior.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Program Behavior - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Design-Advice.html#Design-Advice" title="Design Advice">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Quote-Characters.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Quote-Characters.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- html_node/Quote-Characters.html 8 May 2006 13:26:00 -0000 1.4
+++ html_node/Quote-Characters.html 19 Aug 2006 17:43:57 -0000 1.5
@@ -3,20 +3,20 @@
<title>Quote Characters - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="Character-Set.html#Character-Set" title="Character Set">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
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.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Reading-Non_002dFree-Code.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Reading-Non_002dFree-Code.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,19 +3,19 @@
<title>Reading Non-Free Code - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Legal-Issues.html#Legal-Issues" title="Legal Issues">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Reading-other-Manuals.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Reading-other-Manuals.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Reading-other-Manuals.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Reading-other-Manuals.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,19 +3,19 @@
<title>Reading other Manuals - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Documentation.html#Documentation" title="Documentation">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/References.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/References.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/References.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/References.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>References - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Managing-Releases.html#Managing-Releases"
title="Managing Releases">
<link rel="next" href="Copying-This-Manual.html#Copying-This-Manual"
title="Copying This Manual">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home"
title="Texinfo Homepage">
<!--
-The GNU coding standards, last updated April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Releases.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Releases.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Releases.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Releases.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Releases - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Managing-Releases.html#Managing-Releases" title="Managing
Releases">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Semantics.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Semantics.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Semantics.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Semantics.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Semantics - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="Non_002dGNU-Standards.html#Non_002dGNU-Standards"
title="Non-GNU Standards">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Simple-Changes.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Simple-Changes.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Simple-Changes.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Simple-Changes.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Simple Changes - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Change-Logs.html#Change-Logs" title="Change Logs">
<link rel="prev" href="Style-of-Change-Logs.html#Style-of-Change-Logs"
title="Style of Change Logs">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Source-Language.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Source-Language.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Source-Language.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Source-Language.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Source Language - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Design-Advice.html#Design-Advice" title="Design Advice">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Standard-C.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Standard-C.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Standard-C.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Standard-C.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Standard C - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Design-Advice.html#Design-Advice" title="Design Advice">
<link rel="prev" href="Using-Extensions.html#Using-Extensions" title="Using
Extensions">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Standard-Targets.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Standard-Targets.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Standard-Targets.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Standard-Targets.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Standard Targets - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
-<link rel="prev" href="DESTDIR.html#DESTDIR" title="DESTDIR">
+<link rel="prev" href="Directory-Variables.html#Directory-Variables"
title="Directory Variables">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -40,7 +40,7 @@
<p>
<a name="Standard-Targets"></a>
Next: <a rel="next" accesskey="n"
href="Install-Command-Categories.html#Install-Command-Categories">Install
Command Categories</a>,
-Previous: <a rel="previous" accesskey="p"
href="DESTDIR.html#DESTDIR">DESTDIR</a>,
+Previous: <a rel="previous" accesskey="p"
href="Directory-Variables.html#Directory-Variables">Directory Variables</a>,
Up: <a rel="up" accesskey="u"
href="Makefile-Conventions.html#Makefile-Conventions">Makefile Conventions</a>
<hr>
</div>
@@ -52,8 +52,9 @@
<dl>
<dt>‘<samp><span class="samp">all</span></samp>’<dd>Compile the
entire program. This should be the default target. This
target need not rebuild any documentation files; Info files should
-normally be included in the distribution, and DVI files should be made
-only when explicitly asked for.
+normally be included in the distribution, and DVI (and other
+documentation format) files should be made only when explicitly asked
+for.
<p>By default, the Make rules should compile and link with
‘<samp><span class="samp">-g</span></samp>’, so
that executable programs have debugging symbols. Users who don't mind
@@ -91,7 +92,7 @@
Here is a sample rule to install an Info file:
<!-- This example has been carefully formatted for the Make manual. -->
-<!-- Please do not reformat it without talking to address@hidden -->
+<!-- Please do not reformat it without talking to address@hidden -->
<pre class="smallexample"> $(DESTDIR)$(infodir)/foo.info: foo.info
$(POST_INSTALL)
# There may be a newer info file in . than in srcdir.
@@ -127,6 +128,10 @@
certainly want to use subdirectories, or two nodes with the same name
in different manuals will overwrite each other.
+ <p>Please make these <code>install-</code><var>format</var> targets
invoke the
+commands for the <var>format</var> target, for example, by making
+<var>format</var> a dependency.
+
<br><dt>‘<samp><span
class="samp">uninstall</span></samp>’<dd>Delete all the installed
files—the copies that the ‘<samp><span
class="samp">install</span></samp>’
and ‘<samp><span class="samp">install-*</span></samp>’ targets
create.
@@ -233,8 +238,12 @@
users build the package, ordinarily Make will not update the Info files
because they will already be up to date.
- <br><dt>‘<samp><span
class="samp">dvi</span></samp>’<dt>‘<samp><span
class="samp">html</span></samp>’<dt>‘<samp><span
class="samp">pdf</span></samp>’<dt>‘<samp><span
class="samp">ps</span></samp>’<dd>Generate documentation files in the
given format, if possible.
-Here's an example rule for generating DVI files from Texinfo:
+ <br><dt>‘<samp><span
class="samp">dvi</span></samp>’<dt>‘<samp><span
class="samp">html</span></samp>’<dt>‘<samp><span
class="samp">pdf</span></samp>’<dt>‘<samp><span
class="samp">ps</span></samp>’<dd>Generate documentation files in the
given format. These targets
+should always exist, but any or all can be a no-op if the given output
+format cannot be generated. These targets should not be dependencies
+of the <code>all</code> target; the user must manually invoke them.
+
+ <p>Here's an example rule for generating DVI files from Texinfo:
<pre class="smallexample"> dvi: foo.dvi
@@ -326,7 +335,7 @@
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1"
href="#fnd-1">1</a>]</small> <code>texi2dvi</code> uses TeX to do the real work
of formatting. TeX is not distributed with Texinfo.</p>
- <p><hr></div>
+ <hr></div>
</body></html>
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.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Style-of-Change-Logs.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Style-of-Change-Logs.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Style of Change Logs - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Change-Logs.html#Change-Logs" title="Change Logs">
<link rel="prev" href="Change-Log-Concepts.html#Change-Log-Concepts"
title="Change Log Concepts">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Syntactic-Conventions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Syntactic-Conventions.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Syntactic-Conventions.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Syntactic-Conventions.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,20 +3,20 @@
<title>Syntactic Conventions - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="Comments.html#Comments" title="Comments">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/System-Functions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/System-Functions.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/System-Functions.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/System-Functions.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>System Functions - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="CPU-Portability.html#CPU-Portability" title="CPU
Portability">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/System-Portability.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/System-Portability.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/System-Portability.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/System-Portability.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>System Portability - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-C.html#Writing-C" title="Writing C">
<link rel="prev" href="Names.html#Names" title="Names">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Trademarks.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Trademarks.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Trademarks.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Trademarks.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Trademarks - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Legal-Issues.html#Legal-Issues" title="Legal Issues">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/User-Interfaces.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/User-Interfaces.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/User-Interfaces.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/User-Interfaces.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>User Interfaces - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<link rel="prev" href="Errors.html#Errors" title="Errors">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Using-Extensions.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Using-Extensions.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Using-Extensions.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Using-Extensions.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,20 +3,20 @@
<title>Using Extensions - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Design-Advice.html#Design-Advice" title="Design Advice">
<link rel="prev" href="Compatibility.html#Compatibility" title="Compatibility">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Utilities-in-Makefiles.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Utilities-in-Makefiles.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Utilities-in-Makefiles.html 8 May 2006 13:26:00 -0000
1.12
+++ html_node/Utilities-in-Makefiles.html 19 Aug 2006 17:43:57 -0000
1.13
@@ -3,20 +3,20 @@
<title>Utilities in Makefiles - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Makefile-Conventions.html#Makefile-Conventions"
title="Makefile Conventions">
<link rel="prev" href="Makefile-Basics.html#Makefile-Basics" title="Makefile
Basics">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/Writing-C.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/Writing-C.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/Writing-C.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/Writing-C.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,19 +3,19 @@
<title>Writing C - GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Program-Behavior.html#Program-Behavior" title="Program
Behavior">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
Index: html_node/index.html
===================================================================
RCS file: /web/www/www/prep/standards/html_node/index.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
--- html_node/index.html 8 May 2006 13:26:00 -0000 1.12
+++ html_node/index.html 19 Aug 2006 17:43:57 -0000 1.13
@@ -3,17 +3,17 @@
<title>GNU Coding Standards</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Coding Standards">
-<meta name="generator" content="makeinfo 4.8">
+<meta name="generator" content="makeinfo 4.8.90">
<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 April 23, 2006.
+The GNU coding standards, last updated August 19, 2006.
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
@@ -140,13 +140,13 @@
<h2 class="unnumbered">Version</h2>
-<p>The GNU coding standards, last updated April 23, 2006.
+<p>The GNU coding standards, last updated August 19, 2006.
<p>Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
<p>Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
+under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no
Front-Cover Texts, and with no Back-Cover Texts.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- www/prep/standards index.html standards.dvi.gz ...,
Karl Berry <=