[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

html version of the manual

From: Ralf Wildenhues
Subject: html version of the manual
Date: Tue, 14 Mar 2006 19:44:47 +0100
User-agent: Mutt/1.5.9i

`make html' invokes
  texi2html -split_chapter $(srcdir)/autoconf.texi

to create a multi-page HTML version of the manual.  Issues
observed with texi2html 1.64 (as distributed with tetex-2.0.2):
- The @insertcopying is not replaced.  Presumably this is
  why the web page does not link to a copy of the manual
  (which is very unfortunate, by the way).
- The URLs from the Contents to some Indices are wrong
  (they all point in the file of the first Index, but
  the Indices consist of several files; for example the M4
  macro index is not reachable).

Both issues seem to be fixed in texi2html 1.76 which comes with the
development version of teTeX.  That one issues these warnings:

| ** Unknown command address@hidden' (left as is) (l. 8)
| ** Unknown command address@hidden' (left as is) (l. 9477)
| ** Unknown command address@hidden' (left as is) (l. 17396)
| ** Unknown command address@hidden' (left as is) (l. 17431)
| ** Unknown command address@hidden' (left as is) (l. 17479)
| ** Unknown command address@hidden' (left as is) (l. 17487)

OK to apply the trivial patch below to fix these and remove the
corresponding bogus output?

FWIW, makeinfo (GNU texinfo) 4.8 works to produce HTML with 
  makeinfo --html $(srcdir)/autoconf.texi

but has the following issues:
- tidy complains that makeinfo does not escape the ampersand in
  title="Program & Function Index".
- makeinfo does a suboptimal job at converting the definition of
  AT_CHECK, which is unique in that it has an empty default value for
    @dvar{stdout, @samp{}}
  (texi2html 1.64 moves one of the quotes past the closing bracket, 1.76
  has this fixed though; makeinfo outputs two different types of quotes).
  I wonder whether that could be worked around in the definition of @dvar.

I'd happily write a (one or several) bug reports to respective packages
if someone could confirm all/some of these to be bugs not in Autoconf.

Note that the patch below seems to have no impact upon output created by
`makeinfo --html'.  Also note I have updated to current texinfo.tex
before doing any of this.


        * doc/autoconf.texi (contents): To fix texi2html output, hide
        address@hidden' for HTML.
        (Writing Autoconf Macros): Likewise, insert space after address@hidden'.
        (Leviticus, Numbers, Deuteronomy): Likewise, change `@,c' to

Index: doc/autoconf.texi
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.965
diff -u -r1.965 autoconf.texi
--- doc/autoconf.texi   14 Mar 2006 16:55:27 -0000      1.965
+++ doc/autoconf.texi   14 Mar 2006 18:38:54 -0000
@@ -5,7 +5,9 @@
 @include version.texi
 @settitle Autoconf
 @setchapternewpage odd
address@hidden ifnothtml
 @c @ovar(ARG, DEFAULT)
@@ -9479,7 +9481,7 @@
 @end defmac
address@hidden Writing Autoconf Macros.
address@hidden =================================================== Writing 
Autoconf Macros.
 @node Writing Autoconf Macros
 @chapter Writing Autoconf Macros
@@ -17398,7 +17400,7 @@
 the Holy Grail of portability (er, that is, alpha testers) to give me
 feedback as I encapsulated pieces of my handwritten scripts in M4 macros
 and continued to add features and improve the techniques used in the
-checks.  Prominent among the testers were Fran@,cois Pinard, who came up
+checks.  Prominent among the testers were Fran@,{c}ois Pinard, who came up
 with the idea of making an Autoconf shell script to run M4
 and check for unresolved macro calls; Richard Pixley, who suggested
 running the compiler instead of searching the file system to find
@@ -17433,7 +17435,7 @@
 More development occurred as people put Autoconf under more stresses
 (and to uses I hadn't anticipated).  Karl Berry added checks for X11.
-david zuhn contributed C++ support.  Fran@,cois Pinard made it diagnose
+david zuhn contributed C++ support.  Fran@,{c}ois Pinard made it diagnose
 invalid arguments.  Jim Blandy bravely coerced it into configuring
 @acronym{GNU} Emacs, laying the groundwork for several later improvements.
 Roland McGrath got it to configure the @acronym{GNU} C Library, wrote the
@@ -17481,7 +17483,7 @@
 ambiguous, always printing a result.  I regularized the names of the
 macros and cleaned up coding style inconsistencies.  I added some
 auxiliary utilities that I had developed to help convert source code
-packages to use Autoconf.  With the help of Fran@,cois Pinard, I made
+packages to use Autoconf.  With the help of Fran@,{c}ois Pinard, I made
 the macros not interrupt each others' messages.  (That feature revealed
 some performance bottlenecks in @acronym{GNU} M4, which he hastily
 corrected!)  I reorganized the documentation around problems people want
@@ -17489,7 +17491,7 @@
 Autoconf has a pronounced tendency to regress when we change it.
 Again, several alpha testers gave invaluable feedback, especially
-Fran@,cois Pinard, Jim Meyering, Karl Berry, Rob Savoye, Ken Raeburn,
+Fran@,{c}ois Pinard, Jim Meyering, Karl Berry, Rob Savoye, Ken Raeburn,
 and Mark Eichin.
 Finally, version 2.0 was ready.  And there was much rejoicing.  (And I

reply via email to

[Prev in Thread] Current Thread [Next in Thread]