| Subject: | Options to disable "the XXXX manpage" |
While on the surface it would appear usefull to convert L<Foo::Bar> to "the Foo::Bar manpage", sometimes it can make life a lot more difficult, especially when you are using L<XXXX> like a normal word. For example
=pod
=head2 parent
The C<parent> method finds and returns the parent L<Foo::Bar> object for this object.
=cut
Becomes "The parent method finds and returns the parent the Foo::Bar manpage object for this object".
Doing a quick count through a couple of thousand lines of docs, I find that 95% of the time ( at least in my case ) it would be better without "the manpage". To make it act the way I want, I would have to write L<Foo::Bar|Foo::Bar> in 19 out of 20 cases.
It would be nice if there was an options, something like -themanpage ( enabled by default ) to disable the automatic "the manpage"ing of the links.
Thanks
Adam K