From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-63091-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 11146 invoked by alias); 18 Apr 2009 16:36:09 -0000
Received: (qmail 11136 invoked by uid 22791); 18 Apr 2009 16:36:08 -0000
X-SWARE-Spam-Status: No, hits=0.7 required=5.0 	tests=AWL,BAYES_00,RCVD_IN_JMF_BL,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout3.012.net.il (HELO mtaout3.012.net.il) (84.95.2.7)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sat, 18 Apr 2009 16:35:58 +0000
Received: from conversion-daemon.i_mtaout3.012.net.il by i_mtaout3.012.net.il (HyperSendmail v2004.12) id <0KIB00J000C2I900@i_mtaout3.012.net.il> for gdb-patches@sourceware.org; Sat, 18 Apr 2009 19:35:55 +0300 (IDT)
Received: from HOME-C4E4A596F7 ([77.124.144.191]) by i_mtaout3.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KIB00DWJ23U0P30@i_mtaout3.012.net.il>; Sat, 18 Apr 2009 19:35:55 +0300 (IDT)
Date: Sat, 18 Apr 2009 16:36:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: Use makeinfo --html for HTML manuals
In-reply-to: <Pine.LNX.4.64.0904172038520.12227@digraph.polyomino.org.uk>
To: "Joseph S. Myers" <joseph@codesourcery.com>, Carlos O'Donell <carlos@codesourcery.com>
Cc: gdb-patches@sourceware.org
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <83iql1j4wi.fsf@gnu.org>
References: <Pine.LNX.4.64.0904172038520.12227@digraph.polyomino.org.uk>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2009-04/txt/msg00485.txt.bz2

> 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.