in reply to trying to create a man page

The perly way is to write your man page as pod and run pod2man on it to get troff formatting. Your errors look as if you wrote the man page as plain text.

After Compline,
Zaxo

Replies are listed 'Best First'.
Re^2: trying to create a man page
by salva (Canon) on Aug 03, 2005 at 10:14 UTC
    ... and once your scripts, configuration files, etc. are documented in pod, pack everything as a perl module for easy distribution and installation, i.e.:
    # create a new module skeleton: $ h2xs -AXn My::App ... $ cd My-App # remove unused lib directory and the module skeleton inside $ rm -Rf lib # create dirs for binaries and documentation $ mkdir bin $ mkdir pod # and move your files there $ mv .../my-scripts.pl bin $ mv .../my-docs.pod pod # recreate the MANIFEST $ rm MANIFEST $ perl Makefile.PL $ make manifest # and update the Makefile.PL to install the scripts # and manual pages automatically: $ vi Makefile.PL
    (read the documentation for EXE_FILES, MAN1POD and MAN3POD inside ExtUtils::MakeMaker).
    # test that everything works $ perl Makefile.PL && make $ su root$ make install $ man my-script # and pack it $ make dist