diff options
author | Jerry Jelinek <jerry.jelinek@joyent.com> | 2017-06-08 10:10:29 +0000 |
---|---|---|
committer | Jerry Jelinek <jerry.jelinek@joyent.com> | 2017-06-08 10:10:29 +0000 |
commit | 8cb9f5acecaded019a9a55454a31dcf4328d0d1b (patch) | |
tree | 7c69e28b9b9b5ac2d9f928324a663becf2efa2d7 /usr/src/man/man1 | |
parent | 3a5445f1b9d90e4f1538503bd60913c8f302c17f (diff) | |
parent | 79809f9cf402f130667349b2d4007ecd65d63c6f (diff) | |
download | illumos-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.1 | 12 | ||||
-rw-r--r-- | usr/src/man/man1/hostname.1 | 3 | ||||
-rw-r--r-- | usr/src/man/man1/kvmstat.1 | 22 | ||||
-rw-r--r-- | usr/src/man/man1/man.1 | 98 |
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. |