I have no idea about how I can make my home-grown specialist scripts (written mostly in Bash and Perl) available through the man pages.What procedure would I have to follow, and is there a particular format that the documentation needs to be written in for me to be able to do this?
How can I add man page entries for my own power tools?
man;documentation
I've found that using Perl's POD is much easier than writing man pages directly, and you can create a man page from the POD file with the pod2man utility (part of the base Perl package).  Since some of your executables are already written in Perl, you can add POD formatting directly to your scripts and they can be turned into POD files directly.  I've also seen several projects use POD format even though their code is written in other languages, due to POD's simplicity.To add an additional directory of man pages, you can set the $MANPATH environment variable.  Prefix $MANPATH with a : to have it added to the list of already-configured man paths.  Use the manpath command to see the currently defined man paths.