[automake-commit] branch master updated: docs: make dist implies make dvi.

[Karl Berry]

This is an automated email from the git hooks/post-receive script.

karl pushed a commit to branch master
in repository automake.

View the commit online:
https://git.savannah.gnu.org/gitweb/?p=automake.git;a=commitdiff;h=656befe57f70206c627e27cfcfecd81bdf42aefd

The following commit(s) were added to refs/heads/master by this push:
     new 656befe  docs: make dist implies make dvi.
656befe is described below

commit 656befe57f70206c627e27cfcfecd81bdf42aefd
Author: Karl Berry <address@hidden>
AuthorDate: Thu May 7 18:26:33 2020 -0700

    docs: make dist implies make dvi.
    
    This change handles https://bugs.gnu.org/7994.
    
    * doc/automake.texi (Preparing Distributions): make distcheck
    runs make dvi.
    (Auxiliary Programs) <texinfo.tex>: mention
    that make dist runs make dvi, and therefore a TeX system is
    required when Texinfo sources are present. Add @cmindex entries
    for all auxiliary programs while we're here.
---
 doc/automake.texi | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/doc/automake.texi b/doc/automake.texi
index 1b35883..adc44f5 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -1232,8 +1232,8 @@ work:
 @item
 It attempts a full compilation of the package (@pxref{Basic
 Installation}), unpacking the newly constructed tarball, running
-@code{make}, @code{make check}, @code{make install}, as well as
-@code{make installcheck}, and even @code{make dist},
+@code{make}, @code{make dvi}, @code{make check}, @code{make install},
+as well as @code{make installcheck}, and even @code{make dist},
 @item
 it tests VPATH builds with read-only source tree (@pxref{VPATH Builds}),
 @item
@@ -2258,10 +2258,12 @@ source in case you need more recent versions.
 
 @table @code
 @item ar-lib
+@cmindex ar-lib
 This is a wrapper primarily for the Microsoft lib archiver, to make
 it more POSIX-like.
 
 @item compile
+@cmindex compile
 This is a wrapper for compilers that do not accept options @option{-c}
 and @option{-o} at the same time.  It is only used when absolutely
 required.  Such compilers are rare, with the Microsoft C/C++ Compiler
@@ -2272,6 +2274,8 @@ translation where needed: @option{-I}, @option{-L}, 
@option{-l},
 
 @item config.guess
 @itemx config.sub
+@cmindex config.guess
+@cmindex config.sub
 These two programs compute the canonical triplets for the given build,
 host, or target architecture.  These programs are updated regularly to
 support new architectures and fix probes broken by changes in new
@@ -2282,26 +2286,31 @@ you are encouraged to fetch the latest versions of 
these files from
 release.
 
 @item depcomp
+@cmindex depcomp
 This program understands how to run a compiler so that it will
 generate not only the desired output but also dependency information
 that is then used by the automatic dependency tracking feature
 (@pxref{Dependencies}).
 
 @item install-sh
+@cmindex install-sh
 This is a replacement for the @command{install} program that works on
 platforms where @command{install} is unavailable or unusable.
 
 @item mdate-sh
+@cmindex mdate-sh
 This script is used to generate a @file{version.texi} file.  It examines
 a file and prints some date information about it.
 
 @item missing
+@cmindex missing @r{program}
 This wraps a number of programs that are typically only required by
 maintainers.  If the program in question doesn't exist, or seems too old,
 @command{missing} will print an informative warning before failing out,
 to provide the user with more context and information.
 
 @item mkinstalldirs
+@cmindex mkinstalldirs
 This script used to be a wrapper around @samp{mkdir -p}, which is not
 portable.  Now we prefer to use @samp{install-sh -d} when @command{configure}
 finds that @samp{mkdir -p} does not work, this makes one less script to
@@ -2312,19 +2321,26 @@ distributed when @command{automake} finds it in a 
package.  But it is no
 longer installed automatically, and it should be safe to remove it.
 
 @item py-compile
+@cmindex py-compile
 This is used to byte-compile Python scripts.
 
 @item test-driver
+@cmindex test-driver
 This implements the default test driver offered by the parallel
 testsuite harness.
 
 @item texinfo.tex
-Not a program, this file is required for @samp{make dvi}, @samp{make
-ps} and @samp{make pdf} to work when Texinfo sources are in the
-package.  The latest version can be downloaded from
-@url{https://www.gnu.org/software/texinfo/}.
+@cmindex texinfo.tex
+When Texinfo sources are in the package, this file is required for
+@samp{make dvi}, @samp{make ps} and @samp{make pdf}. The latest
+version can be downloaded from
+@url{https://www.gnu.org/software/texinfo/}.  A working @TeX{}
+distribution, or at least a @file{tex} program, is also required.
+Furthermore, @samp{make dist} invokes @samp{make dvi}, so these become
+requirements for making a distribution with Texinfo sources.
 
 @item ylwrap
+@cmindex ylwrap
 This program wraps @command{lex} and @command{yacc} to rename their
 output files.  It also ensures that, for instance, multiple
 @command{yacc} instances can be invoked in a single directory in