The NEXTSTEP/OpenStep FAQ

! to the table of contents
< to the previous section:
> to the next section:


4.10 How does one set UNIX man pages to be viewed in nroff format with DL like the standard manual pages in NS2.x?

man pages, NS2.x

Beyond looking in the man pages under ixBuild, etc., what you want to do is put a few files (contents listed below file name) the .index directory:

.roffArgs: -man displayCommand: tbl %s | nroff -man ixBuildOptions: -fman -Nwhatis -Ncat[1-8ln] -V

Other options that people suggested for ixBuildOptions:

-fman -Nwhatis -Ncat[1-8] -V /usr/local/man -fman -Nwhatis -V /usr/local/man/man*

I don't think you need to explicitly name the directory in the first alternative, but you do in the second unless you want the cat* directories indexed as well.

Note: Do NOT leave a trailing return after the line in ixBuildOptions; DL will barf. (I think someone said that, as shipped, the standard man .index/ixBuildOptions had this problem.)

[From: Eric D. Engstrom ]

Can anyone tell me what the command line for this might be under NEXTSTEP 3.0?

Short answer: RTM on ixbuild(1) - specifically the parameter "-g".

In addition, I'd like to inform the newsgroup of a simple hack I setup on my own machine to create a unified DL target for all UNIX Manual pages (including system, local, gnu, whatever). This was easier under 2.x because IXBuild (pre IXKit) had more hacks in it...

Basically, you need to setup a directory with sym-links to the various man-page directories; For example:

(397)basilisk% pwd /LocalLibrary/Documentation/ManPages (398)basilisk% ls -alg total 728 drwxrwxr-x 2 eric wheel 1024 Mar 28 18:03 ./ drwxrwxr-x 11 root wheel 1024 Mar 27 00:41 ../ -rw-r--r-- 1 eric wheel 370 Feb 27 22:01 .README -rw-rw-r-- 1 eric wheel 872 Feb 27 17:11 .dir.tiff -rw-rw-r-- 1 eric wheel 20 Feb 27 17:11 .displayCommand -rw-rw-r-- 1 eric wheel 47 Feb 27 17:10 .index.iname -rw-rw-r-- 1 eric wheel 6 Feb 27 17:10 .index.itype -rw-r--r-- 1 eric wheel 729088 Mar 28 18:44 .index.store -rw-rw-r-- 1 eric wheel 5 Feb 27 17:11 .roffArgs lrwxrwxrwx 1 eric wheel 18 Feb 27 17:53 gnu -> /usr/local/gnu/man/@ lrwxrwxrwx 1 eric wheel 14 Feb 27 17:53 local -> /usr/local/man/@ lrwxrwxrwx 1 eric wheel 9 Feb 27 17:53 news -> /news/man/@ lrwxrwxrwx 1 eric wheel 35 Feb 27 17:53 system -> /usr/man/@

Notice that I also copied all the .[a-z]* files from the /usr/man/ directory as well.

Then, use ixbuild -gl to (re)build the index. If your any of the links point to directories on other devices, add "d" to "-gl". "-v" will give you verbose output (like my writing style ;-). RTM under ixbuild(1) for more info.

Unfortunately, once the index is built, I've never successfully gotten DL to update it correctly. Instead I have to do it by hand using ixbuild -ogldvc (actually, I setup a cron job to reindex weekly.)

If you have troubles, try removing the .index.store file and rebuilding the entire database. I've had intermittent problems with ixbuild under 3.0.



This document was converted from LaTeX using Karl Ewald's latex2html.