Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 19 Nov 2012 07:45:14 +0200
From:      Konstantin Belousov <kostikbel@gmail.com>
To:        Benjamin Kaduk <bjk@freebsd.org>
Cc:        svn-src-head@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org
Subject:   Re: svn commit: r243251 - head/share/man/man9
Message-ID:  <20121119054514.GL73505@kib.kiev.ua>
In-Reply-To: <201211182252.qAIMqHvN028232@svn.freebsd.org>
References:  <201211182252.qAIMqHvN028232@svn.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--nSm7qnGuElBFM7UH
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sun, Nov 18, 2012 at 10:52:17PM +0000, Benjamin Kaduk wrote:
> Author: bjk (doc committer)
> Date: Sun Nov 18 22:52:17 2012
> New Revision: 243251
> URL: http://svnweb.freebsd.org/changeset/base/243251
>=20
> Log:
>   Improve grammar.
>  =20
>   Approved by:	hrs (mentor)
>=20
> Modified:
>   head/share/man/man9/sleep.9
>=20
> Modified: head/share/man/man9/sleep.9
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D
> --- head/share/man/man9/sleep.9	Sun Nov 18 22:03:31 2012	(r243250)
> +++ head/share/man/man9/sleep.9	Sun Nov 18 22:52:17 2012	(r243251)
> @@ -102,7 +102,8 @@ If
>  .Fa priority
>  includes the
>  .Dv PCATCH
> -flag, signals are checked before and after sleeping, otherwise signals a=
re
> +flag, pending
> +signals are checked before and after sleeping, otherwise signals are
>  not checked.
There, both old and new formulations are strange. The PCATCH flag causes
the signal enqueuing to interrupt sleep, so saying that signals are
checked before and after, although not wrong, is also confusing.

>  If
>  .Dv PCATCH
> @@ -114,17 +115,18 @@ possible, and
>  is returned if the system call should be interrupted by the signal
>  (return
>  .Er EINTR ) .
> -If
> +If the
>  .Dv PBDRY
>  flag is specified in addition to
>  .Dv PCATCH ,
> -then the sleeping thread is not stopped while sleeping upon delivery of
> +then the sleeping thread is not stopped upon delivery of
>  .Dv SIGSTOP
> -or other stop action.
> -Instead, it is waken up, assuming that stop occurs on reaching a stop
> +or other stop action while it is sleeping.
> +Instead, it is woken up, with the assumption
> +that the stop will occur on reaching a stop
>  point when returning to usermode.
> -The flag should be used when sleeping thread owns resources, for instance
> -vnode locks, that should be freed timely.
> +The flag should be used when the sleeping thread owns resources, for ins=
tance
> +vnode locks, that should be released in a timely fashion.
>  .Pp
>  The parameter
>  .Fa wmesg
I think the changes are good.

--nSm7qnGuElBFM7UH
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (FreeBSD)

iQIcBAEBAgAGBQJQqcdqAAoJEJDCuSvBvK1BoF4P/0L6zmNYCttQsk7eeb/Ds86I
vYPLL/gIqfjRO9RKt39du5g8DJwLURmQ7MGKxQxcrqFy9qiJajXN69VjJhuphEdJ
3O5R+Nxrprlb0X79OOll0D8V+DtiCCPiWZ8ABJv4BxZ1UVR/+eDcv4ANEUWo/crF
K+M7Ib5jaZROsWPnPkZH2UqYDos50Mxzo4F5AFfpRunJF2/BNQvdEn8AaQnMKkwh
lR0hGWFVwgT0i26DH4p5wgqDvUCDKnBvof7n4sdgiMMdhJcmhG9G0DAAxCmxyYQo
4vKDRWPgpWvnOz56zHMlwW8meoVcSQ5rZdv/RpkUkew1/l+PxPxH3vdP0yZ+sVJa
oysN9NFqiivTk1tLQwOw9eU+l/1UFu4GOtdY99tXrQhzvlFVuUOtNiy2xM62vOf6
F+ynRjeclg3x+tKsMIV1QVyxK2LEqJabMxNrV+AQmdgMNwMAXlsHiYvkSLhpnQCC
VhjbSdDfRRUS9p4jyc1x3ou4zRJtyOODj45zbyscBR9xbQeg1zr9r3NCIC6nSu7Q
1dj3YyEspodovfUer83S/XpCkBGkVNy2b6kOGhLgFycym0B91f6mfVoib5cTawAZ
TU+l78csC6oE6XKe8f1OdzhyqdZQkv1dIM9/41bStCt+UQ5mOLWkcVyBXC1psSNH
Hh+hA3DBtU3ozoeATcBN
=pScn
-----END PGP SIGNATURE-----

--nSm7qnGuElBFM7UH--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20121119054514.GL73505>