Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/share/man/man9 Use `\(em', not `--'.
details: https://anonhg.NetBSD.org/src/rev/c35234b81817
branches: trunk
changeset: 352148:c35234b81817
user: riastradh <riastradh%NetBSD.org@localhost>
date: Sat Mar 18 19:01:01 2017 +0000
description:
Use `\(em', not `--'.
Refill sentences and tweak wording where appropriate while here.
diffstat:
share/man/man9/bufferio.9 | 6 +++---
share/man/man9/fstrans.9 | 4 ++--
share/man/man9/kauth.9 | 10 +++++-----
share/man/man9/ltsleep.9 | 7 ++++---
share/man/man9/memcpy.9 | 6 +++---
share/man/man9/namei.9 | 4 ++--
share/man/man9/secmodel.9 | 12 ++++++------
share/man/man9/sysctl.9 | 12 ++++++------
share/man/man9/uvm.9 | 12 ++++++------
share/man/man9/wapbl.9 | 20 ++++++++++----------
10 files changed, 47 insertions(+), 46 deletions(-)
diffs (truncated from 309 to 300 lines):
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/bufferio.9
--- a/share/man/man9/bufferio.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/bufferio.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: bufferio.9,v 1.16 2015/03/30 14:09:04 riastradh Exp $
+.\" $NetBSD: bufferio.9,v 1.17 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2015 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -125,7 +125,7 @@
.Fa vp Ns Li "->v_numoutput"
and submitting
.Fa bp
-to a block device -- doing so will likely cause deadlock with the
+to a block device \(em doing so will likely cause deadlock with the
syncer.
.Pp
Block I/O transfer completion may be notified by the
@@ -354,7 +354,7 @@
.Pp
May not be called if
.Fa bp
-has a callback or is asynchronous -- that is, if
+has a callback or is asynchronous \(em that is, if
.Fa bp Ns Li "->b_iodone"
is set, or if
.Dv B_ASYNC
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/fstrans.9
--- a/share/man/man9/fstrans.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/fstrans.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: fstrans.9,v 1.20 2015/03/31 21:08:06 riastradh Exp $
+.\" $NetBSD: fstrans.9,v 1.21 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -373,7 +373,7 @@
.Aq hannken%NetBSD.org@localhost .
.Sh BUGS
.Nm
-is useful only for temporary suspension -- it does not help to
+is useful only for temporary suspension \(em it does not help to
permanently block file system operations for unmounting, because
.Fn fstrans_start
cannot fail.
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/kauth.9
--- a/share/man/man9/kauth.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/kauth.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: kauth.9,v 1.106 2017/02/26 15:44:15 riastradh Exp $
+.\" $NetBSD: kauth.9,v 1.107 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2005, 2006 Elad Efrat <elad%NetBSD.org@localhost>
.\" All rights reserved.
@@ -1928,8 +1928,8 @@
request to be denied; but all listeners are called during an authorization
process none-the-less.
All listeners are required to allow the request for it to be granted,
-and in a case where all listeners defer the request -- leaving the decision
-for other listeners -- the request is denied.
+and in a case where all listeners defer the request \(em leaving the
+decision for other listeners \(em the request is denied.
.Pp
The following KPI is provided for the management of listeners:
.Bl -tag -width compact
@@ -1962,8 +1962,8 @@
.Pp
The common method to do the above is by having a reference count to
each listener.
-On entry to the listener, this reference count should be raised, and
-on exit -- lowered.
+On entry to the listener, this reference count should be raised; on
+exit, lowered.
.Pp
During the removal of a listener, first
.Fn kauth_scope_unlisten
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/ltsleep.9
--- a/share/man/man9/ltsleep.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/ltsleep.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ltsleep.9,v 1.17 2014/03/22 11:35:03 wiz Exp $
+.\" $NetBSD: ltsleep.9,v 1.18 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 1996, 2002, 2007 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -78,8 +78,9 @@
.Fn wakeup
is used to notify sleeping processes of possible changes to the condition
that caused them to go to sleep.
-Typically, an awakened process will -- after it has acquired a context
-again -- retry the action that blocked its operation to see if the
+Typically, an awakened process will \(em after it has acquired a
+context again \(em retry the action that blocked its operation to see
+if the
.Dq blocking
condition has cleared.
.Pp
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/memcpy.9
--- a/share/man/man9/memcpy.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/memcpy.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: memcpy.9,v 1.9 2012/01/02 18:07:21 wiz Exp $
+.\" $NetBSD: memcpy.9,v 1.10 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -53,8 +53,8 @@
.Fa src
to string
.Fa dst .
-The arguments must not overlap -- behavior if the arguments overlap is
-undefined.
+The arguments must not overlap \(em behavior if the arguments overlap
+is undefined.
To copy byte strings that overlap, use
.Xr memmove 9 .
.Sh RETURN VALUES
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/namei.9
--- a/share/man/man9/namei.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/namei.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: namei.9,v 1.42 2017/03/18 18:55:49 riastradh Exp $
+.\" $NetBSD: namei.9,v 1.43 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2001, 2005, 2006 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -214,7 +214,7 @@
.Xr VOP_LOOKUP 9
in the caller-specified mode for the last component.
.El
-Each mode can fail in different ways -- for example,
+Each mode can fail in different ways \(em for example,
.Dv LOOKUP
mode fails with
.Er ENOENT
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/secmodel.9
--- a/share/man/man9/secmodel.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/secmodel.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: secmodel.9,v 1.20 2014/03/18 18:20:40 riastradh Exp $
+.\" $NetBSD: secmodel.9,v 1.21 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2006 Elad Efrat <elad%NetBSD.org@localhost>
.\" All rights reserved.
@@ -56,8 +56,8 @@
.Em securelevel )
while decoupling it easily from the system.
.Pp
-It is possible to modify the security model -- either slightly or using an
-entirely different model -- by attaching/detaching
+It is possible to modify the security model \(em either slightly or
+using an entirely different model \(em by attaching/detaching
.Xr kauth 9
listeners.
This can be done via the
@@ -296,7 +296,7 @@
.It
If you attach this listener as the only listener for the network scope,
there are many other requests that will be deferred and, eventually,
-denied -- which may not be desired.
+denied \(em which may not be desired.
.El
.Pp
That's why before implementing listeners, it should be clear whether they
@@ -321,8 +321,8 @@
This is a requirement from kernel code to allow designing security models
where the request should be dispatched to userspace or a different host.
.It
-Private listener data -- such as internal data-structures -- is entirely
-under the responsibility of the developer.
+Private listener data \(em such as internal data structures \(em is
+entirely under the responsibility of the developer.
Locking, synchronization, and garbage collection are all things that
.Xr kauth 9
does
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/sysctl.9
--- a/share/man/man9/sysctl.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/sysctl.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: sysctl.9,v 1.18 2011/12/04 18:34:20 jym Exp $
+.\" $NetBSD: sysctl.9,v 1.19 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2004 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -622,18 +622,18 @@
.Pp
.Bl -bullet -compact
.It
-initialization -- when the kernel is booting
+initialization \(em when the kernel is booting
.It
-autoconfiguration -- when devices are being probed at boot time
+autoconfiguration \(em when devices are being probed at boot time
.It
.Dq plug and play
-device attachment -- when a PC-Card, USB, or other device is plugged
+device attachment \(em when a PC-Card, USB, or other device is plugged
in or attached
.It
-module initialization -- when a module is being loaded
+module initialization \(em when a module is being loaded
.It
.Dq run-time
--- when a process creates a node via the
+\(em when a process creates a node via the
.Xr sysctl 3
interface
.El
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/uvm.9
--- a/share/man/man9/uvm.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/uvm.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: uvm.9,v 1.112 2017/01/05 09:55:01 wiz Exp $
+.\" $NetBSD: uvm.9,v 1.113 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 1998 Matthew R. Green
.\" All rights reserved.
@@ -472,24 +472,24 @@
.It Dv UFP_ALL
Zero pseudo-flag meaning return all pages.
.It Dv UFP_NOWAIT
-Don't sleep -- yield
+Don't sleep \(em yield
.Dv NULL
for busy pages or for uncached pages for which allocation would sleep.
.It Dv UFP_NOALLOC
-Don't allocate -- yield
+Don't allocate \(em yield
.Dv NULL
for uncached pages.
.It Dv UFP_NOCACHE
-Don't use cached pages -- yield
+Don't use cached pages \(em yield
.Dv NULL
instead.
.It Dv UFP_NORDONLY
-Don't yield read-only pages -- yield
+Don't yield read-only pages \(em yield
.Dv NULL
for pages marked
.Dv PG_READONLY .
.It Dv UFP_DIRTYONLY
-Don't yield clean pages -- stop early at the first clean one.
+Don't yield clean pages \(em stop early at the first clean one.
As a side effect, mark yielded dirty pages clean.
Caller must write them to permanent storage before unbusying.
.It Dv UFP_BACKWARD
diff -r 6ebab17464ab -r c35234b81817 share/man/man9/wapbl.9
--- a/share/man/man9/wapbl.9 Sat Mar 18 18:55:49 2017 +0000
+++ b/share/man/man9/wapbl.9 Sat Mar 18 19:01:01 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: wapbl.9,v 1.14 2016/05/08 10:13:01 wiz Exp $
+.\" $NetBSD: wapbl.9,v 1.15 2017/03/18 19:01:01 riastradh Exp $
.\"
.\" Copyright (c) 2015 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -136,7 +136,7 @@
attained by resubmitting the writes that were successfully stored in
the log using
.Xr wapbl_replay 9 .
-This may not be the same state just before interruption -- writes in
+This may not be the same state just before interruption \(em writes in
transactions that did not reach the disk will be excluded.
.Pp
For a file system to use
@@ -199,8 +199,8 @@
.Sq inodes
or
.Sq quaggas
-or anything else -- file systems may use this to list any objects keyed
-by
+or anything else \(em file systems may use this to list any objects
+keyed by
.Vt ino_t
value in the log.
.Pp
@@ -436,7 +436,7 @@
.Fn wapbl_end .
.Pp
There is no way to assert that the current transaction is not locked at
-all -- i.e., that the caller may acquire a shared lock on the
+all \(em i.e., that the caller may acquire a shared lock on the
transaction with
.Fn wapbl_begin
without danger of deadlock.
@@ -472,8 +472,8 @@
in FFS: when appending to a file, the pages containing new data may not
reach the disk before the inode update reporting its new size.
After a crash, the inode update will be on disk, but the new data will
-not be -- instead, whatever garbage data in the free space will appear
-to have been appended to the file.
+not be \(em instead, whatever garbage data in the free space will
+appear to have been appended to the file.
.Nm
exacerbates the problem by increasing the throughput of metadata
writes, because it can issue many metadata writes asynchronously that
@@ -500,9 +500,9 @@
.Fn wapbl_unregister_inode .
Consequently, for example, large writes appending to a file, which
requires multiple disk block allocations and an inode update, must
Home |
Main Index |
Thread Index |
Old Index