On Fri, Feb 05, 2010 at 03:43:04PM -0500, Austin Hastings wrote: > Second, POD is not XML, and it definitely isn't DOCBOOK. Why do I > need magic reserved words like TOC and APPENDIX? I'm not writing a > book, I'm writing code. And if I was writing a book, I wouldn't be > dumb enough to write it in POD.
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. Pm
