[src/trunk]: src/usr.bin/man More detail about treating a local file as a man...

[apb <apb%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/bf0923ce26ee
branches:  trunk
changeset: 331562:bf0923ce26ee
user:      apb <apb%NetBSD.org@localhost>
date:      Thu Aug 14 15:44:47 2014 +0000

description:
More detail about treating a local file as a man page,
and about how to request machine-specific man pages.
re

diffstat:

 usr.bin/man/man.1 |  24 +++++++++++++++++++++---
 1 files changed, 21 insertions(+), 3 deletions(-)

diffs (59 lines):

diff -r dde526ff8bee -r bf0923ce26ee usr.bin/man/man.1
--- a/usr.bin/man/man.1 Thu Aug 14 15:44:42 2014 +0000
+++ b/usr.bin/man/man.1 Thu Aug 14 15:44:47 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: man.1,v 1.27 2014/03/18 18:20:45 riastradh Exp $
+.\"    $NetBSD: man.1,v 1.28 2014/08/14 15:44:47 apb Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)man.1      8.2 (Berkeley) 1/2/94
 .\"
-.Dd October 7, 2011
+.Dd August 14, 2014
 .Dt MAN 1
 .Os
 .Sh NAME
@@ -175,7 +175,13 @@
 .Pp
 If
 .Ar name
-is given with a full or relative path then
+is given with a full path (beginning with
+.Ql Pa \&/ )
+or a relative path that begins with
+.Ql Pa .\&/
+or
+.Ql Pa .\&./ ,
+then
 .Nm
 interprets it as a file specification, so that you can do
 .Nm
@@ -183,6 +189,14 @@
 or even
 .Nm
 .Cm /cd/foo/bar.1.gz .
+If
+.Ar name
+contains
+.Ql Pa /
+but does not match one of the above cases, then the
+search path is used; this allows you to request
+machine-specific man pages, such as
+.Nm Cm vax/boot .
 .Sh ENVIRONMENT
 .Bl -tag -width MANPATHX
 .It Ev MACHINE
@@ -196,6 +210,10 @@
 variable
 .Ev MACHINE
 to the name of a specific architecture.
+Machine-specific man pages may also be requested by
+prepending the relevant subdirectory name to the page name,
+separated by
+.Ql Pa \&/ .
 .It Ev MANPATH
 The standard search path used by
 .Nm