pom21p
Convert pod to text, html, etc., with pod::pom
Usage
pom2 text
MyFile.pm
>
MyFile.txt
pom2 html
MyFile.pm
>
MyFile.html
pom2 pod
MyFile.pm
>
Myfile.pod
pom2 format
[options]
MyFile.pm
>
Myfile.xyz
Overview
This script uses "Pod::POM" to convert a Pod document into text, HTML, back into Pod (e.g. to normalise a document to fix any markup errors), or any other format for which you have a view module.
If the viewer is not one of the viewers bundled with "Pod::POM", the script searches for an installed "Pod::POM::View" module that matches the specified format. For example if you have "Pod::POM::View::DocBook" installed then you could say:
pod2 docbook MyFile.pm > MyFile.xmlIf any options other than "--help" are specified then they are passed to the constructor method of the view class. For example:
pod2 docbook --root=chapter --titlecasing MyFile.pm > MyFile.xmlwould convert the Pod document to a DocBook chapter document with the titlecasing option enabled. Note that any string prefixed by ""--"" is taken as a valid option and passed to the constructor; if no value is specified then a value of 1 is passed in.
Version
This is version 0.3 of pom2.
Releases
11 releases since Debian 3.1 (Sarge); the text changed 7 times.