I wrote a pod2rtf once upon a time.  It's not a CPAN, because I keep
meaning to rewrite it.  But the other day I skimmed the code and noticed
some of the features that made it rather nice.  I mention this so that
authors of other formatters might consider them:

* widows-and-orphans control is turned on.  (Mercifully this is just a
matter of saying "\widowctrl" at the appropriate point.)

* the page numbering is turned on, and the header is "[modulename] p.
[pagenumber]".  The modulename is gotten from the start of the paragraph
after the first "=head1 NAME".  (If there's no such parapgraph, you get
just "p. [pagenumber]"

* Headings get a "\keepn" code, which keeps them together with the next
paragraph (i.e., so you can't get a pagebreak between a heading and the
paragraph after it).

* "=item foo" paragraphs get a "\keepn" too, if the thing immediately
afterward is a plain paragraph.

* each verbatim paragraph of under 15 lines long gets a "\keep", which
keeps it from being broken across pages.

* things that look like Perl symbols (things containing $,@,%,:,<,>,\,(, or
*, basically) get wrapped in the "do not spellcheck this" code ("{\noproof
....}")



--
Sean M. Burke    [EMAIL PROTECTED]    http://www.spinn.net/~sburke/

Reply via email to