#292: [CAGE] Update all Pod documentation to use sane, modern headings
---------------------+------------------------------------------------------
 Reporter:  allison  |       Owner:  jkeenan 
     Type:  cage     |      Status:  assigned
 Priority:  normal   |   Milestone:          
Component:  docs     |     Version:  trunk   
 Severity:  medium   |    Keywords:          
     Lang:           |       Patch:          
 Platform:  all      |  
---------------------+------------------------------------------------------

Comment(by allison):

 Our Parrot::Doc::* modules subclass Pod::Simple.

 But, on the whole, I'd rather not put effort into writing Pod parsers in
 Perl 5. We're trying to move toward less Perl 5 code in the repository.

 Oh, BTW, I found the source of the Perl 5 Pod-style. They selected their
 headings to exactly match the required headings for manpages (which made
 sense 20 years ago when that was the primary output from the Pod sources).

-- 
Ticket URL: <https://trac.parrot.org/parrot/ticket/292#comment:10>
Parrot <https://trac.parrot.org/parrot/>
Parrot Development
_______________________________________________
parrot-tickets mailing list
[email protected]
http://lists.parrot.org/mailman/listinfo/parrot-tickets

Reply via email to