GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
POD2README(1) User Contributed Perl Documentation POD2README(1)

pod2readme - Intelligently generate a README file from POD

    pod2readme [-cfho] [long options...] input-file [output-file] [target]

        Intelligently generate a README file from POD

        -t --target     target type (default: 'readme')
        -f --format     output format (default: 'text')
        -b --backup     backup output file
        -o --output     output filename (default based on target)
        -c --stdout     output to stdout (console)
        -F --force      only update if files are changed
        -h --help       print usage and exit

    pod2readme -f markdown lib/MyApp.pm

This utility will use Pod::Readme to extract a README file from a POD document.

It works by extracting and filtering the POD, and then calling the appropriate filter program to convert the POD to another format.

By default, "pod2readme" will back up the output file. To disable this, use the "--no-backup" option.

Specifies the name of the output file. If omitted, it will use the second command line argument, or default to the "--target" plus the corresponding extension of the "--format".

For all intents, the default is README.

If a format other than "text" is chosen, then the appropriate extension will be added, e.g. for "markdown", the default output file is README.md.

The target of the filter, which defaults to "readme".

The output format, which defaults to "text".

Other supposed formats are "github", "html", "latex", "man", "markdown", "pod", "rtf", and "xhtml". You can also use "gfm" instead of "github". Similary you can use "md" for "markdown".

If enabled, it will output to the console instead of "--output".

By default, the README will be generated if the source files have been changed. Using "--force" will force the file to be updated.

Note: POD format files will always be updated.

Prints the usage and exits.

pod2text, pod2markdown.
2022-04-09 perl v5.32.1

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.