updating man.conf

[Josh Grosse]

On Tue, 5 May 2009 15:35:27 +0530, Siju George wrote
> Hi,
> 
> while updating packages i found the below instruction
> 
> --- qt3-mt-3.8p2 -------------------
> You may wish to add /usr/local/lib/qt3/man to /etc/man.conf
> --- samba-3.0.33 -------------------
> 
> what is the exact line I should add to man.conf and where should i 
> add it? Is there anything else I should do after adding the line to man.conf
> to view the man page

Siju,

First:

Understand *why* qt3-mt was installed.  Since Qt is a toolkit for building X11
GUIs, it is likely it is installed as a dependency for some other application. 

If you don't know what it does, use:

$ pkg_info -D qt3-mt

If you want to know what application has it as a dependency, use:

$ pkg_info -R qt3-mt

Second:

Determine if you *need* Qt man pages.  If it was a dependency, you probably
will never be executing any of its five utilities, nor developing applications
that make any of its four hundred and sixteen library calls.

Third:

Read the man.conf(5) man page.  It describes the structure and syntax for the
configuration file.

Fourth:

Read the existing /etc/man.conf file.  Note the section headed by this comment
line:

# Other sections that represent complete man subdirectories.

Fifth:

Place your new entry in that section.