Bug#777405: perl: pod2man puts object references into man page headers when used inside a pipe

[Russ Allbery]

Russ Allbery <rra at debian.org> writes:
> Axel Beckert <abe at debian.org> writes:

>> Some context information: The man pages are build by using pod2man
>> inside a pipe. From wml_frontend/Makefile.in:

>> |     69 .src.1:
>> |     70         cp $< $*.pod
>> |     71         cat $*.pod | sed -e 's|\@WML_VERSION\@|$(WML_VERSION)|g' | \
>> |     72                 pod2man --section=1 --center="EN Tools" --release="EN Tools" > $@
>> |     73         rm -f $*.pod

> You need to tell pod2man what the title of the man page is, using the
> --name flag.  Given a pipe, it has no idea what to use for that field
> unless you tell it.

> A stringified IO::File object is probably a minor aesthetic bug, and I
> can replace it with a constant string, but it's still going to be
> something useless (which in turn is going to cause other issues) unless
> you provide --name.

I've committed a change for 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.

-- 
Russ Allbery (rra at debian.org)               <http://www.eyrie.org/~eagle/>