This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[PATCH] Fix info viewer error when searching internals doc: Cannot find node `(gccint.info)Cond. Exec. Macros'.


    Hi list,

  Any time I try a search ('/' option in gnu texinfo viewer) in the
gccint.info page, I see the error message quoted in the subject line of this
post.  Nor can I get to that page, neither directly from a menu item, nor by
page down/page up into it from before/after.

  According to the texinfo manual(*), this is not allowed:

> 6.3.4 @node Line Requirements
      [ . . . ]
> Unfortunately, you cannot use periods, commas, colons or parentheses within
> a node name; these confuse the Texinfo processors. Perhaps this limitation
> will be removed some day, too.

  Dunno why this doesn't seem to be causing problems elsewhere, but I have
observed it on both i686-pc-cygwin and x86_64-unknown-linux-gnu.  (I'm using
GNU texinfo 4.13 on cygwin, 4.11 on linux, both of which are well above the
minimum listed in the GCC prerequisites.)

  The attached patch removes the troublesome periods from the node name and
fixes the resulting generated .info file.

gcc/ChangeLog:

	* doc/tm.texi.in (Cond. Exec. Macros): Rename node from this ...
	(Cond Exec Macros): ... to this.
	* doc/tm.texi: Regenerate.

  Built and tested by trying a search and paging through the affected area in
both patched and unpatched versions of the generated info file and observing
the problem solved.  OK?

  (BTW, shouldn't we have a "Documentation" component in bugzilla?)

    cheers,
      DaveK
-- 
(*) -
http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Node-Line-Requirements.html
Index: gcc/doc/tm.texi
===================================================================
--- gcc/doc/tm.texi	(revision 167307)
+++ gcc/doc/tm.texi	(working copy)
@@ -5852,7 +5852,7 @@ interested in most macros in this section.
 @menu
 * CC0 Condition Codes::      Old style representation of condition codes.
 * MODE_CC Condition Codes::  Modern representation of condition codes.
-* Cond. Exec. Macros::       Macros to control conditional execution.
+* Cond Exec Macros::         Macros to control conditional execution.
 @end menu
 
 @node CC0 Condition Codes
@@ -6060,7 +6060,7 @@ same.  If they are, it returns that mode.  If they
 returns @code{VOIDmode}.
 @end deftypefn
 
-@node Cond. Exec. Macros
+@node Cond Exec Macros
 @subsection Macros to control conditional execution
 @findex conditional execution
 @findex predication
Index: gcc/doc/tm.texi.in
===================================================================
--- gcc/doc/tm.texi.in	(revision 167307)
+++ gcc/doc/tm.texi.in	(working copy)
@@ -5836,7 +5836,7 @@ interested in most macros in this section.
 @menu
 * CC0 Condition Codes::      Old style representation of condition codes.
 * MODE_CC Condition Codes::  Modern representation of condition codes.
-* Cond. Exec. Macros::       Macros to control conditional execution.
+* Cond Exec Macros::         Macros to control conditional execution.
 @end menu
 
 @node CC0 Condition Codes
@@ -6044,7 +6044,7 @@ same.  If they are, it returns that mode.  If they
 returns @code{VOIDmode}.
 @end deftypefn
 
-@node Cond. Exec. Macros
+@node Cond Exec Macros
 @subsection Macros to control conditional execution
 @findex conditional execution
 @findex predication

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]