Date: Thu, 19 Aug 2010 04:01:01 +0400 From: Anonymous <swell.k@gmail.com> To: Gordon Tetlow <gordon@tetlows.org> Cc: freebsd-current@freebsd.org Subject: Re: CFR: Replace man/manpath/whatis/apropos with a shell script Message-ID: <86sk2b79oi.fsf@gmail.com> In-Reply-To: <AANLkTi=d1RqZhkJJ94DioZkBq3Pq5vrj0kxBSgdW%2BUUo@mail.gmail.com> (Gordon Tetlow's message of "Wed, 18 Aug 2010 00:11:20 -0700") References: <AANLkTi=d1RqZhkJJ94DioZkBq3Pq5vrj0kxBSgdW%2BUUo@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Gordon Tetlow <gordon@tetlows.org> writes:
> I've tried to make this mirror the functionality, directory search order,
> and arguments as the current base implementation.
>
> This brings me to my next point. I need some testers willing to try this
> out. It would be particularly great if I could get some foreign language
> testers with localized manpage installations. If something doesn't work the
> way you expect, please contact me and I can help debug it (using man -ddd
> <whatever> will generally give me the debug information I need).
It doesn't search in bin/../man nor in bin/.man. For example,
my PATH contains $LOCALBASE/bin:$HOME/.bin, while /etc/manpath.config
is default one and contains /usr/local/man which does not exist here.
$ man -w mplayer rsync
HOME/.bin/man/man1/mplayer.1
LOCALBASE/man/man1/rsync.1.gz
$ echo $PATH
LOCALBASE/libexec/ccache:HOME/.bin:LOCALBASE/sbin:LOCALBASE/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/games:HOME/blah/bin
Unfortunately, if ~/.bin is in PATH it still will not search in ~/.man
without touching MANPATH.
But with man.sh it doesn't respect PATH at all.
$ man -ddd -w mplayer rsync
-- Using architecture: amd64:amd64
-- Using pager: less
-- Using manual sections: 1:1aout:8:2:3:n:4:5:6:7:9:l
-- Using manual path: /usr/share/man:/usr/share/openssl/man:/usr/local/man
-- Using locale paths: en_US.UTF-8:en.UTF-8:.
-- Searching for mplayer
-- Searching section 1
-- Searching directory /usr/share/man/en.UTF-8/man1
-- Searching directory /usr/share/man/man1
-- Searching directory /usr/share/openssl/man/man1
-- Searching section 1aout
-- Searching directory /usr/share/man/en.UTF-8/man1aout
-- Searching directory /usr/share/man/man1aout
-- Searching section 8
-- Searching directory /usr/share/man/en.UTF-8/man8/amd64
-- Searching directory /usr/share/man/en.UTF-8/man8/amd64
-- Searching directory /usr/share/man/en.UTF-8/man8
-- Searching directory /usr/share/man/man8/amd64
-- Searching directory /usr/share/man/man8/amd64
-- Searching directory /usr/share/man/man8
-- Searching section 2
-- Searching directory /usr/share/man/en.UTF-8/man2
-- Searching directory /usr/share/man/man2
-- Searching section 3
-- Searching directory /usr/share/man/en.UTF-8/man3
-- Searching directory /usr/share/man/man3
-- Searching directory /usr/share/openssl/man/man3
-- Searching section n
-- Searching section 4
-- Searching directory /usr/share/man/en.UTF-8/man4/amd64
-- Searching directory /usr/share/man/en.UTF-8/man4/amd64
-- Searching directory /usr/share/man/en.UTF-8/man4
-- Searching directory /usr/share/man/man4/amd64
-- Searching directory /usr/share/man/man4/amd64
-- Searching directory /usr/share/man/man4
-- Searching section 5
-- Searching directory /usr/share/man/en.UTF-8/man5
-- Searching directory /usr/share/man/man5
-- Searching section 6
-- Searching directory /usr/share/man/en.UTF-8/man6
-- Searching directory /usr/share/man/man6
-- Searching section 7
-- Searching directory /usr/share/man/en.UTF-8/man7
-- Searching directory /usr/share/man/man7
-- Searching section 9
-- Searching directory /usr/share/man/en.UTF-8/man9
-- Searching directory /usr/share/man/man9
-- Searching section l
No manual entry for mplayer
-- Searching for rsync
-- Searching section 1
-- Searching directory /usr/share/man/en.UTF-8/man1
-- Searching directory /usr/share/man/man1
-- Searching directory /usr/share/openssl/man/man1
-- Searching section 1aout
-- Searching directory /usr/share/man/en.UTF-8/man1aout
-- Searching directory /usr/share/man/man1aout
-- Searching section 8
-- Searching directory /usr/share/man/en.UTF-8/man8/amd64
-- Searching directory /usr/share/man/en.UTF-8/man8/amd64
-- Searching directory /usr/share/man/en.UTF-8/man8
-- Searching directory /usr/share/man/man8/amd64
-- Searching directory /usr/share/man/man8/amd64
-- Searching directory /usr/share/man/man8
-- Searching section 2
-- Searching directory /usr/share/man/en.UTF-8/man2
-- Searching directory /usr/share/man/man2
-- Searching section 3
-- Searching directory /usr/share/man/en.UTF-8/man3
-- Searching directory /usr/share/man/man3
-- Searching directory /usr/share/openssl/man/man3
-- Searching section n
-- Searching section 4
-- Searching directory /usr/share/man/en.UTF-8/man4/amd64
-- Searching directory /usr/share/man/en.UTF-8/man4/amd64
-- Searching directory /usr/share/man/en.UTF-8/man4
-- Searching directory /usr/share/man/man4/amd64
-- Searching directory /usr/share/man/man4/amd64
-- Searching directory /usr/share/man/man4
-- Searching section 5
-- Searching directory /usr/share/man/en.UTF-8/man5
-- Searching directory /usr/share/man/man5
-- Searching section 6
-- Searching directory /usr/share/man/en.UTF-8/man6
-- Searching directory /usr/share/man/man6
-- Searching section 7
-- Searching directory /usr/share/man/en.UTF-8/man7
-- Searching directory /usr/share/man/man7
-- Searching section 9
-- Searching directory /usr/share/man/en.UTF-8/man9
-- Searching directory /usr/share/man/man9
-- Searching section l
No manual entry for rsync
I guess there is one more bug.
$ MANPATH=$HOME/.bin/man man mplayer
zcat: HOME/.bin/man/man1/mplayer.1: not in gzip format
$ MANPATH=$HOME/.bin/man man -ddd mplayer
-- Using architecture: amd64:amd64
-- Using pager: less
-- Using manual sections: 1:1aout:8:2:3:n:4:5:6:7:9:l
-- Using locale paths: en_US.UTF-8:en.UTF-8:.
-- Searching for mplayer
-- Searching section 1
-- Searching directory HOME/.bin/man/man1
-- Found manpage HOME/.bin/man/man1/mplayer.1
-- Skipping catpage: not found or old
-- Command: /usr/bin/zcat HOME/.bin/man/man1/mplayer.1 | /usr/bin/tbl | /usr/bin/groff -S -Wall -mtty-char -man -Tascii | /usr/bin/col | less
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?86sk2b79oi.fsf>