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]

Re: [patch] remove munging of item from texi2pod.pl


Eric Christopher wrote:

Taking a look at gcc.pod (or gcc.1) we can see that some strings are getting munged:

.IP "@cvmmfu" 4

instead of:

.IP "@bullet" 4

as it should be.

Actually neither of those is right. A bullet list should be =item * in the generated POD, and .IP "\(bu" in the manpage itself.

From what I can tell the munging at the end of itemx isn't really needed and from
an inspection of the generated pod and man pages afterward the only changes
I see are fixing of cases like the above.

I guess we aren't using any numbered lists, then. pod2man is, perhaps deliberately, stupid about numbered lists - you have to do the counting yourself. (podlators author cc:ed for comment.) That is what the code you took out is trying to do.

After quite a bit of staring, I think the right fix is this patch instead:

==================================================================
--- texi2pod.pl	(revision 117491)
+++ texi2pod.pl	(local)
@@ -260,7 +260,7 @@ while(<$inf>) {
	if (defined $1) {
	    $ic = $1;
	} else {
-	    $ic = '@bullet';
+	    $ic = '*';
	}
	$_ = "\n=over 4\n";
	$endw = "itemize";

zw


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