[src/trunk]: src/share/man/man4 New sentence, new line.

[jdc <jdc%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1e9d8360ba45
branches:  trunk
changeset: 538279:1e9d8360ba45
user:      jdc <jdc%NetBSD.org@localhost>
date:      Wed Oct 16 19:48:33 2002 +0000

description:
New sentence, new line.

diffstat:

 share/man/man4/options.4 |  208 +++++++++++++++++++++++++++-------------------
 1 files changed, 120 insertions(+), 88 deletions(-)

diffs (truncated from 448 to 300 lines):

diff -r 584e29e7d6a5 -r 1e9d8360ba45 share/man/man4/options.4
--- a/share/man/man4/options.4  Wed Oct 16 19:33:45 2002 +0000
+++ b/share/man/man4/options.4  Wed Oct 16 19:48:33 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: options.4,v 1.182 2002/10/16 19:33:45 jdc Exp $
+.\"    $NetBSD: options.4,v 1.183 2002/10/16 19:48:33 jdc Exp $
 .\"
 .\" Copyright (c) 1996
 .\"    Perry E. Metzger.  All rights reserved.
@@ -198,9 +198,9 @@
 .Xr a.out 5
 applications built for the same architecture.
 This currently includes the alpha, i386, powerpc, and m68k
-ports. There is also a minimal support for running Linux
-binaries on Mips ports, but it is experimental at
-the moment.
+ports.
+There is also a minimal support for running Linux binaries on Mips
+ports, but it is experimental at the moment.
 .It Cd options COMPAT_SUNOS
 On those architectures that support it, this enables binary
 compatibility with
@@ -400,7 +400,8 @@
 .It Cd options DIAGNOSTIC
 Adds code to the kernel that does internal consistency checks.
 This code will cause the kernel to panic if corruption of internal data
-structures is detected. These checks can decrease performance up to 15%.
+structures is detected.
+These checks can decrease performance up to 15%.
 .It Cd options KSTACK_CHECK_MAGIC
 Check kernel stack usage and panic if stack overflow is detected.
 This check is performance sensitive because it scans stack on each context
@@ -445,7 +446,8 @@
 for details.
 .It Cd options UVMHIST
 Enables the UVM history logs, which create in-memory traces of
-various UVM activities. These logs can be displayed be calling
+various UVM activities.
+These logs can be displayed be calling
 .Fn uvmhist_dump
 or
 .Fn uvm_hist
@@ -471,8 +473,9 @@
 .Em filetype
 and
 .Em sparse_super
-options.  This is the most commonly used file system on the Linux operating
-system, and is provided here for compatibility.
+options.
+This is the most commonly used file system on the Linux operating system,
+and is provided here for compatibility.
 Some of the specific features of
 .Em EXT2FS
 like the "behavior on errors" are not implemented.
@@ -588,9 +591,10 @@
 .It Cd file-system OVERLAY
 Includes code for a file system filter.
 This permits the overlay file system to intercept all access to an underlying
-file system. This file system is intended to serve as an example of
-a stacking file system which has a need to interpose itself between an
-underlying file system and all other access.
+file system.
+This file system is intended to serve as an example of a stacking file
+system which has a need to interpose itself between an underlying file
+system and all other access.
 See
 .Xr mount_overlay 8
 for details.
@@ -639,16 +643,17 @@
 .It Cd file-system CODA
 .Em [EXPERIMENTAL]
 Includes code for the Coda file system.
-Coda is a distributed file system like NFS and AFS.  It is
-freely available, like NFS, but it functions much like AFS in being a
+Coda is a distributed file system like NFS and AFS.
+It is freely available, like NFS, but it functions much like AFS in being a
 .Dq stateful
-file system.  Both Coda and AFS cache files on your local
-machine to improve performance.  Then Coda goes a step further than AFS
-by letting you access the cached files when there is no available
-network, viz. disconnected laptops and network outages.  In Coda, both
-the client and server are outside the kernel which makes them easier
-to experiment with.  Coda is available for several UNIX and non-UNIX
-platforms.
+file system.
+Both Coda and AFS cache files on your local machine to improve performance.
+Then Coda goes a step further than AFS by letting you access the cached
+files when there is no available network, viz. disconnected laptops and
+network outages.
+In Coda, both the client and server are outside the kernel which makes
+them easier to experiment with.
+Coda is available for several UNIX and non-UNIX platforms.
 See http://www.coda.cs.cmu.edu for more details.
 NOTE: You also need to enable the pseudo-device, vcoda, for the Coda
 filesystem to work.
@@ -711,12 +716,14 @@
 the namei cache.
 .It Cd options NAMECACHE_ENTER_REVERSE
 Causes the namei cache to always enter a reverse mapping (vnode -\*[Gt] name)
-as well as a normal one. Normally, this is already done for directory
-vnodes, to speed up the getcwd operation. This option will cause
-longer hash chains in the reverse cache, and thus slow down
-getcwd somewhat. However, it does make vnode -\*[Gt] path translations
-possible in some cases. For now, only useful if strict /proc/#/maps
-emulation for Linux binaries is required.
+as well as a normal one.
+Normally, this is already done for directory vnodes, to speed up the getcwd
+operation.
+This option will cause longer hash chains in the reverse cache, and thus
+slow down getcwd somewhat.
+However, it does make vnode -\*[Gt] path translations possible in some cases.
+For now, only useful if strict /proc/#/maps emulation for Linux binaries is
+required.
 .It Cd options EXT2FS_SYSTEM_FLAGS
 This option changes the behavior of the APPEND and IMMUTABLE flags
 for a file on an
@@ -751,10 +758,12 @@
 for details.
 .It Cd options NFS_BOOT_RWSIZE=value
 Set the initial NFS read and write sizes for diskless-boot requests.
-The normal default is 8Kbytes.  This option provides a way to lower
-the value (e.g., to 1024 bytes) as a workaround for buggy network
-interface cards or boot proms. Once booted, the read and write request
-sizes can be increased by remounting the filesystem. See
+The normal default is 8Kbytes.
+This option provides a way to lower the value (e.g., to 1024 bytes)
+as a workaround for buggy network interface cards or boot proms.
+Once booted, the read and write request sizes can be increased by
+remounting the filesystem.
+See
 .Xr mount_nfs 8
 for details.
 .It Cd options NFS_V2_ONLY
@@ -830,8 +839,8 @@
 Do not inline the
 .Fn VOP_*
 calls in the kernel.
-On i386 GENERIC, this saves 36k of kernel text.  Useful
-for install media kernels, small memory systems and embedded systems.
+On i386 GENERIC, this saves 36k of kernel text.
+Useful for install media kernels, small memory systems and embedded systems.
 .It Cd options MALLOC_NOINLINE
 Time critical fixed size memory allocation is performed with
 .Fn MALLOC
@@ -848,7 +857,8 @@
 .It Cd options HZ=integer
 On ports that support it, set the system clock frequency (see
 .Xr hz 9 )
-to the supplied value. Handle with care.
+to the supplied value.
+Handle with care.
 .It Cd options NTP
 Turns on in-kernel precision timekeeping support used by software
 implementing
@@ -935,8 +945,8 @@
 .It Cd options PUCCN
 Enables treating serial ports found on PCI boards
 .Xr puc 4
-as potential console devices.  The method for choosing such a console
-device is port dependent.
+as potential console devices.
+The method for choosing such a console device is port dependent.
 .It Cd options RTC_OFFSET=integer
 The kernel (and typically the hardware battery backed-up clock on
 those machines that have one) keeps time in
@@ -990,7 +1000,8 @@
 coexist with such an operating system, like Windows,
 would necessitate changing
 .Em RTC_OFFSET
-twice a year. As such, this solution is imperfect.
+twice a year.
+As such, this solution is imperfect.
 .It Cd options KMEMSTATS
 The kernel memory allocator,
 .Xr malloc 9 ,
@@ -1055,8 +1066,9 @@
 for console output.
 .It Cd options INCLUDE_CONFIG_FILE
 Embeds the kernel config file used to define the kernel in the kernel
-binary itself.  The embedded data also includes any files directly
-included by the config file itself, e.g.
+binary itself.
+The embedded data also includes any files directly included by the config
+file itself, e.g.
 .Pa GENERIC.local
 or
 .Pa std.$MACHINE .
@@ -1070,10 +1082,11 @@
 not any included files.
 .It Cd options PIPE_SOCKETPAIR
 Use slower, but smaller socketpair(2)-based pipe implementation instead
-of default faster, but bigger one. Primarily useful for installation
-kernels.
+of default faster, but bigger one.
+Primarily useful for installation kernels.
 .It Cd options USERCONF
-Compiles in the in-kernel device configuration manager.  See
+Compiles in the in-kernel device configuration manager.
+See
 .Xr userconf 4
 for details.
 .It Cd options PERFCTRS
@@ -1111,9 +1124,11 @@
 .It Cd options IPFORWARDING=value
 If
 .Em value
-is 1 this enables IP routing behavior. If
+is 1 this enables IP routing behavior.
+If
 .Em value
-is 0 (the default), it disables it. The
+is 0 (the default), it disables it.
+The
 .Em GATEWAY
 option sets this to 1 automatically.
 With this option enabled, the machine will forward IP datagrams destined
@@ -1258,14 +1273,16 @@
 Sets default value for net.inet.ip.subnetsarelocal variable, which
 controls whether non-directly-connected subnets of connected networks
 are considered "local" for purposes of choosing the MSS for a TCP
-connection.  This is mostly present for historic reasons and
-completely irrelevant if you enable Path MTU discovery.
+connection.
+This is mostly present for historic reasons and completely irrelevant if
+you enable Path MTU discovery.
 .It Cd options HOSTZEROBROADCAST
 Sets default value for net.inet.ip.hostzerobroadcast variable, which
 controls whether the zeroth host address of each connected subnet is
-also considered a broadcast address.  Default value is "1", for
-compatibility with old systems; if this is set to zero on all hosts on
-a subnet, you should be able to fit an extra host per subnet on the
+also considered a broadcast address.
+Default value is "1", for compatibility with old systems; if this is
+set to zero on all hosts on a subnet, you should be able to fit an extra
+host per subnet on the
 ".0" address.
 .It Cd options MCLSHIFT=value
 This option is the base-2 logarithm of the size of mbuf clusters.
@@ -1414,23 +1431,23 @@
 .It Cd options SEMMNI=value
 Sets the number of
 .At V
-style semaphore identifiers.  The GENERIC config file for your port
-will have the default.
+style semaphore identifiers.
+The GENERIC config file for your port will have the default.
 .It Cd options SEMMNS=value
 Sets the number of
 .At V
-style semaphores in the system.  The GENERIC config file for your port
-will have the default.
+style semaphores in the system.
+The GENERIC config file for your port will have the default.
 .It Cd options SEMUME=value
 Sets the maximum number of undo entries per process for
 .At V
-style semaphores.  The GENERIC config file for your port
-will have the default.
+style semaphores.
+The GENERIC config file for your port will have the default.
 .It Cd options SEMMNU=value
 Sets the number of undo structures in the system for
 .At V
-style semaphores.  The GENERIC config file for your port
-will have the default.
+style semaphores.
+The GENERIC config file for your port will have the default.
 .It Cd options SYSVSHM
 Includes support for
 .At V
@@ -1454,9 +1471,9 @@
 .Ss VM Related Options
 .Bl -ohang
 .It Cd options NMBCLUSTERS=value
-The number of mbuf clusters the kernel supports.  Mbuf clusters are
-MCLBYTES in size (usually 2k).  This is used to compute the size of
-the kernel VM map
+The number of mbuf clusters the kernel supports.
+Mbuf clusters are MCLBYTES in size (usually 2k).
+This is used to compute the size of the kernel VM map
 .Em mb_map ,
 which maps mbuf clusters.
 Default on most ports is 1024 (2048 with
@@ -1481,8 +1498,9 @@
 ).
 This VM map is used to map the kernel malloc arena.
 The kernel attempts to auto-size this map based on the amount of
-physical memory in the system.  Platform-specific code may place
-bounds on this computed size, which may be viewed with the
+physical memory in the system.
+Platform-specific code may place bounds on this computed size,
+which may be viewed with the
 .Xr sysctl 8
 variable
 .Em vm.nkmempages .
@@ -1509,7 +1527,8 @@
 between 5% and 10% of total available
 .Tn RAM .
 .It Cd options MAXTSIZ=bytes
-Sets the maximum size limit of a process' text segment. See