NAME

podman - a terminal-based structured document viewer for POD and other formats

SYNOPSIS

$ podman my-document.pod

# Understands POD in .pm files
$ podman lib/App/podman.pm

# Search perldoc for page documentation
podman Scalar::Util

$ Understands Markdown files
podman README.md

DESCRIPTION

This script runs the App::podman program, which renders a structured document to a terminal output, via the less pager.

ARGUMENTS

$ podman [FILE]

FILE

If a file path is given, the filename is used to determine if it should be parsed as POD (*.pm or *.pod), or Markdown (*.md). (But see also the -f option).

If the name is not a file, perldoc -l will be used to convert the name of a Perl module into a location for its documentation.

OPTIONS

-f, --format FORMAT

Overrides detection of the file's format by inspecting the filename. Useful for viewing POD out of toplevel scripts whose filename does not indicate a language:

$ podman -f POD bin/podman

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>