On Wednesday 10 February 2010 at 13:49, Patrick R wrote:
> Actually, it's worth noting that (a slightly modified version of)
> Perl 5 POD has indeed been used to write several substantial
> books. I'd be very sad if (Perl 6) POD couldn't be easily used
> or converted into something that can be used to generate manual
> pages and reference documentation.
I've written and edited several of these books. I'm happy to discuss features
and misfeatures and scaffolding I've used to make POD suitable for writing and
editing books. Perl 5 POD isn't too far off, but it does lack some important
features.
For the curious, the Modern Perl Github repository has a book in progress; see
the tools/ directory for some hint of the necessary scaffolding:
http://github.com/chromatic/modern_perl_book/
(Writing a book isn't too far different from writing documentation; many
similar concerns apply.)
-- c
