Hi,
Please retain the CC to 777471-forwar...@bugs.debian.org in your
response, so that the Debian BTS has a record.
When using "fvwm-perllib man", the title of the resulting manpage
shows the title
IO::File=IO(0x22d5320)(3) Fvwm Perl library IO::File=IO(0x22d5320)(3)
with the stringified object reference instead of proper title. This is
caused by the following lines in [fvwm src]/bin/fvwm-perllib.in
open(MANPIPE, $do_cat ? "| pod2text '$file' | $pager" :
"| pod2man --section 3 --release 'fvwm $version$version_info'" .
" --center 'Fvwm Perl library' '$file'" .
" | @SED@ 's/<STANDARD INPUT>/perllib/ig'$man_converter")
or die "Can't open pipe to pod/man viewer\n";
pod2man needs the filename in order to format the title properly,
which is not available when it is used in a pipe. The name can be
explicitly specified by passing the argument "--name" to pod2man.
Upstream of Pod::Man (the backend of pod2man) has stated [1], "the
next version of Pod::Man that will
diagnose parsing POD from standard input without providing --name as
an error, and defaults the title to STDIN if error handling is set to
proceed despite errors."
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=777471 for more
information.
[1] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=777471#17
Regards,
Vincent Chen
