[comp.unix.ultrix] Question about /usr/ucb/man -P option

iglesias@orion.oac.uci.edu (Mike Iglesias) (06/30/90)

I've discovered that /usr/ucb/man (Ultrix 3.1) has a (undocumented) -P
option to set the path to look for man pages.  Is there a way to tell
it more than one path to look at?  I have a need to specify 2
different paths (/usr/man and one other) for man pages, and I can't
seem to find the right incantation to get it to take more than one
path. 


Thanks,

Mike Iglesias
University of California, Irvine
Internet:    iglesias@orion.oac.uci.edu
BITNET:      iglesias@uci
uucp:        ...!ucbvax!ucivax!iglesias

grr@cbmvax.commodore.com (George Robbins) (07/02/90)

In article <268BC4A7.8934@orion.oac.uci.edu> iglesias@orion.oac.uci.edu (Mike Iglesias) writes:
> 
> I've discovered that /usr/ucb/man (Ultrix 3.1) has a (undocumented) -P
> option to set the path to look for man pages.  Is there a way to tell
> it more than one path to look at?  I have a need to specify 2
> different paths (/usr/man and one other) for man pages, and I can't
> seem to find the right incantation to get it to take more than one
> path. 

Have you considered using symlinks to make your man directory show up as
/usr/man/manx?  This works for us, although it seems to require that the
suffixes on the man entries match the subdirectory to some extent...

> 
> 
> Thanks,
> 
> Mike Iglesias
> University of California, Irvine
> Internet:    iglesias@orion.oac.uci.edu
> BITNET:      iglesias@uci
> uucp:        ...!ucbvax!ucivax!iglesias


-- 
George Robbins - now working for,     uucp:   {uunet|pyramid|rutgers}!cbmvax!grr
but no way officially representing:   domain: grr@cbmvax.commodore.com
Commodore, Engineering Department     phone:  215-431-9349 (only by moonlite)

iglesias@orion.oac.uci.edu (Mike Iglesias) (07/02/90)

In article <12989@cbmvax.commodore.com> grr@cbmvax (George Robbins) writes:
>Have you considered using symlinks to make your man directory show up as
>/usr/man/manx?  This works for us, although it seems to require that the
>suffixes on the man entries match the subdirectory to some extent...

That's a good idea, but it won't work for us.  I guess I'd better explain
what our setup is.  We have lots of Suns (3,4,386i), some DECstations,
VAXen (Ultrix), etc.  We (the Office of Academic Computing) have a library
of software (X11R4, GNU Emacs/gcc/g++/etc, mh, etc) that people can mount
on their workstations.  We'd like to make the man pages available, but
not have to install them on the ~100 systems that use the library, so
we have the man pages as part of the library.  Sun's man has a -M
option to set the man path, so as part of the Sun executable library we
have a shell script called 'man' that does a 'man -M path:path2 ...'.
Users put the library executable path before /usr/ucb and it all works.



Mike Iglesias
University of California, Irvine
Internet:    iglesias@orion.oac.uci.edu
BITNET:      iglesias@uci
uucp:        ...!ucbvax!ucivax!iglesias

peirce@gumby.cc.wmich.edu (Leonard Peirce) (07/03/90)

In article <268F712E.9253@orion.oac.uci.edu> iglesias@orion.oac.uci.edu (Mike Iglesias) writes:
>In article <12989@cbmvax.commodore.com> grr@cbmvax (George Robbins) writes:
>>Have you considered using symlinks to make your man directory show up as
>>/usr/man/manx?  This works for us, although it seems to require that the
>>suffixes on the man entries match the subdirectory to some extent...
> [...]
>                                               Sun's man has a -M
>option to set the man path, so as part of the Sun executable library we
>have a shell script called 'man' that does a 'man -M path:path2 ...'.
>Users put the library executable path before /usr/ucb and it all works.

Or even better, you can just set the MANPATH environment variable and
achieve the same results.

The man command and related programs that come with ULTRIX are admittedly
poor.  I took a copy of the 4.3 man and made a few small hacks so that it
will work with ULTRIX.  I also added code for a default MANPATH so if some-
forgets to set it, they will still pick up both the ULTRIX man pages and our
local stuff.

At USENIX in January, I was told by someone in the ULTRIX development group
that 4.0 will support alternate search paths.  But I'm not holding my breath.
--
Leonard Peirce                  Internet:  peirce@gumby.cc.wmich.edu
Western Michigan University                peirce@gw.wmich.edu
Academic Computer Center        UUCP:      ...!uunet!sharkey!wmichgw!peirce
Kalamazoo, MI  49008            Phone:     (616) 387-5469

iglesias@orion.oac.uci.edu (Mike Iglesias) (07/04/90)

In article <1990Jul3.142529.495@gumby.cc.wmich.edu> peirce@gumby.cc.wmich.edu (Leonard Peirce) writes:
>The man command and related programs that come with ULTRIX are admittedly
>poor.  I took a copy of the 4.3 man and made a few small hacks so that it
>will work with ULTRIX.  I also added code for a default MANPATH so if some-
>forgets to set it, they will still pick up both the ULTRIX man pages and our
>local stuff.

I ended up doing something similar to what you did.

>At USENIX in January, I was told by someone in the ULTRIX development group
>that 4.0 will support alternate search paths.  But I'm not holding my breath.

I won't hold my breath either, but it sure would be nice (hint, hint).

Thanks to all who responded!


Mike Iglesias
University of California, Irvine
Internet:    iglesias@orion.oac.uci.edu
BITNET:      iglesias@uci
uucp:        ...!ucbvax!ucivax!iglesias

melanie@ux1.cso.uiuc.edu (Melanie Anderson ) (07/14/90)

peirce@gumby.cc.wmich.edu (Leonard Peirce) writes:

>In article <268F712E.9253@orion.oac.uci.edu> iglesias@orion.oac.uci.edu (Mike Iglesias) writes:
>>In article <12989@cbmvax.commodore.com> grr@cbmvax (George Robbins) writes:
>>>Have you considered using symlinks to make your man directory show up as
>>>/usr/man/manx?  This works for us, although it seems to require that the
>>>suffixes on the man entries match the subdirectory to some extent...
>> [...]
>>                                               Sun's man has a -M
>>option to set the man path, so as part of the Sun executable library we
>>have a shell script called 'man' that does a 'man -M path:path2 ...'.
>>Users put the library executable path before /usr/ucb and it all works.

>Or even better, you can just set the MANPATH environment variable and
>achieve the same results.

>The man command and related programs that come with ULTRIX are admittedly
>poor.  I took a copy of the 4.3 man and made a few small hacks so that it
>will work with ULTRIX.  I also added code for a default MANPATH so if some-
>forgets to set it, they will still pick up both the ULTRIX man pages and our
>local stuff.

>At USENIX in January, I was told by someone in the ULTRIX development group
>that 4.0 will support alternate search paths.  But I'm not holding my breath.
>--
>Leonard Peirce                  Internet:  peirce@gumby.cc.wmich.edu
>Western Michigan University                peirce@gw.wmich.edu
>Academic Computer Center        UUCP:      ...!uunet!sharkey!wmichgw!peirce
>Kalamazoo, MI  49008            Phone:     (616) 387-5469

yes indeed, ultrix 4.0 includes /usr/bin/man (old-style ultrix man) and
/usr/ucb/man which is the bsd-style man and it does indeed have a -P option
that does indeed acutally work. 

don't ask how i know this.

melanie anderson
beckman institute at the unversity of illinois
msa@uiuc.edu

rostamia@umbc3.UMBC.EDU (Rouben Rostamian) (07/14/90)

In article <1990Jul13.174942.7967@ux1.cso.uiuc.edu> melanie@ux1.cso.uiuc.edu (Melanie Anderson ) writes:
>
>yes indeed, ultrix 4.0 includes /usr/bin/man (old-style ultrix man) and
>/usr/ucb/man which is the bsd-style man and it does indeed have a -P option
>that does indeed acutally work. 
>
According to the documentation for ultrix V4.0, you may indeed specify an
alternate path (to replace the default /usr/man) for the man page top
directory using the -P option.  Alas, as far as I can tell, the -P option
does not accept more than one directory name, so you cannot say
man -P /usr/man:/usr/local/man:/usr/private/man ...
as you do in System V derived systems.  

--

peirce@gumby.cc.wmich.edu (Leonard Peirce) (07/17/90)

In article <3598@umbc3.UMBC.EDU> rostamia@umbc3.umbc.edu.UMBC.EDU (Rouben Rostamian) writes:
>According to the documentation for ultrix V4.0, you may indeed specify an
>alternate path (to replace the default /usr/man) for the man page top
>directory using the -P option.  Alas, as far as I can tell, the -P option
>does not accept more than one directory name, so you cannot say
>man -P /usr/man:/usr/local/man:/usr/private/man ...
>as you do in System V derived systems.  

Maybe someday DEC will finally fix this.  I myself complained with every
release since 2.2.  I guess that shows how much they listen to me. :-)

The fixes I made to the 4.3BSD man to make it work with ULTRIX were trivial.
It can use the MANPATH environment variable or the -P with multiple paths.
Come ON, DEC, it's not that tough to do.
--
Leonard Peirce                  Internet:  peirce@gumby.cc.wmich.edu
Western Michigan University                peirce@gw.wmich.edu
Academic Computing Services     UUCP:      ...!uunet!sharkey!wmichgw!peirce
Kalamazoo, MI  49008            Phone:     (616) 387-5469