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