This is the mail archive of the binutils@sources.redhat.com mailing list for the binutils project.


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

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

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