Bug 27832 - texi2pod issues
Summary: texi2pod issues
Status: NEW
Alias: None
Product: gcc
Classification: Unclassified
Component: other (show other bugs)
Version: 4.1.0
: P3 normal
Target Milestone: ---
Assignee: Not yet assigned to anyone
URL:
Keywords: documentation
: 28842 (view as bug list)
Depends on:
Blocks:
 
Reported: 2006-05-31 09:33 UTC by Jakub Jelinek
Modified: 2021-08-24 05:27 UTC (History)
3 users (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2006-09-03 05:34:47


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jakub Jelinek 2006-05-31 09:33:08 UTC
The generated gcc.1 man page contais a couple of weird texinfo artefacts,
I suppose the problem is in texi2pod.pl in most cases, but am not 100% sure.
1) @anchor{something} doesn't seem to be handled and makes it all the way
   through into the man page (should it be just nuked for the man page?)
   E.g. in:
       -Wtrigraphs
           @anchor{Wtrigraphs} Most trigraphs in comments cannot affect the meaning of the program.  However, a
2) @pxref{something} makes it all the way through into the man page too
   E.g. in:
       -Wno-deprecated-declarations
           Do not warn about uses of functions, variables, and types marked as deprecated by using the "deprecated"
           attribute.  (@pxref{Function Attributes}, @pxref{Variable Attributes}, @pxref{Type Attributes}.)
3) @item is only handled at the beginning of line, so we have
            @item max-inline-insns-single
             is set to I<n>/2.
            @item max-inline-insns-auto
             is set to I<n>/2.
            @item min-inline-insns
             is set to 130 or I<n>/4, whichever is smaller.
            @item max-inline-insns-rtl
             is set to I<n>.
   Perhaps this should be solved by removing the spaces in invoke.texi.
4) @samp{@@} in the texi source is transformed weirdly:
@samp{;}, and each switch starts with an @samp{@@} instead of the
@samp{-}, without spaces between multiple switches.  This is supposed to
ease shell-processing.
becomes in gcc.pod:
B<;>, and each switch starts with an B<@} instead of the
@samp{->, without spaces between multiple switches.  This is supposed to
ease shell-processing.
Comment 1 Andrew Pinski 2006-08-25 04:52:53 UTC
*** Bug 28842 has been marked as a duplicate of this bug. ***
Comment 2 Andrew Pinski 2006-09-03 05:34:47 UTC
Confirmed.