Raku Land

META6::To::Man

META6::To::Man Build Status

Produces a rudimentary UNIX man page from a Perl 6 META6.json (or META.json) file

SYNOPSIS

$ meta6-to-man --meta6=./META6.json

The output file should be a UNIX roff file named '<name>.1' where '<name>' is the 'name' key value in the META6.json file.

USAGE

$ meta6-to-man Usage: ./bin/meta6-to-man --meta6=M [options...] Produces a UNIX 'man' page from data in the Perl 6 META6 file 'M'. The output is written to file 'F.1' where 'F' is the name from the META6 file (which can be changed with the '--man' option below). Mandatory argument: --meta6=M Defines the desired META6.json file to be used. 'M' must be a valid META6 file. Options: --install Installs the output file to one of the standard man directories. The directory actually chosen is the first one found with write privileges for the user. The directories are searched in this order: /usr/share/man/manN /usr/local/share/man/manN /usr/local/man/manN --install-to=D Installs the output file to directory D. --date=YYYY-MM-DD The default is the current date. --man=F Defines the man roff file 'F'. It is an error if the file name does not end in '.N' where 'N' is a digit in the range '1..8'. --quiet Silences all messages. Normally for developer use. --debug Normally for developer use.

The output troff file from running:

perl6 -Ilib ./bin/meta6-to-man --meta6=./META6.json --install-to=./doc

in the top-level directory in this repository can be found here.

MISCELLANEOUS

View a local man page on a POSIX system (e.g., the one you just generated):

man -l <man src file name>.<number>

Example (note 'l' is the lower-case letter 'ell'):

man -l My::Module.1

Man page numbers most likely for Perl 6 modules (from man-pages(7) :

REFERENCES

  1. On a POSIX system:
  1. Writing man pages: https://liw.fi/manpages

LICENSE

Artistic-2.0

COPYRIGHT

Copyright (C) 2017 Thomas M. Browder, Jr. <tom.browder@gmail.com> (IRC #perl6: tbrowder)