Date: Sat, 16 Jul 2011 15:51:29 GMT From: Momchil Ivanov <momchil@xaxo.eu> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/158973: Update man(1) Message-ID: <201107161551.p6GFpTNU083685@red.freebsd.org> Resent-Message-ID: <201107161600.p6GG0MDl062456@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 158973
>Category: docs
>Synopsis: Update man(1)
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sat Jul 16 16:00:22 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator: Momchil Ivanov
>Release: FreeBSD 8.2-STABLE #13: Sat Feb 26 16:30:35 CET 2011
>Organization:
>Environment:
FreeBSD 8.2-STABLE #13: Sat Feb 26 16:30:35 CET 2011 i386
>Description:
man(1) does not state, that it can display man pages outside of the manpath directory structure. From time to time one needs to display a man page from some third party sources that one has downloaded but not installed yet: man <somefile>, but the caveat is that <somefile> needs to include at least one "/", otherwise man fails. See /usr/src/gnu/usr.bin/man/man/man.c:208 for more details:
else if (strchr (nextarg, '/') != NULL && is_file (nextarg) == 1)
{
format_and_display (NULL, ultimate_source(nextarg, dirname(nextarg)),
NULL);
}
else
{
status = man (nextarg);
if (status == 0)
gripe_not_found (nextarg, longsec);
}
>How-To-Repeat:
man <somefile>
<somefile> has no "/", i.e. is in the current directory
>Fix:
Update man(1) accordingly, so that it reflects the requirement for at least one "/" in the file name/path, whenever one wants to display a man page outside the manpath tree structure
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201107161551.p6GFpTNU083685>