Branches: main, 10.04
Fix bug #153.
An empty table of contents (TOC) would be generated in the PDF version of the
user's guide. This is caused when the user_guide.pdf make rule is executed
before the user_guide.dvi_log rule. pdftexi executes tex only once, therefore
it is not able to generate the TOC. Executing the .dvi_log rule before the
.pdf rule solves this problem because texinfo (used to create the .dvi) runs
tex the correct number of times.
doc/Mmakefile:
Make %.dvi_log a dependency of %.pdf so that pdftex can use the TOC
generated by texinfo.
doc/texinfo.tex:
Update the version of texinfo, the existing version was from 1999. Some
users reported having invalid TOCs when using older versions of texinfo.
Estimated hours taken: 0.5
Branches: main
doc/texinfo.tex:
Update to the version from GNU TexInfo 4.0.
doc/*.texi:
Move the table of contents from the end of the document
to the start of the document (just after the title page).
The only reason that it was at the end was that previous
versions of TexInfo didn't support putting it at the start.
Estimated hours taken: 0.25
doc/texinfo.tex:
Change the annoying warning message about the Tex 3.0 incompatibility
so that it does not contain the string '**'; this makes it easier
to grep the log files for error messages from Mmake.
Estimated hours taken: 2
Add support for `install-info' and related TexInfo innovations.
configure.in:
Check for the `install-info' command.
doc/Mmakefile:
If we have `install-info', use it to install the entry
for mercury.info file in the .../info/dir file.
doc/mercury.info:
Add *INFO-DIR* commands, so that `install-info' works properly.
doc/*.texi:
Add @direntry and @dircategory commands, so that
`install-info' works properly.
(The initial version of this patch was provided by
Marko Schuetz <marko@ki.informatik.uni-frankfurt.de>.)
This replaces the old technique of hard-coding the *INFO-DIR*
info commands, inside `@ifinfo'.
Note that currently the Mmakefile does not actually invoke
install-info on all the info files; currently it only does that
for the menu file mercury.info, since it seems more polite to
just add a single entry in the top-level directory rather than
one for every single piece of Mercury-related documentation.
The change here to *.texi is just in case we should ever
decide to reverse that policy decision, or in case any other
tools that process info files start to make use of the
@direntry or @dircategory commands.
doc/texinfo.tex:
Update to the version from GNU texinfo 3.12, so that it
supports the @direntry and @dircategory commands.
