This is the mail archive of the
binutils@sources.redhat.com
mailing list for the binutils project.
Re: man pages not regenerated
Hi!
Russ Allbery a écrit :
>
> Stephane Carrez <Stephane.Carrez@worldnet.fr> writes:
>
> > So, when the man pages are created, an error is raised. Unfortunately
> > it is ignored by make due to the '-'. The make rules come from GCC. I
> > think they put a '-' because texi2pod.pl and pod2man sometimes raise an
> > error where there is no problem (problems seem to be in pod2man).
>
> I'm the maintainer of pod2man; if you can point me at where this happens,
> I can try to get it fixed in later versions.
>
There are some minor problems with pod2man (some annoying). After a close
look, it seems that pod2man exits with 0 even if it reports an error.
So, as far as the make '-' is concerned, it does not hurt (so, this '-'
is a mystery for me).
Some list of minor problems:
- pod2man often generates this kind of error:
pod2man: bad option in paragraph 4 of gprof.pod: ``-I'' should be [CB]<-I>
This is true for lots of man pages generated from binutils.texi, as.texi
and also invoke.texi in gcc tree.
- When building gcc.1 man page, it generates:
pod2man: Unrecognized pod directive in paragraph 1185 of gcc.pod: head3
head3 does not appear in perlpod. May be it could be introduced?
- In the generated man page, there is the following for nroff:
.if n .na
and this makes the resulting man page not standard, and different from
others (on a RedHat 6.2 system, gtroff 1.15). It would be good to
either remove that or have an option to enable/disable that. The output
looks better when paragraph are filled.
- At the end of the generated man page, there is a list of .IX index
commands. In this list, there is a spurious \n between the .IXes.
This is annoying because for some man pages this creates a spurious
blank page. (see patch attach that solves this problem).
If you can address these minor problems, it would be great.
Stephane
-----------------------------------------------------------------------
Home Office
E-mail: stcarrez@worldnet.fr Stephane.Carrez@sun.com
WWW: http://home.worldnet.fr/stcarrez http://www.sun.com
Mail: 17, rue Foucher Lepelletier 6, avenue Gustave Eiffel
92130 Issy Les Moulineaux 78182 Saint Quentin en Yvelines
France
--- /usr/bin/pod2man Wed Feb 2 21:38:57 2000
+++ /home/ciceron/bin/pod2man Sat Mar 31 14:17:38 2001
@@ -540,7 +540,7 @@ push(@Indices, qq{.IX Title "$name $sect
while (($name, $desc) = each %namedesc) {
for ($name, $desc) { s/^\s+//; s/\s+$//; }
- push(@Indices, qq(.IX Name "$name - $desc"\n));
+ push(@Indices, qq(.IX Name "$name - $desc"));
}
print <<'END';
@@ -868,11 +868,11 @@ while (<>) {
s/\s+$//;
delete $wanna_see{$_} if exists $wanna_see{$_};
print qq{.SH "$_"\n};
- push(@Indices, qq{.IX Header "$_"\n});
+ push(@Indices, qq{.IX Header "$_"});
}
elsif ($Cmd eq 'head2') {
print qq{.Sh "$_"\n};
- push(@Indices, qq{.IX Subsection "$_"\n});
+ push(@Indices, qq{.IX Subsection "$_"});
}
elsif ($Cmd eq 'over') {
push(@indent,$indent);
@@ -891,7 +891,7 @@ while (<>) {
s/[^"]""([^"]+?)""[^"]/'$1'/g;
# here do something about the $" in perlvar?
print STDOUT qq{.Ip "$_" $indent\n};
- push(@Indices, qq{.IX Item "$_"\n});
+ push(@Indices, qq{.IX Item "$_"});
}
elsif ($Cmd eq 'pod') {
# this is just a comment