[% setvar title POD needs a reorder command. %]
|Note: these documents may be out of date. Do not use as reference!|
To see what is currently happening visit http://www.perl6.org/
POD needs a reorder command.
Maintainer: Kenneth C. Rich <firstname.lastname@example.org> Date: 12 Sep 2000 Last Modified: 13 Sep 2000 Mailing List: email@example.com Number: 217 Version: 2 Status: Developing
It would be nice to have the order of output be able to differ from the order in the source.
The "=clip" could be "=for", or "=begin" and "=end" with a non-text-processor label.
Sometimes I want a chunk of documentation to hang out near a chunk of code, but the order of the code is not always a good order for a man page.
I dislike overloading the "=for" label with "=print" label functionality.
I'd probably require that "=print" may only occur after the matching "=clip." But I can imagine writing POD processors that deal with "=print" references preceding "=clip" assertions, so I retract that sentence. The "=print" would evaluate into a plain paragraph, so mostly you'd want to use "=print" after another "=command" like "=head1", and so on. For flexibility, an "=print" starting a pod section should effectively evaluate into an "=pod" paragraph.
RFC 5: Multiline Comments for Perl