Bug#722539: mention random headers are generated

[Russ Allbery]

jidanni at jidanni.org writes:

> Ah, perhaps on the man page there then just add
> "(use -t to avoid random header needed for nroff(1))"
> or something.

Thinking about it some more, the behavior that you want could also be
achieved by having perldoc -f pass the following arguments to the Pod::Man
constructor:

    name    => '<function>',
    section => '3',
    center  => 'Excerpt from perlfunc(1)',

You'd still get the header, which is sort of weird, but it would instead
look like:

SPRINTF(3)                 Excerpt from perlfunc(1)                 SPRINTF(3)

which is a little less weird.

You unforunately can't really get rid of the FOO(n) thing as long as the
formatting is being done by nroff -man.

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