Add a comment.

[gnulib.git] / doc / standards.texi

diff --git a/doc/standards.texi b/doc/standards.texi
index 4cb5ed3..e28aa8f 100644 (file)
--- a/doc/standards.texi
+++ b/doc/standards.texi
@@ -3,7 +3,7 @@
 @setfilename standards.info
 @settitle GNU Coding Standards
 @c This date is automagically updated when you save this file:
 @setfilename standards.info
 @settitle GNU Coding Standards
 @c This date is automagically updated when you save this file:

-@set lastupdate February 23, 2008
+@set lastupdate June 10, 2008

 @c %**end of header
 
 @dircategory GNU organization
 @c %**end of header
 
 @dircategory GNU organization


@@ -305,13 +305,17 @@ for a language that is higher level than C.  Often much of the program
 is written in that language, too.  The Emacs editor pioneered this
 technique.
 
 is written in that language, too.  The Emacs editor pioneered this
 technique.
 

-@cindex GUILE
-The standard extensibility interpreter for GNU software is GUILE
+@cindex Guile
+@cindex GNOME and Guile
+The standard extensibility interpreter for GNU software is Guile

 (@uref{http://www.gnu.org/@/software/@/guile/}), which implements the
 (@uref{http://www.gnu.org/@/software/@/guile/}), which implements the

-language Scheme (an especially clean and simple dialect of Lisp).  We
-don't reject programs written in other ``scripting languages'' such as
-Perl and Python, but using GUILE is very important for the overall
-consistency of the GNU system.
+language Scheme (an especially clean and simple dialect of Lisp).
+Guile also includes bindings for GTK+/GNOME, making it practical to
+write modern GUI functionality within Guile.  We don't reject programs
+written in other ``scripting languages'' such as Perl and Python, but
+using Guile is very important for the overall consistency of the GNU
+system.  
+

 
 @node Compatibility
 @section Compatibility with Other Implementations
 
 @node Compatibility
 @section Compatibility with Other Implementations


@@ -1022,6 +1026,7 @@ GNU Lesser General Public License, @url{http://www.gnu.org/@/licenses/@/lgpl.htm
 GNU GPL with the exception for Guile; for example, GPLv3+/Guile means
 the GNU GPL version 3 or later, with the extra exception for Guile.
 
 GNU GPL with the exception for Guile; for example, GPLv3+/Guile means
 the GNU GPL version 3 or later, with the extra exception for Guile.
 

+@item GPL/Ada

 GNU GPL with the exception for Ada.
 
 @item Apache
 GNU GPL with the exception for Ada.
 
 @item Apache


@@ -1140,10 +1145,10 @@ and @code{unexpand}.
 @samp{-v} in @code{gawk}.
 
 @item assume-new
 @samp{-v} in @code{gawk}.
 
 @item assume-new

-@samp{-W} in Make.
+@samp{-W} in @code{make}.

 
 @item assume-old
 
 @item assume-old

-@samp{-o} in Make.
+@samp{-o} in @code{make}.

 
 @item auto-check
 @samp{-a} in @code{recode}.
 
 @item auto-check
 @samp{-a} in @code{recode}.


@@ -1265,7 +1270,7 @@ Used in @code{tar} and @code{cpio}.
 @samp{-d} in @code{touch}.
 
 @item debug
 @samp{-d} in @code{touch}.
 
 @item debug

-@samp{-d} in Make and @code{m4};
+@samp{-d} in @code{make} and @code{m4};

 @samp{-t} in Bison.
 
 @item define
 @samp{-t} in Bison.
 
 @item define


@@ -1312,7 +1317,7 @@ specially.
 @samp{-X} in @code{strip}.
 
 @item dry-run
 @samp{-X} in @code{strip}.
 
 @item dry-run

-@samp{-n} in Make.
+@samp{-n} in @code{make}.

 
 @item ed
 @samp{-e} in @code{diff}.
 
 @item ed
 @samp{-e} in @code{diff}.


@@ -1330,7 +1335,7 @@ specially.
 @samp{-N} in @code{diff}.
 
 @item environment-overrides
 @samp{-N} in @code{diff}.
 
 @item environment-overrides

-@samp{-e} in Make.
+@samp{-e} in @code{make}.

 
 @item eof
 @samp{-e} in @code{xargs}.
 
 @item eof
 @samp{-e} in @code{xargs}.


@@ -1382,9 +1387,8 @@ Used in GDB.
 @samp{-E} in @code{m4}.
 
 @item file
 @samp{-E} in @code{m4}.
 
 @item file

-@samp{-f} in @code{info}, @code{gawk}, Make, @code{mt}, and @code{tar};
-@samp{-n} in @code{sed};
-@samp{-r} in @code{touch}.
+@samp{-f} in @code{gawk}, @code{info}, @code{make}, @code{mt},
+@code{sed}, and @code{tar}.

 
 @item field-separator
 @samp{-F} in @code{gawk}.
 
 @item field-separator
 @samp{-F} in @code{gawk}.


@@ -1496,7 +1500,7 @@ In @code{makeinfo}, output HTML.
 @samp{-i} in @code{diff} and @code{wdiff}.
 
 @item ignore-errors
 @samp{-i} in @code{diff} and @code{wdiff}.
 
 @item ignore-errors

-@samp{-i} in Make.
+@samp{-i} in @code{make}.

 
 @item ignore-file
 @samp{-i} in @code{ptx}.
 
 @item ignore-file
 @samp{-i} in @code{ptx}.


@@ -1524,7 +1528,7 @@ In @code{makeinfo}, output HTML.
 @samp{-I} in @code{m4}.
 
 @item include-dir
 @samp{-I} in @code{m4}.
 
 @item include-dir

-@samp{-I} in Make.
+@samp{-I} in @code{make}.

 
 @item incremental
 @samp{-G} in @code{tar}.
 
 @item incremental
 @samp{-G} in @code{tar}.


@@ -1558,13 +1562,13 @@ init file.
 Used in @code{date}
 
 @item jobs
 Used in @code{date}
 
 @item jobs

-@samp{-j} in Make.
+@samp{-j} in @code{make}.

 
 @item just-print
 
 @item just-print

-@samp{-n} in Make.
+@samp{-n} in @code{make}.

 
 @item keep-going
 
 @item keep-going

-@samp{-k} in Make.
+@samp{-k} in @code{make}.

 
 @item keep-files
 @samp{-k} in @code{csplit}.
 
 @item keep-files
 @samp{-k} in @code{csplit}.


@@ -1605,7 +1609,7 @@ Used in @code{gawk}.
 @samp{-N} in @code{ls}.
 
 @item load-average
 @samp{-N} in @code{ls}.
 
 @item load-average

-@samp{-l} in Make.
+@samp{-l} in @code{make}.

 
 @item login
 Used in @code{su}.
 
 @item login
 Used in @code{su}.


@@ -1623,7 +1627,7 @@ Used in @code{uname}.
 @samp{-d} in @code{cpio}.
 
 @item makefile
 @samp{-d} in @code{cpio}.
 
 @item makefile

-@samp{-f} in Make.
+@samp{-f} in @code{make}.

 
 @item mapped
 Used in GDB.
 
 @item mapped
 Used in GDB.


@@ -1638,7 +1642,7 @@ Used in GDB.
 @samp{-l} in @code{xargs}.
 
 @item max-load
 @samp{-l} in @code{xargs}.
 
 @item max-load

-@samp{-l} in Make.
+@samp{-l} in @code{make}.

 
 @item max-procs
 @samp{-P} in @code{xargs}.
 
 @item max-procs
 @samp{-P} in @code{xargs}.


@@ -1674,10 +1678,10 @@ Used in GDB.
 @samp{-a} in @code{shar}.
 
 @item new-file
 @samp{-a} in @code{shar}.
 
 @item new-file

-@samp{-W} in Make.
+@samp{-W} in @code{make}.

 
 @item no-builtin-rules
 
 @item no-builtin-rules

-@samp{-r} in Make.
+@samp{-r} in @code{make}.

 
 @item no-character-count
 @samp{-w} in @code{shar}.
 
 @item no-character-count
 @samp{-w} in @code{shar}.


@@ -1704,7 +1708,7 @@ Used in GDB.
 @samp{-2} in @code{wdiff}.
 
 @item no-keep-going
 @samp{-2} in @code{wdiff}.
 
 @item no-keep-going

-@samp{-S} in Make.
+@samp{-S} in @code{make}.

 
 @item no-lines
 @samp{-l} in Bison.
 
 @item no-lines
 @samp{-l} in Bison.


@@ -1779,7 +1783,7 @@ Used in GDB.
 @samp{-o} in @code{tar}.
 
 @item old-file
 @samp{-o} in @code{tar}.
 
 @item old-file

-@samp{-o} in Make.
+@samp{-o} in @code{make}.

 
 @item one-file-system
 @samp{-l} in @code{tar}, @code{cp}, and @code{du}.
 
 @item one-file-system
 @samp{-l} in @code{tar}, @code{cp}, and @code{du}.


@@ -1864,10 +1868,10 @@ Used in @code{tar} and @code{cp}.
 @samp{-L} in @code{cmp}.
 
 @item print-data-base
 @samp{-L} in @code{cmp}.
 
 @item print-data-base

-@samp{-p} in Make.
+@samp{-p} in @code{make}.

 
 @item print-directory
 
 @item print-directory

-@samp{-w} in Make.
+@samp{-w} in @code{make}.

 
 @item print-file-name
 @samp{-o} in @code{nm}.
 
 @item print-file-name
 @samp{-o} in @code{nm}.


@@ -1888,7 +1892,7 @@ Specify an HTTP proxy.
 @samp{-X} in @code{shar}.
 
 @item question
 @samp{-X} in @code{shar}.
 
 @item question

-@samp{-q} in Make.
+@samp{-q} in @code{make}.

 
 @item quiet
 Used in many programs to inhibit the usual output.  Every
 
 @item quiet
 Used in many programs to inhibit the usual output.  Every


@@ -1914,7 +1918,7 @@ Used in @code{gawk}.
 Used in GDB.
 
 @item recon
 Used in GDB.
 
 @item recon

-@samp{-n} in Make.
+@samp{-n} in @code{make}.

 
 @item record-number
 @samp{-R} in @code{tar}.
 
 @item record-number
 @samp{-R} in @code{tar}.


@@ -1923,8 +1927,8 @@ Used in GDB.
 Used in @code{chgrp}, @code{chown}, @code{cp}, @code{ls}, @code{diff},
 and @code{rm}.
 
 Used in @code{chgrp}, @code{chown}, @code{cp}, @code{ls}, @code{diff},
 and @code{rm}.
 

-@item reference-limit
-Used in @code{makeinfo}.
+@item reference
+@samp{-r} in @code{touch}.

 
 @item references
 @samp{-r} in @code{ptx}.
 
 @item references
 @samp{-r} in @code{ptx}.


@@ -2056,7 +2060,7 @@ a directory to start processing with.
 @samp{-S} in @code{shar}.
 
 @item stop
 @samp{-S} in @code{shar}.
 
 @item stop

-@samp{-S} in Make.
+@samp{-S} in @code{make}.

 
 @item strict
 @samp{-s} in @code{recode}.
 
 @item strict
 @samp{-s} in @code{recode}.


@@ -2126,7 +2130,7 @@ Specify how long to wait before giving up on some operation.
 @samp{-c} in @code{du}.
 
 @item touch
 @samp{-c} in @code{du}.
 
 @item touch

-@samp{-t} in Make, @code{ranlib}, and @code{recode}.
+@samp{-t} in @code{make}, @code{ranlib}, and @code{recode}.

 
 @item trace
 @samp{-t} in @code{m4}.
 
 @item trace
 @samp{-t} in @code{m4}.


@@ -2191,7 +2195,7 @@ Print the version number.
 @samp{-V} in @code{tar}.
 
 @item what-if
 @samp{-V} in @code{tar}.
 
 @item what-if

-@samp{-W} in Make.
+@samp{-W} in @code{make}.

 
 @item whole-size-limit
 @samp{-l} in @code{shar}.
 
 @item whole-size-limit
 @samp{-l} in @code{shar}.