You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Patrick Spek 446625bf17
Use differing bullet points in lists
8 months ago
bin Improve documentation 8 months ago
lib/Pod/To Use differing bullet points in lists 8 months ago
t Improve documentation 8 months ago
.editorconfig Commit the first version of the module 9 months ago
.gitignore Resolve module names if target is not found as relative file 9 months ago
.gitlab-ci.yml Add dist job to gitlab-ci 9 months ago
.travis.yml Commit the first version of the module 9 months ago
CHANGELOG.md Update CHANGELOG 8 months ago
LICENSE Add new file 9 months ago
META6.json Redo module to clean up codebase 9 months ago
README.adoc Add screenshot URLs to README 9 months ago

README.adoc

= Pod::To::Pager
:toc: preamble

This is a Perl 6 module to convert a Perl 6 Pod document to a more
user-friendly variant for viewing on the shell. It is intended to be piped
through a pager, such as `less`.

== Differences with the default Pod parser

To see the difference with the default Pod parser bundled with `perl6`, run the
following commands and compare the output:

perl6 --doc t/test-program.pl # Default
perl6 -Ilib --doc=Pager t/test-program.pl # Pod::To::Pager variant

You can also check out some screenshots:

- https://i.imgur.com/SfYW4eB.png
- https://i.imgur.com/cEchJ9M.png

=== No declarator blocks

Declarator blocks are ignored by `Pod::To::Pager`. These are useful for
developers, but less so for end users. They also look very out of place in the
rest of the Pod output.

=== More styling

`Pod::To::Pager` uses `Terminal::ANSIColor` to apply more styling than the
default Pod parser. This includes bold, italic or underlined characters, and a
few colors.

== Using it

To use this module for your Pod reading needs, install the module with `zef`:

zef install Pod::To::Pager

This module is bundled with a utility, similar to `p6doc` when used on regular
Perl 6 programs, called `p6man`. This name is chosen because the style of the
output has been heavily inspired by the style of regular man pages found on all
sorts of systems.

p6man t/test-program.pl

== License

This module is distributed under the terms of the GNU Affero GPL license,
version 3.