Hi Ingo,
Hi Andreas,
Andreas Vögele wrote on Tue, Nov 22, 2011 at 03:34:47PM +0100:
I decided to remove USE_GROFF from the Moose port.
Sounds reasonable for a Perl port, in particular since it seems
you checked the output quality, given the issues you found.
There are two minor issues though. Both groff and mandoc render
"=item B<< >>" as used in Moose's Pod documents wrongly.
Humm. Looking e.g. at Moose::Object.3p, i don't really see a
problem, neither with groff nor with mandoc, and both agree.
Can you explain what exactly is wrong?
An example is attached. mandoc doesn't emphasise the method
declaration's second argument. Groff, on the other hand, underlines the
second argument. This happens with $obj, @obj and %obj, but not with
&obj, for example, so this is probably a bug in pod2man too.
pod2man example.pod | mandoc | less
pod2man example.pod | nroff -man | less -r
Furthermore, mandoc doesn't wrap long URLs.
You mean, as in Moose::Spec::Role.3p, below SEE ALSO, Roles?
Groff doesn't wrap that one either, so both formatters agree.
You're right, Groff also produces long lines.
BTW, see
L<http://blogs.perl.org/users/brian_d_foy/2011/11/help-update-podperldoc.html>.
--
Regards,
Andreas
=over
=item Two arg method B<< $obj->($x, $y) >>
bla.
=item Long URL
L<http://www.gigamonkeys.com/book/object-reorientation-generic-functions.html>
=back
