Mercurial > hg > octave-lyh > gnulib-hg
changeset 6946:440215b69978
autoupdate
author | Karl Berry <karl@freefriends.org> |
---|---|
date | Mon, 10 Jul 2006 13:16:09 +0000 |
parents | aa195d9ecb02 |
children | ee75ce0d418b |
files | doc/maintain.texi doc/make-stds.texi doc/standards.texi |
diffstat | 3 files changed, 29 insertions(+), 24 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/maintain.texi +++ b/doc/maintain.texi @@ -5,7 +5,7 @@ @c For double-sided printing, uncomment: @c @setchapternewpage odd @c This date is automagically updated when you save this file: -@set lastupdate July 1, 2006 +@set lastupdate July 9, 2006 @c %**end of header @dircategory GNU organization @@ -1380,7 +1380,7 @@ The script @command{gendocs.sh} eases the task of generating the Texinfo documentation output for your web pages section above. It has a companion template file, used as the basis -for the html index pages. Both are available from the Texinfo CVS +for the HTML index pages. Both are available from the Texinfo CVS sources: @format @uref{http://savannah.gnu.org/cgi-bin/viewcvs/texinfo/texinfo/util/gendocs.sh}
--- a/doc/make-stds.texi +++ b/doc/make-stds.texi @@ -264,7 +264,7 @@ and @code{INSTALL_DATA}. (The default for @code{INSTALL_PROGRAM} should be @code{$(INSTALL)}; the default for @code{INSTALL_DATA} should be @code{$@{INSTALL@} -m 644}.) 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: @example @@ -305,9 +305,9 @@ @end example @noindent -Since the value of @code{DESTDIR} is only used during installation, it -should only be supported in the @code{install*} and @code{uninstall*} -targets. +@code{DESTDIR} should be supported only in the @code{install*} and +@code{uninstall*} targets, as those are the only targets where it is +useful. If your installation step would normally install @file{/usr/local/bin/foo} and @file{/usr/local/lib/libfoo.a}, then an @@ -335,8 +335,8 @@ those permissions. Finally, it can be useful with tools such as @code{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 @code{DESTDIR}, -though it is not an absolute requirement. +operations. So, we strongly recommend GNU packages support +@code{DESTDIR}, though it is not an absolute requirement. @node Directory Variables @@ -642,7 +642,7 @@ @item srcdir The directory for the sources being compiled. The value of this variable is normally inserted by the @code{configure} shell script. -(If you are using Autconf, use @samp{srcdir = @@srcdir@@}.) +(If you are using Autoconf, use @samp{srcdir = @@srcdir@@}.) @end table For example: @@ -676,13 +676,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 -@code{docdir}, @code{psdir}, @code{pdfdir}, @code{htmldir}, -@code{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@tie{}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. @node Standard Targets @@ -778,8 +778,9 @@ certainly want to use subdirectories, or two nodes with the same name in different manuals will overwrite each other. -Please make these @code{install-@var{format}} targets depend on the -correspond @var{format} target. +Please make these @code{install-@var{format}} targets invoke the +commands for the @var{format} target, for example, by making +@var{format} a dependency. @item uninstall Delete all the installed files---the copies that the @samp{install} @@ -906,7 +907,11 @@ @itemx html @itemx pdf @itemx 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 @code{all} target; the user must manually invoke them. + Here's an example rule for generating DVI files from Texinfo: @smallexample
--- 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 May 24, 2006 +@set lastupdate July 9, 2006 @c %**end of header @dircategory GNU organization @@ -886,7 +886,7 @@ (preferably @samp{-o} or @samp{--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. @cindex standard command-line options @cindex options, standard command-line @@ -1943,7 +1943,7 @@ @item 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 normally needs a +run, in a non-privileged process, a server that normally needs a reserved port number. @item sort @@ -3001,7 +3001,7 @@ Adding @code{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 -@code{gettext} calls does the job straightfowardly if the code starts +@code{gettext} calls does the job straightforwardly if the code starts out like this: @example @@ -3274,7 +3274,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 manual