Skip Menu |

This queue is for tickets about the podlators CPAN distribution.

Report information
The Basics
Id: 92979
Status: resolved
Priority: 0/
Queue: podlators

People
Owner: RRA [...] cpan.org
Requestors: Daphne.Pfister [...] genband.com
Cc:
AdminCc:

Bug Information
Severity: (no value)
Broken in: 2.4.1
Fixed in: 4.00



Subject: Changes related to F register broke man pages under hpux.
After the changes in 2.4.1, generated man pages under HPUX's nroff ( 10.20 pa-risc and 11i IA64 ) start with an blank page. Reverting the F register change and regenerated the manual pages fixed the problem for me. Attached the output of nroff -man for the pod2man man page with both the old F register code and the new F register code. Note: The pages were actually generated with a newer version of pod2man, I just manually swapped the F register section back in the preamble. BTW Pod::Man still list itself as 2.28 in generated man files.
Subject: pod2man.cat.new
Download pod2man.cat.new
application/octet-stream 21.2k

Message body not shown because it is not plain text.

Subject: pod2man.cat.old
Download pod2man.cat.old
application/octet-stream 21.1k

Message body not shown because it is not plain text.

From: Daphne.Pfister [...] genband.com
Forgot to attach matching nroff files.
Subject: pod2man.1.old
Download pod2man.1.old
application/octet-stream 16.3k

Message body not shown because it is not plain text.

From: Daphne.Pfister [...] genband.com
On Wed Feb 12 15:28:05 2014, daphnepfister wrote: Show quoted text
> Forgot to attach matching nroff files.
Subject: pod2man.1.new
Download pod2man.1.new
application/octet-stream 16.5k

Message body not shown because it is not plain text.

Subject: Re: [rt.cpan.org #92979] Changes related to F register broke man pages under hpux.
Date: Sat, 30 Aug 2014 16:32:20 -0700
To: bug-podlators [...] rt.cpan.org
From: Russ Allbery <eagle [...] eyrie.org>
"Daphne Pfister via RT" <bug-podlators@rt.cpan.org> writes: Show quoted text
> After the changes in 2.4.1, generated man pages under HPUX's nroff ( > 10.20 pa-risc and 11i IA64 ) start with an blank page. Reverting the F > register change and regenerated the manual pages fixed the problem for > me.
Show quoted text
> Attached the output of nroff -man for the pod2man man page with both the > old F register code and the new F register code.
Show quoted text
> Note: The pages were actually generated with a newer version of pod2man, > I just manually swapped the F register section back in the preamble.
Hi Daphne, Sorry about the delay in responding to this. Could you please try the replacing all of the F register stuff with: .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} .\} and see if that fixes the problem? I'm not sure what's causing the issue that you're seeing and if this will take care of it, but it's at least much simpler and has fewer constructs that might possibly confuse HP-UX nroff. Incidentally, since you have access to this system, could you check something else for me? What happens if you generate a man page with pod2man -u, install it in the man path, and then try to view it with the HP-UX man command? You'll want to install it somewhere and use man, instead of using nroff directly, since man does some magic, or may, to tell nroff about the character set. I want to change the default in podlators to be UTF-8, but I'm not sure if HP-UX nroff will support this. A good POD file to try with this is perlcn.pod, which comes in the pod directory under the Perl module path. Show quoted text
> BTW Pod::Man still list itself as 2.28 in generated man files.
Yeah, the version number of the module was different than the version number of podlators itself for reasons that seemed like a good idea at the time. This will be fixed in the latest release. -- Russ Allbery (eagle@eyrie.org) <http://www.eyrie.org/~eagle/>
Thanks to Carsten Kunze, I found the actual problem. If you replace the code related to the F register in Pod::Man with: .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} it should fix the problem. The error was the missing backslashes after the braces. Thank you for the report!