You may be interested in looking at the macros to format man pages
These macros are for nroff/troff
document formatting utilities (pretty much every man page is written with these macros).
It's useful if you're adding "local" software -- where local
means your home directory or /usr/local
-- to create a standard man tree something like this
mkdir man1 man2 man3 man4 man5 man6 man7 man8 man9
(or do the same thing in your /home directory, just don't do it as root).
Software packages you build from a download typically defaults to /usr/local
. This is not a bad thing, in fact, it's a good thing. When you do make install
the package, generally with manual page(s), it gets installed in /usr/local
(unless you've overridden it).
You can add additional trees to the MANPATH environment variable in your ~/.profile
file (or ~/.bashrc
or whatever) with something like
is usually defined by default). You only need to define the base man
directory, not the individual sections -- the man
utility will search all of those automatically.
Hope this helps some.