Print this page
5025 import and use mandoc
Reviewed by: Hans Rosenfeld <hans.rosenfeld@nexenta.com>
Reviewed by: Igor Kozhukhov <ikozhukhov@gmail.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Albert Lee <trisk@nexenta.com>
Approved by: TBD
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/whatis.1
+++ new/usr/src/man/man1/whatis.1
1 -'\" te
2 -.\" Copyright (c) 1992, Sun Microsystems, Inc.
3 -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 -.TH WHATIS 1 "Sep 14, 1992"
7 -.SH NAME
8 -whatis \- display a one-line summary about a keyword
9 -.SH SYNOPSIS
10 -.LP
11 -.nf
12 -\fBwhatis\fR \fIcommand\fR...
13 -.fi
14 -
15 -.SH DESCRIPTION
16 -.sp
17 -.LP
18 -\fBwhatis\fR looks up a given \fIcommand\fR and displays the header line from
19 -the manual section. You can then run the \fBman\fR(1) command to get more
20 -information. If the line starts \fBname(\fIsection\fR)\fR.\|.\|. you can do
21 -\fBman\fR \fB-s\fR\fB\fIsection\fR name\fR to get the documentation for it.
22 -Try \fBwhatis ed\fR and then you should do \fBman\fR \fB-s\fR \fB1 ed\fR to get
23 -the manual page for \fBed\fR(1).
24 -.sp
25 -.LP
26 -\fBwhatis\fR is actually just the \fB-f\fR option to the \fBman\fR(1) command.
27 -.sp
28 -.LP
29 -\fBwhatis\fR uses the \fB/usr/share/man/windex\fR database. This database is
30 -created by \fBcatman\fR(1M). If this database does not exist, \fBwhatis\fR will
31 -fail.
32 -.SH FILES
33 -.sp
34 -.ne 2
35 -.na
36 -\fB\fB/usr/share/man/windex\fR\fR
37 -.ad
38 -.RS 25n
39 -Table of contents and keyword database
40 -.RE
41 -
42 -.SH ATTRIBUTES
43 -.sp
44 -.LP
45 -See \fBattributes\fR(5) for descriptions of the following attributes:
46 -.sp
47 -
48 -.sp
49 -.TS
50 -box;
51 -c | c
52 -l | l .
53 -ATTRIBUTE TYPE ATTRIBUTE VALUE
54 -_
55 -CSI Enabled
56 -.TE
57 -
58 -.SH SEE ALSO
59 -.sp
60 -.LP
61 -\fBapropos\fR(1), \fBman\fR(1), \fBcatman\fR(1M), \fBattributes\fR(5)
1 +.\"
2 +.\" This file and its contents are supplied under the terms of the
3 +.\" Common Development and Distribution License ("CDDL"), version 1.0.
4 +.\" You may only use this file in accordance with the terms of version
5 +.\" 1.0 of the CDDL.
6 +.\"
7 +.\" A full copy of the text of the CDDL should have accompanied this
8 +.\" source. A copy of the CDDL is also available via the Internet at
9 +.\" http://www.illumos.org/license/CDDL.
10 +.\"
11 +.\"
12 +.\" Copyright 2012 Nexenta Systems, Inc. All rights reserved.
13 +.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
14 +.\"
15 +.Dd Jul 18, 2014
16 +.Dt APROPOS 1
17 +.Os
18 +.Sh NAME
19 +.Nm apropos ,
20 +.Nm whatis
21 +.Nd keyword search in
22 +.Nm whatis
23 +database files
24 +.Sh SYNOPSIS
25 +.Nm
26 +.Op Fl M Ar path
27 +.Op Fl s Ar section
28 +.Ar keyword ...
29 +.Nm whatis
30 +.Op Fl M Ar path
31 +.Op Fl s Ar section
32 +.Ar keyword ...
33 +.Sh DESCRIPTION
34 +The
35 +.Nm
36 +utility searches a set of
37 +.Nm whatis
38 +database files matching each
39 +.Ar keyword .
40 +The
41 +.Nm whatis
42 +utility does the same search but only on complete words. The
43 +.Nm whatis
44 +database files are created using the
45 +.Xr man 1
46 +command.
47 +.Sh OPTIONS
48 +.Bl -tag -width ".Fl d"
49 +.It Fl M Ar path
50 +Force a specific colon separated manual path instead of the default search path.
51 +Overrides the
52 +.Ev MANPATH
53 +environment variable.
54 +.It Fl s Ar section
55 +Restrict search to specified
56 +.Ar section .
57 +.El
58 +.Sh ENVIRONMENT
59 +The following environment variables affect the execution of
60 +.Nm :
61 +.Bl -tag -width ".Ev MANPATH , PATH"
62 +.It Ev MANPATH , PATH
63 +Used to find the location of the
64 +.Nm whatis
65 +database files.
66 +.El
67 +.Sh DIAGNOSTICS
68 +The
69 +.Nm
70 +utility exits 0 if a keyword matched and 1 if no keywords are matched or no
71 +.Nm whatis
72 +databases are found.
73 +.Sh INTERFACE STABILITY
74 +.Nm Committed .
75 +.Sh CODE SET INDEPENDENCE
76 +Enabled.
77 +.Sh SEE ALSO
78 +.Xr man 1 ,
79 +.Xr mandoc 1
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX