[comp.sys.mips] help with local man pages

hartzell@boulder.colorado.edu (George Hartzell) (08/22/89)

I am running RISCos 4.01 on an M-2000.  Could some kind soul out there
who is more familiar with how system V aranges its man pages tell me
where I should put my local man pages so that man will find them.
I've tried creating a directory and pointing the environment variable 
MANPATH at it, to no avail.  I rtfm'd, but maybe I missed something.
g.
George Hartzell			                  (303) 492-4535
 MCD Biology, University of Colorado-Boulder, Boulder, CO 80309
hartzell@Boulder.Colorado.EDU  ..!{ncar,nbires}!boulder!hartzell

lgy@blake.acs.washington.edu (Laurence Yaffe) (08/22/89)

In article <10915@boulder.Colorado.EDU> hartzell@boulder.colorado.edu (George Hartzell) writes:
>I am running RISCos 4.01 on an M-2000.  Could some kind soul out there
>who is more familiar with how system V aranges its man pages tell me
>where I should put my local man pages so that man will find them.
>I've tried creating a directory and pointing the environment variable 
>MANPATH at it, to no avail.  I rtfm'd, but maybe I missed something.
>g.
>George Hartzell			                  (303) 492-4535
> MCD Biology, University of Colorado-Boulder, Boulder, CO 80309
>hartzell@Boulder.Colorado.EDU  ..!{ncar,nbires}!boulder!hartzell


    Ah yes...  I wasted several hours on this one.
I believe that the following is correct:

1) Unformatted man pages will be successfully found if placed in /usr/man/man?.
   So you may create /usr/man/manl either as a directory or a symbolic link
   to some other directory.

2) Formatted man pages will be successfully found if placed in
   /usr/man/catman/?_man/man? PROVIDED /usr/man/?_man is a symbolic link
   pointing to catman/?_man.

3) I believe that you can also use the MANPATH environment variable, but
   I forget the details.

My setup is shown below.  I place formatted man pages for locally installed
commands in /usr/local/man/man1.  It works.

/usr/man:
total 80
l---------  1 man            12 Mar 16 17:45 a_man -> catman/a_man
drwxrwxr-x  5 bin           512 Jul  4 16:06 catman
l---------  1 local          12 Jul  4 16:11 l_man -> catman/l_man
drwxrwxr-x  2 bin           512 Jul  4 14:45 man1
drwxrwxr-x  2 bin           512 Mar 16 17:48 man8
drwxr-xr-x  2 root          512 Jul 17 16:06 manl
l---------  1 man            12 Mar 16 17:45 p_man -> catman/p_man
l---------  1 man            12 Mar 16 17:45 u_man -> catman/u_man
-r--r--r--  1 bin         76986 May 16 14:30 whatis
l---------  1 man            12 Jul  4 16:12 x_man -> catman/x_man

/usr/man/catman:
total 3
drwxrwxr-x  5 bin           512 Apr  6 18:47 a_man
l---------  1 root           15 Jul  4 16:06 l_man -> ../../local/man
drwxrwxr-x 10 bin           512 Jul 20 18:21 p_man
drwxrwxr-x  5 bin           512 Jul  4 14:34 u_man
l---------  1 root           15 Apr  6 10:06 x_man -> ../../X11/x_man

/usr/local/man:
total 1
drwxrwxr-x  2 local        1024 Aug 11 14:21 man1
-- 
Laurence G. Yaffe		Internet: lgy@newton.phys.washington.edu
University of Washington	  Bitnet: yaffe@uwaphast.bitnet