Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 30 Nov 2003 10:57:10 +0000
From:      Matthew Seaman <m.seaman@infracaninophile.co.uk>
To:        Xpression <admin@atenas.cult.cu>
Cc:        FreeBSD-questions <questions@freebsd.org>
Subject:   Re: No reference to files ???
Message-ID:  <20031130105710.GE885@happy-idiot-talk.infracaninophile.co.uk>
In-Reply-To: <000701c3b6e8$7ef773c0$0901a8c0@bloodlust>
References:  <000701c3b6e8$7ef773c0$0901a8c0@bloodlust>

next in thread | previous in thread | raw e-mail | index | archive | help

--ILuaRSyQpoVaJ1HG
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sat, Nov 29, 2003 at 09:20:17PM -0500, Xpression wrote:
>         Hi all, I'm wondering if there is a way to show man
> pages and access files like if they were on $PATH, I mean
> when I compile a package and install it, there are no
> reference to man pages and the "executable" like when I
> install it from the CD...

I don't really understand what you're asking here.  Do you mean
something like -- "If I have more than one version of a program
installed at different locations on my $PATH, can I arrange for the
man(1) command to show me the man page corresponding to the version of
the program that comes first on the $PATH?"

If so, then: "Yes".  In fact it happens automatically. eg:

    % env PATH=3D/usr/local/bin:$PATH man dig | head -10
    DIG(1)                                                                 =
 DIG(1)
   =20
   =20
   =20
    NAME
           dig - DNS lookup utility
   =20
    SYNOPSIS
           dig  [  @server  ]  [ -b address ]  [ -c class ]  [ -f filename =
]  [ -k
           filename ]  [ -p port# ]  [ -t type ]  [ -x addr ]  [ -y name:ke=
y ]   [


which is the man page for dig(1) from the bind9 port -- compare to:

    %  man dig | head -10
    DIG(1)                  FreeBSD General Commands Manual                =
 DIG(1)
   =20
    NAME
         dig -- send domain name query packets to name servers
   =20
    SYNOPSIS
         dig [@server] domain [<query-type>] [<query-class>] [+<query-optio=
n>]
             [-<dig-option>] [%comment]
   =20
    DESCRIPTION
   =20

which is the man page for dig(1) from the bind8 version bundled with
the system.

This is all controlled by the manpath(1) utility built into the man(1)
command.  See also /etc/manpath.config=20

    % manpath
    /usr/share/man:/usr/local/man:/usr/X11R6/man:/usr/local/jdk1.4.2/man:/u=
sr/share/perl/man:/usr/share/openssl/man:/usr/local/lib/perl5/5.8.2/man:/us=
r/local/lib/perl5/5.00503/man

If you want to overrule where or in what order the man command
searches for man pages, you can tell it to look in specific places on
the command line:

    % man -M /usr/local/man:/usr/X11R6/man dig

If you want to see what man pages are available for a specific command:

    % man -a -w dig
    /usr/share/man/cat1/dig.1.gz (source: /usr/share/man/man1/dig.1.gz)
    /usr/local/man/cat1/dig.1.gz (source: /usr/local/man/man1/dig.1.gz)

There's plenty of other knobs to twiddle to do with the man command,
all described faithfully in various man pages, but I'll leave it as an
exercise for you to find them.

	Cheers,

	Matthew

--=20
Dr Matthew J Seaman MA, D.Phil.                       26 The Paddocks
                                                      Savill Way
PGP: http://www.infracaninophile.co.uk/pgpkey         Marlow
Tel: +44 1628 476614                                  Bucks., SL7 1TH UK

--ILuaRSyQpoVaJ1HG
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (FreeBSD)

iD8DBQE/yc0GdtESqEQa7a0RAoU9AKCaZgrjYBNQx21vnnyYJHbiKRbiiACghmmZ
XH7slxUydzyjMnsoEK7/3F0=
=cZIh
-----END PGP SIGNATURE-----

--ILuaRSyQpoVaJ1HG--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031130105710.GE885>