Philip Newton wrote: > > I'm not sure that this bit of the third quoted paragraphs is correct: > "It's quite possible that switching to an XML docset produces a beautiful, > unmaintained set of documentation that is of no use to anyone." I think > it's more likely that switching to an XML docset produces very little > documentation, and what there is will be of widely varying quality. Not > everyone will want to expend the effort involved to plan out, carefully, > their document structure and produce lovely docs. I am of the opinion that any documentation which requires, or at least would significantly benefit from, the use of something heavy like SGML is best done OUTSIDE THE CODE. There's no reason you can't have document files accompanying the perl code files, for gosh sakes. -- John Porter By pressing down a special key It plays a little melody
- Re: RFC 357 (v1) Perl should... Tad McClellan
- Re: RFC 357 (v1) Perl should... Tom Christiansen
- Re: RFC 357 (v1) Perl should... Tom Christiansen
- Re: RFC 357 (v1) Perl should... Damien Neil
- Re: RFC 357 (v1) Perl should... Graham Barr
- Re: RFC 357 (v1) Perl should... Damien Neil
- Re: RFC 357 (v1) Perl should... Tom Christiansen
- Re: RFC 357 (v1) Perl should... Bart Lateur
- Re: RFC 357 (v1) Perl should... Damien Neil
- Re: RFC 357 (v1) Perl should use XML for document... Philip Newton
- Re: RFC 357 (v1) Perl should use XML for docu... John Porter
- Re: RFC 357 (v1) Perl should use XML for ... Philip Newton
- Re: RFC 357 (v1) Perl should use XML ... Peter Buckingham
- Re: RFC 357 (v1) Perl should use XML ... John Porter
- Re: RFC 357 (v1) Perl should use... Nathan Torkington
- Re: RFC 357 (v1) Perl should use XML ... Andrew Wilson
- Re: RFC 357 (v1) Perl should use XML for documentation... Jonathan Scott Duff
- Re: RFC 357 (v1) Perl should use XML for document... Bart Lateur
- Re: RFC 357 (v1) Perl should use XML for docu... Peter Scott
- Re: RFC 357 (v1) Perl should use XML for document... Johan Vromans
- Re: RFC 357 (v1) Perl should use XML for documentation... Greg Williams