This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: Use makeinfo --html for HTML manuals
- From: Eli Zaretskii <eliz at gnu dot org>
- To: "Joseph S. Myers" <joseph at codesourcery dot com>, Carlos O'Donell <carlos at codesourcery dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Sat, 18 Apr 2009 19:35:57 +0300
- Subject: Re: Use makeinfo --html for HTML manuals
- References: <Pine.LNX.4.64.0904172038520.12227@digraph.polyomino.org.uk>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> Date: Fri, 17 Apr 2009 20:40:20 +0000 (UTC)
> From: "Joseph S. Myers" <joseph@codesourcery.com>
>
> This patch makes the GDB makefiles build HTML manuals using makeinfo
> --html instead of texi2html.
Thanks. I'm okay with this change, but I have one comment.
> +gdb/index.html: ${GDB_DOC_FILES}
> $(MAKEHTML) $(MAKEHTMLFLAGS) -I ${READLINE_DIR} -I ${GDBMI_DIR} -I $(srcdir) $(srcdir)/gdb.texinfo
>
> # Clean these up before each run. Avoids a catch 22 with not being
> @@ -445,7 +456,7 @@
>
> # GDB INTERNALS MANUAL: HTML file
>
> -gdbint_toc.html: $(GDBINT_DOC_FILES)
> +gdbint/index.html: $(GDBINT_DOC_FILES)
> $(MAKEHTML) $(MAKEHTMLFLAGS) $(srcdir)/gdbint.texinfo
>
> stabs.info: $(STABS_DOC_FILES)
> @@ -453,7 +464,7 @@
>
> # STABS DOCUMENTATION: HTML file
>
> -stabs_toc.html: $(STABS_DOC_FILES)
> +stabs/index.html: $(STABS_DOC_FILES)
> $(MAKEHTML) $(MAKEHTMLFLAGS) $(srcdir)/stabs.texinfo
>
> # Clean these up before each run. Avoids a catch 22 with not being
> @@ -495,7 +506,7 @@
> annotate.info: $(ANNOTATE_DOC_FILES)
> $(MAKEINFO) -I $(srcdir) -o annotate.info $(srcdir)/annotate.texinfo
>
> -annotate_toc.html: $(ANNOTATE_DOC_FILES)
> +annotate/index.html: $(ANNOTATE_DOC_FILES)
> $(MAKEHTML) $(MAKEHTMLFLAGS) $(srcdir)/annotate.texinfo
Why the discrepancy wrt the use of the -I $(srcdir) switch between the
commands for different manuals? I'd prefer them all to use that
switch, even if some of them do not @include any other files, to avoid
surprises if we some day add such directives.
Btw, I hear that the next release of Texinfo will ditch makeinfo the C
program and use texi2html instead. (There probably will still be a
wrapper shell script called `makeinfo', for backward compatibility.)
What that will do to all this, is anybody's guess. But we don't need
to worry about this today.