From owner-freebsd-doc@FreeBSD.ORG Sat Jul 16 16:00:23 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 533E4106568D for ; Sat, 16 Jul 2011 16:00:23 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id E3DC18FC13 for ; Sat, 16 Jul 2011 16:00:22 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p6GG0MPL062457 for ; Sat, 16 Jul 2011 16:00:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p6GG0MDl062456; Sat, 16 Jul 2011 16:00:22 GMT (envelope-from gnats) Resent-Date: Sat, 16 Jul 2011 16:00:22 GMT Resent-Message-Id: <201107161600.p6GG0MDl062456@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Momchil Ivanov Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B5943106575D for ; Sat, 16 Jul 2011 15:51:29 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id A59308FC0A for ; Sat, 16 Jul 2011 15:51:29 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p6GFpTrY083686 for ; Sat, 16 Jul 2011 15:51:29 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p6GFpTNU083685; Sat, 16 Jul 2011 15:51:29 GMT (envelope-from nobody) Message-Id: <201107161551.p6GFpTNU083685@red.freebsd.org> Date: Sat, 16 Jul 2011 15:51:29 GMT From: Momchil Ivanov To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/158973: Update man(1) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 16 Jul 2011 16:00:23 -0000 >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 , but the caveat is that 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 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: