svn commit: r243251 - head/share/man/man9

[Konstantin Belousov]

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
> 
> Log:
>   Improve grammar.
>   
>   Approved by:	hrs (mentor)
> 
> Modified:
>   head/share/man/man9/sleep.9
> 
> Modified: head/share/man/man9/sleep.9
> ==============================================================================
> --- 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 are
> +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 instance
> +vnode locks, that should be released in a timely fashion.
>  .Pp
>  The parameter
>  .Fa wmesg
I think the changes are good.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 834 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/svn-src-all/attachments/20121119/e2f326be/attachment.sig>