X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fstandards.texi;h=5b565413bc059114226ff292bce73530e928b4a6;hb=349396ebfcce12ee8f927fedf82067414c427093;hp=0f9750c2585ae5d0ebceab554be0a362a2438ff2;hpb=159eae9ff30acac95b6d397f053df8cd6fca62a3;p=gnulib.git diff --git a/doc/standards.texi b/doc/standards.texi index 0f9750c25..5b565413b 100644 --- a/doc/standards.texi +++ b/doc/standards.texi @@ -3,7 +3,7 @@ @setfilename standards.info @settitle GNU Coding Standards @c This date is automagically updated when you save this file: -@set lastupdate January 26, 2009 +@set lastupdate September 14, 2009 @c %**end of header @dircategory GNU organization @@ -313,7 +313,7 @@ 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. +system. @node Compatibility @@ -1092,9 +1092,9 @@ giving the email address for bug reports, the package's home page general page for help using GNU programs. The format should be like this: @example -Report bugs to @var{mailing-address}. -@var{pkg} home page: http://www.gnu.org/software/@var{pkg}/ -General help using GNU software: http://www.gnu.org/gethelp/ +Report bugs to: @var{mailing-address} +@var{pkg} home page: +General help using GNU software: @end example It is ok to mention other appropriate mailing lists and web pages. @@ -3742,15 +3742,10 @@ page explaining that you don't maintain it and that the Texinfo manual is more authoritative. The note should say how to access the Texinfo documentation. -Be sure that man pages include a copyright statement and free -license. The simple all-permissive license is appropriate for simple -man pages: - -@example -Copying and distribution of this file, with or without modification, -are permitted in any medium without royalty provided the copyright -notice and this notice are preserved. -@end example +Be sure that man pages include a copyright statement and free license. +The simple all-permissive license is appropriate for simple man pages +(@pxref{License Notices for Other Files,,,maintain,Information for GNU +Maintainers}). For long man pages, with enough explanation and documentation that they can be considered true manuals, use the GFDL (@pxref{License for @@ -3953,7 +3948,7 @@ is preferable to setting them in environment variables: CC=gcc ./configure @end example as it helps to recreate the same configuration later with -@file{config.status}. +@file{config.status}. However, both methods should be supported. @end table All @code{configure} scripts should accept all of the ``detail'' @@ -4041,7 +4036,7 @@ should contain an explanation of the installation procedure. The @file{README} file should also refer to the file which contains the copying conditions. The GNU GPL, if used, should be in a file called @file{COPYING}. If the GNU LGPL is used, it should be in a file called -@file{COPYING.LIB}. +@file{COPYING.LESSER}. Naturally, all the source files must be in the distribution. It is okay to include non-source files in the distribution, provided they are @@ -4215,5 +4210,5 @@ eval: (add-hook 'write-file-hooks 'time-stamp) time-stamp-start: "@set lastupdate " time-stamp-end: "$" time-stamp-format: "%:b %:d, %:y" -compile-command: "make just-standards" +compile-command: "cd work.s && make" End: