Module Name:    src
Committed By:   apb
Date:           Thu Aug 14 15:44:47 UTC 2014

Modified Files:
        src/usr.bin/man: man.1

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


To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/usr.bin/man/man.1

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/usr.bin/man/man.1
diff -u src/usr.bin/man/man.1:1.27 src/usr.bin/man/man.1:1.28
--- src/usr.bin/man/man.1:1.27	Tue Mar 18 18:20:45 2014
+++ src/usr.bin/man/man.1	Thu Aug 14 15:44:47 2014
@@ -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 @@ option.
 .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 @@ interprets it as a file specification, s
 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 @@ The current machine type may be overridd
 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

Reply via email to