Path: utzoo!utgpu!watmath!clyde!att!rutgers!mailrus!ukma!gatech!bloom-beacon!ICASE.EDU!tom
From: tom@ICASE.EDU (Tom Crockett)
Newsgroups: comp.windows.x
Subject: Re: dificulty with R3 man page names:  *.3X11 and *.3Xt -- ULTRIX 2.3
Message-ID: <8812011626.AA24000@work8.icase.edu>
Date: 1 Dec 88 16:26:40 GMT
Sender: daemon@bloom-beacon.MIT.EDU
Organization: The Internet
Lines: 38

>  It seems however that it was decided to change the style of man page
>  filenames between R2 and R3.   R2, files were named, for instance,
>  XDrArc.3X  while for R3 the name XDrArc.3X11 is used.  Also, the
>  Xt man pages are named  XtAddCbk.3Xt
>  
>  At least on ULTRIX 2.3, these man pages are not found.  My experience
>  is that they must have only two character extensions beyond the dot.

I ran into the same problem on our Suns running SunOS 3.5.  After some
experimentation, I discovered that "man" is very picky about what suffixes it
will find, and the permissible possiblilities vary from section to section of
the manual.  For example, in sections "local" and "public" (manl and manp),
the only suffixes man seems to find are ".l" and ".p", respectively.  Suffixes
like ".3" or ".pX" or ".3X11" just plain don't work in manl and manp. In our
case, we wanted to keep all of the X man pages in "manp" to segregate them
from everything else.  It makes maintenance easier, and reduces confusion and
potential name conflicts.  I also tried creating a /usr/man/manX, but "man"
refused to look in there either.  

So it would appear that the "install.man" entries in the doc/Xlib/Xman and
doc/Xt/Xtman Imakefiles should be using "LibManSuffix" as the suffix for the
installed man pages.  The "expand.names" files would need to be modified
accordingly, preferably by some automated procedure.

VERY minor gripe:  The "expand.names" scripts should be run automatically
if "ExpandManNames" is set in the appropriate *.macros or site.def files.  It
looks like the hooks are all there, but just didn't get carried all the way
through.

Tom Crockett

--------------------------------------------------------------------------------
Institute for Computer Applications in Science and Engineering
M.S. 132C, NASA Langley Research Center
Hampton, VA  23665

e-mail:  tom@icase.edu		phone:   (804) 865-4097
--------------------------------------------------------------------------------