This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Generation process for cpp.1
- To: Zack Weinberg <zackw at stanford dot edu>
- Subject: Re: Generation process for cpp.1
- From: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Date: Sat, 11 Nov 2000 23:00:56 +0000 (GMT)
- cc: <gcc at gcc dot gnu dot org>
On Sat, 11 Nov 2000, Zack Weinberg wrote:
> months back; pl-1.04 has it. This is no big deal. I also found a
> number of bugs in the texi2pod script, heh.
While fixing things in texi2pod.pl, you might look at the following, which
I think would be useful for generating more manpages with it:
* Do something sensible with section/node headers within the man sections
- it would probably make sense to convert either the section or the node
name into =head2. (invoke.texi is long enough that keeping some of its
internal headers would seem to make sense.)
* When removing cross-references (@xref), cut out the whole sentence -
since there may be trailing wording after the @xref which doesn't make
sense without the @xref itself, and the whole cross-reference probably
points outside the manpage anyway (presumably the reason for removing the
@xref).
* Some sort of way of handling @ifset INTERNALS / @ifclear INTERNALS will
be needed.
--
Joseph S. Myers
jsm28@cam.ac.uk