[% setvar title POD needs a reorder command. %]

This file is part of the Perl 6 Archive

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 <kenrich@mail.rochester.edu>
  Date: 12 Sep 2000
  Last Modified: 13 Sep 2000
  Mailing List: perl6-language@perl.org
  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.


Syntax suggestions:

=clip optional-label




=print required-label-from-clip


The "=clip" could be "=for", or "=begin" and "=end" with a non-text-processor label.


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