On Mon, 5 Feb 2007, Jon Drews wrote:
> OpenBSD 4.0
>
> Hi:
>
> I installed Tcl and Tk on my OpenBSD computer. They are located in
> /usr/local/lib/{tcl8.4,tk8.4}/man. The man pages would
> not come up so I added them to /etc/man.conf like so:
>
> # The whatis/apropos database.
> _whatdb /usr/share/man/whatis.db
> _whatdb /usr/local/man/whatis.db
> _whatdb /usr/X11R6/man/whatis.db
> _whatdb /usr/local/lib/tcl8.4/man/whatis.db
> _whatdb /usr/local/lib/tk8.4/man/whatis.db
>
> <SNIP - irrelevant sections not shown>
>
> # default
> _default /usr/{share,X11R6,X11,contrib,gnu,local}/{man,man/old}/
> _default /usr/local/lib/{tcl8.4,tk8.4}/man/
Correct.
> These additions got them to work. My question; why could I not add
> them at the bottom of this section?
>
> # Other sections that represent complete man subdirectories.
> X11 /usr/X11/man/
> X11R6 /usr/X11R6/man/
> contrib /usr/contrib/man/
> local /usr/local/man/
> new /usr/contrib/man/
> old /usr/share/man/old/
>
> I mean what do these "other sections" do? Anyone know of a good howto
> on modifying /etc/man.conf ?.
These allow you to trim your man search.
Suppose you added the line
tcltk /usr/local/lib/{tcl8.4,tk8.4}/man
You could then do say:
man tcltk Thread
and get the man page for Thread from tcl, and not the one from perl.
If you do a lot of man-ning for tcl, you might want to shorten that
abbreviation to just "t".
You notice at the bottom of the man.conf the lines like ...
#Specific section/directory combinations.
1 /usr/{share,X11R6,X11,contrib,local}/{man/,man/old/}{cat,man}1
2 /usr/{share,X11R6,X11,contrib,local}/{man/,man/old/}{cat,man}2
3 /usr/{share,X11R6,X11,contrib,local}/{man/,man/old/}{cat,man}3
3F /usr/share/man/cat3f
3f /usr/share/man/cat3f
3P /usr/share/man/cat3p
3p /usr/share/man/cat3p
... same thing.
So man t Thread gets you the tcl man page, man 3p Thread gets the perl.
> Also, before making the modifications I tried using:
>
> $man -M/usr/local/lib/tcl8.4/man/ tclsh
>
> but it would not display the man page. What was I doing wrong here?
This worked for me without any tcl/tk stuff in the man.conf, by
doing a cut/paste from your post. You must have broken something ;-)
As for a how-to, I found the combination of
a) thinking about your post
b) man man.conf
c) man man
d) experiments
to have been all that could be desired. (For example, do a man man.conf
and go to the bottom where the author gives the "sect3" example.
Dave
--
"I believe that banking institutions are more dangerous to our
liberties than standing armies." -- T. Jefferson
_______________________________________________
Openbsd-newbies mailing list
[email protected]
http://mailman.theapt.org/listinfo/openbsd-newbies
