summaryrefslogtreecommitdiff
path: root/usr/src/man/man1
diff options
context:
space:
mode:
authorJerry Jelinek <jerry.jelinek@joyent.com>2017-06-08 10:10:29 +0000
committerJerry Jelinek <jerry.jelinek@joyent.com>2017-06-08 10:10:29 +0000
commit8cb9f5acecaded019a9a55454a31dcf4328d0d1b (patch)
tree7c69e28b9b9b5ac2d9f928324a663becf2efa2d7 /usr/src/man/man1
parent3a5445f1b9d90e4f1538503bd60913c8f302c17f (diff)
parent79809f9cf402f130667349b2d4007ecd65d63c6f (diff)
downloadillumos-joyent-release-20170608.tar.gz
[illumos-gate merge]release-20170608
commit 79809f9cf402f130667349b2d4007ecd65d63c6f 8269 dtrace stddev aggregation is normalized incorrectly commit 22c8b9583d07895c16549075a53668d7bc988cf3 8108 zdb -l fails to read labels 2 and 3 commit 0255edcc85fc0cd1dda0e49bcd52eb66c06a1b16 8056 zfs send size estimate is inaccurate for some zvols commit dbfd9f930004c390a2ce2cf850c71b4f880eef9c 8156 dbuf_evict_notify() does not need dbuf_evict_lock commit 690031d326342fa4ea28b5e80f1ad6a16281519d 8168 NULL pointer dereference in zfs_create() commit 7c4ab494ff60bbbcc0889e71388ae63e903bbf57 8276 rpcbind leaks memory due to libumem per thread caching. commit f176a0a4cd61cbd708a7f25dc30d221f4d5902ba 8270 dnlc_reverse_lookup() is unsafe at any speed commit 72d3dbb9ab4481606cb93caca98ba3b3a8eb6ce2 8300 fix man page issues found by mandoc 1.14.1 commit cb4d790db8fe85bce9f9647fe4e1bdc274c7af1c 8337 gss: misleading-indentation commit f53522305c07915a44e86f2455cc62e7aac27037 8324 more: misleading-indentation Conflicts: usr/src/uts/common/fs/lookup.c usr/src/man/man3c/thrd_equal.3c
Diffstat (limited to 'usr/src/man/man1')
-rw-r--r--usr/src/man/man1/apropos.112
-rw-r--r--usr/src/man/man1/hostname.13
-rw-r--r--usr/src/man/man1/kvmstat.122
-rw-r--r--usr/src/man/man1/man.198
4 files changed, 81 insertions, 54 deletions
diff --git a/usr/src/man/man1/apropos.1 b/usr/src/man/man1/apropos.1
index 2ef316cbe5..56b160626e 100644
--- a/usr/src/man/man1/apropos.1
+++ b/usr/src/man/man1/apropos.1
@@ -39,8 +39,9 @@ and
fail.
.Lp
Each word is considered
-separately and the case of letters is ignored. Words which are part of other
-words are considered; for example, when looking for
+separately and the case of letters is ignored.
+Words which are part of other words are considered; for example, when looking
+for
.Sq compile ,
.Nm apropos
finds all instances of
@@ -49,8 +50,8 @@ also.
.Lp
The
.Nm whatis
-command performs the same search, but only matches whole words. In the above
-example,
+command performs the same search, but only matches whole words.
+In the above example,
.Nm whatis
would not match the instances of
.Sq compiler
@@ -70,7 +71,8 @@ command.
.Bl -tag -width "-s section"
.It Fl M Ar path
Force a specific colon separated manual path instead of the
-default search path. Overrides the MANPATH environment variable.
+default search path.
+Overrides the MANPATH environment variable.
.It Fl s Ar section
Restrict search to specified section.
.El
diff --git a/usr/src/man/man1/hostname.1 b/usr/src/man/man1/hostname.1
index 75a24a0437..2dc4c542bb 100644
--- a/usr/src/man/man1/hostname.1
+++ b/usr/src/man/man1/hostname.1
@@ -18,7 +18,8 @@ The
.Nm
command prints the name of the current host, as given before the
.Xr login 1
-prompt. The super-user can set the hostname by giving
+prompt.
+The super-user can set the hostname by giving
.Ar name-of-host .
.Pp
While setting the hostname changes the hostname for the running system,
diff --git a/usr/src/man/man1/kvmstat.1 b/usr/src/man/man1/kvmstat.1
index b0a6afdc17..fa1bd7a12a 100644
--- a/usr/src/man/man1/kvmstat.1
+++ b/usr/src/man/man1/kvmstat.1
@@ -31,15 +31,15 @@ injected interrupts, emulations, and more, on a per virtual CPU basis.
.Nm
should be used when trying to get a rough sense of guest activity from the
hypervisor's perspective, and allows one to understand from a low-level
-perspective, what kind of activity is going on inside of the virtual machine. In
-addition,
+perspective, what kind of activity is going on inside of the virtual machine.
+In addition,
.Nm
is useful for diagnosing reports of pathological or faulty behavior inside of
-guests. While there is no expected range of values for the fields displayed as
-that varies with the use of virtual machines, if all of the virtual CPUs for a
-given virtual machine are consistently zero, then that may indicate that a
-problem has occurred, for example, a panic inside of the guest or a bug in the
-hypervisor.
+guests.
+While there is no expected range of values for the fields displayed as that
+varies with the use of virtual machines, if all of the virtual CPUs for a given
+virtual machine are consistently zero, then that may indicate that a problem has
+occurred, for example, a panic inside of the guest or a bug in the hypervisor.
.Lp
If no operands are specified, then
.Nm
@@ -96,15 +96,15 @@ The following operands are supported:
.Bl -hang -width Ds
.It Ar count
.Bd -filled -compact
-Specifies the number of times that the statistics are repeated. If not
-specified,
+Specifies the number of times that the statistics are repeated.
+If not specified,
.Nm
will continue until it is terminated.
.Ed
.It Ar interval
.Bd -filled -compact
-Specifies the number of seconds between reports of statistics. If not specified,
-reports are generated every second.
+Specifies the number of seconds between reports of statistics.
+If not specified, reports are generated every second.
.Ed
.El
.Sh STABILITY
diff --git a/usr/src/man/man1/man.1 b/usr/src/man/man1/man.1
index 8cc4606db0..c4a16b60bb 100644
--- a/usr/src/man/man1/man.1
+++ b/usr/src/man/man1/man.1
@@ -39,8 +39,8 @@
.Sh DESCRIPTION
The
.Nm
-command displays information from the reference manuals. It
-displays complete manual pages that you select by
+command displays information from the reference manuals.
+It displays complete manual pages that you select by
.Ar name ,
or one-line summaries selected either by
.Ar keyword
@@ -55,7 +55,8 @@ Reference Manual pages are marked up with either
.Xr man 5 ,
or
.Xr mdoc 5
-language tags. The
+language tags.
+The
.Nm
command recognizes the type of markup and
processes the file accordingly.
@@ -65,8 +66,10 @@ processes the file accordingly.
The online Reference Manual page directories are conventionally located in
.Pa /usr/share/man .
Each directory corresponds to a
-section of the manual. Since these directories are optionally installed, they
-might not reside on your host. You might have to mount
+section of the manual.
+Since these directories are optionally installed, they might not reside on your
+host.
+You might have to mount
.Pa /usr/share/man
from a host on which they do reside.
The
@@ -92,15 +95,18 @@ Shows all manual pages matching
.Ar name
within the
.Ev MANPATH
-search path. Manual pages are displayed in the order found.
+search path.
+Manual pages are displayed in the order found.
.It Fl d
-Debugs. Displays what a section-specifier evaluates to, method used for
-searching, and paths searched by
+Debugs.
+Displays what a section-specifier evaluates to, method used for searching, and
+paths searched by
.Nm .
.It Fl f Ar file ...
Attempts to locate manual pages related to any of the given
.Ar file
-names. It strips the leading path name components from each
+names.
+It strips the leading path name components from each
.Ar file ,
and then prints one-line summaries containing the resulting basename or names.
This option also uses the
@@ -108,7 +114,8 @@ This option also uses the
database.
.It Fl F
This option is present for backwards compatibility and is documented
-here for reference only. It performs no function.
+here for reference only.
+It performs no function.
.It Fl k Ar keyword ...
Prints out one-line summaries from the
.Pa whatis
@@ -124,10 +131,12 @@ Lists all manual pages found matching
.Ar name
within the search path.
.It Fl M Ar path
-Specifies an alternate search path for manual pages. The
+Specifies an alternate search path for manual pages.
+The
.Ar path
is a colon-separated list of directories that contain manual page directory
-subtrees. For example, if
+subtrees.
+For example, if
.Ar path
is
.Pa /usr/share/man:/usr/local/man ,
@@ -143,11 +152,13 @@ or
.Fl w
options, the
.Fl M
-option must appear first. Each directory in the
+option must appear first.
+Each directory in the
.Ar path
is assumed to contain subdirectories of the form
.Pa man* ,
-one for each section. This option overrides the
+one for each section.
+This option overrides the
.Ev MANPATH
environment variable.
.It Fl r
@@ -156,7 +167,8 @@ display it.
.It Fl s Ar section
Specifies sections of the manual for
.Nm
-to search. The directories searched for
+to search.
+The directories searched for
.Ar name
are limited to those specified by
.Ar section .
@@ -172,12 +184,14 @@ can be a word, for example,
.Li old ,
.Li public .
.Ar section
-can also be a letter. To specify multiple sections,
-separate each section with a comma. This option overrides the
+can also be a letter.
+To specify multiple sections, separate each section with a comma.
+This option overrides the
.Ev MANPATH
environment variable and the
.Pa man.cf
-file. See
+file.
+See
.Sx Search Path
below for an explanation of how
.Nm
@@ -187,7 +201,8 @@ Arranges for the specified manual pages to be sent to the default
printer as PostScript.
.It Fl T Ar macro-package
This option is present for backwards compatibility and is documented
-here for reference only. It performs no function.
+here for reference only.
+It performs no function.
.It Fl w
Updates the
.Nm whatis
@@ -210,8 +225,8 @@ Entries in the reference manuals are organized into
.Em sections .
A section
name consists of a major section name, typically a single digit, optionally
-followed by a subsection name, typically one or more letters. An unadorned
-major section name, for example,
+followed by a subsection name, typically one or more letters.
+An unadorned major section name, for example,
.Qq 9 ,
does not act as an abbreviation for
the subsections of that name, such as
@@ -223,7 +238,8 @@ That is, each subsection must be searched separately by
.Nm
.Fl s .
Each section contains descriptions apropos to a particular reference category,
-with subsections refining these distinctions. See the
+with subsections refining these distinctions.
+See the
.Em intro
manual pages for an explanation of the classification used in this release.
.
@@ -248,13 +264,14 @@ environment variable, primarily by substituting
.Li man
for the last component of the
.Ev PATH
-element. Special provisions are added
-to account for unique characteristics of directories such as
+element.
+Special provisions are added to account for unique characteristics of
+directories such as
.Pa /sbin ,
.Pa /usr/ucb ,
.Pa /usr/xpg4/bin ,
-and others. If the file argument contains
-a
+and others.
+If the file argument contains a
.Qq /
character, the
.Em dirname
@@ -299,7 +316,8 @@ file has the following format:
Lines beginning with
.Sq Li #
and blank lines are considered comments, and are
-ignored. Each directory specified in
+ignored.
+Each directory specified in
.Ev MANPATH
can contain a manual page
configuration file, specifying the default search order for that directory.
@@ -310,9 +328,9 @@ page entry fitting the pattern:
.Dl \&.so man*/ Ns Em sourcefile
.Lp
.Nm
-processes the indicated file in place of the current one. The
-reference must be expressed as a path name relative to the root of the manual
-page directory subtree.
+processes the indicated file in place of the current one.
+The reference must be expressed as a path name relative to the root of the
+manual page directory subtree.
.Lp
When the second or any subsequent line starts with
.Sy \&.so ,
@@ -337,17 +355,20 @@ and
.Bl -tag -width MANWIDTH
.It Ev MANPATH
A colon-separated list of directories; each directory can be followed by a
-comma-separated list of sections. If set, its value overrides
+comma-separated list of sections.
+If set, its value overrides
.Pa /usr/share/man
as the default directory search path, and the
.Pa man.cf
-file as the default section search path. The
+file as the default section search path.
+The
.Fl M
and
.Fl s
flags, in turn, override these values.
.It Ev MANWIDTH
-Width of the output. If set to the special value
+Width of the output.
+If set to the special value
.Qq Sy TTY
.Po or
.Qq Sy tty
@@ -355,9 +376,11 @@ Width of the output. If set to the special value
and output is to terminal, auto-detect terminal width.
.It Ev PAGER
A program to use for interactively delivering
-output to the screen. If not set,
+output to the screen.
+If not set,
.Sq Nm more Fl s
-is used. See
+is used.
+See
.Xr more 1 .
.El
.Sh FILES
@@ -419,5 +442,6 @@ created with the
option.
.Sh BUGS
The manual is supposed to be reproducible either on a phototypesetter or on an
-ASCII terminal. However, on a terminal some information (indicated by
-font changes, for instance) is lost.
+ASCII terminal.
+However, on a terminal some information (indicated by font changes, for
+instance) is lost.