From: Samanta Navarro <ferivoz@riseup.net>
To: linux-man@vger.kernel.org
Cc: alx.manpages@gmail.com, mtk.manpages@gmail.com
Subject: [patch] pthread_cancel.3, pthread_cleanup_push_defer_np.3, pthread_setcancelstate.3, pthread_testcancel.3, pthreads.7: tfix
Date: Sat, 13 Nov 2021 11:56:56 +0000 [thread overview]
Message-ID: <20211113115656.5oomvy443gapjtx4@localhost> (raw)
Changed cancelability to cancellability.
Typo found with codespell.
Signed-off-by: Samanta Navarro <ferivoz@riseup.net>
---
man3/pthread_cancel.3 | 10 +++++-----
man3/pthread_cleanup_push_defer_np.3 | 10 +++++-----
man3/pthread_setcancelstate.3 | 30 ++++++++++++++--------------
man3/pthread_testcancel.3 | 2 +-
man7/pthreads.7 | 4 ++--
5 files changed, 28 insertions(+), 28 deletions(-)
diff --git a/man3/pthread_cancel.3 b/man3/pthread_cancel.3
index 01b7cf0..9ea1d4a 100644
--- a/man3/pthread_cancel.3
+++ b/man3/pthread_cancel.3
@@ -42,12 +42,12 @@ function sends a cancellation request to the thread
Whether and when the target thread
reacts to the cancellation request depends on
two attributes that are under the control of that thread:
-its cancelability
+its cancellability
.I state
and
.IR type .
.PP
-A thread's cancelability state, determined by
+A thread's cancellability state, determined by
.BR pthread_setcancelstate (3),
can be
.I enabled
@@ -57,7 +57,7 @@ If a thread has disabled cancellation,
then a cancellation request remains queued until the thread
enables cancellation.
If a thread has enabled cancellation,
-then its cancelability type determines when cancellation occurs.
+then its cancellability type determines when cancellation occurs.
.PP
A thread's cancellation type, determined by
.BR pthread_setcanceltype (3),
@@ -66,10 +66,10 @@ may be either
or
.IR deferred
(the default for new threads).
-Asynchronous cancelability
+Asynchronous cancellability
means that the thread can be canceled at any time
(usually immediately, but the system does not guarantee this).
-Deferred cancelability means that cancellation will be delayed until
+Deferred cancellability means that cancellation will be delayed until
the thread next calls a function that is a
.IR "cancellation point" .
A list of functions that are or may be cancellation points is provided in
diff --git a/man3/pthread_cleanup_push_defer_np.3 b/man3/pthread_cleanup_push_defer_np.3
index c5096d1..1daf210 100644
--- a/man3/pthread_cleanup_push_defer_np.3
+++ b/man3/pthread_cleanup_push_defer_np.3
@@ -26,7 +26,7 @@
.TH PTHREAD_CLEANUP_PUSH_DEFER_NP 3 2021-03-22 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_cleanup_push_defer_np, pthread_cleanup_pop_restore_np \- push and pop
-thread cancellation clean-up handlers while saving cancelability type
+thread cancellation clean-up handlers while saving cancellability type
.SH SYNOPSIS
.nf
.B #include <pthread.h>
@@ -60,11 +60,11 @@ Like
pushes
.I routine
onto the thread's stack of cancellation clean-up handlers.
-In addition, it also saves the thread's current cancelability type,
-and sets the cancelability type to "deferred" (see
+In addition, it also saves the thread's current cancellability type,
+and sets the cancellability type to "deferred" (see
.BR pthread_setcanceltype (3));
this ensures that cancellation clean-up will occur
-even if the thread's cancelability type was "asynchronous"
+even if the thread's cancellability type was "asynchronous"
before the call.
.PP
Like
@@ -72,7 +72,7 @@ Like
.BR pthread_cleanup_pop_restore_np ()
pops the top-most clean-up handler from the thread's
stack of cancellation clean-up handlers.
-In addition, it restores the thread's cancelability
+In addition, it restores the thread's cancellability
type to its value at the time of the matching
.BR pthread_cleanup_push_defer_np ().
.PP
diff --git a/man3/pthread_setcancelstate.3 b/man3/pthread_setcancelstate.3
index 56e2acf..5ef6ce6 100644
--- a/man3/pthread_setcancelstate.3
+++ b/man3/pthread_setcancelstate.3
@@ -26,7 +26,7 @@
.TH PTHREAD_SETCANCELSTATE 3 2021-03-22 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_setcancelstate, pthread_setcanceltype \-
-set cancelability state and type
+set cancellability state and type
.SH SYNOPSIS
.nf
.B #include <pthread.h>
@@ -39,10 +39,10 @@ Compile and link with \fI\-pthread\fP.
.SH DESCRIPTION
The
.BR pthread_setcancelstate ()
-sets the cancelability state of the calling thread to the value
+sets the cancellability state of the calling thread to the value
given in
.IR state .
-The previous cancelability state of the thread is returned
+The previous cancellability state of the thread is returned
in the buffer pointed to by
.IR oldstate .
The
@@ -51,22 +51,22 @@ argument must have one of the following values:
.TP
.B PTHREAD_CANCEL_ENABLE
The thread is cancelable.
-This is the default cancelability state in all new threads,
+This is the default cancellability state in all new threads,
including the initial thread.
-The thread's cancelability type determines when a cancelable thread
+The thread's cancellability type determines when a cancelable thread
will respond to a cancellation request.
.TP
.B PTHREAD_CANCEL_DISABLE
The thread is not cancelable.
If a cancellation request is received,
-it is blocked until cancelability is enabled.
+it is blocked until cancellability is enabled.
.PP
The
.BR pthread_setcanceltype ()
-sets the cancelability type of the calling thread to the value
+sets the cancellability type of the calling thread to the value
given in
.IR type .
-The previous cancelability type of the thread is returned
+The previous cancellability type of the thread is returned
in the buffer pointed to by
.IR oldtype .
The
@@ -77,7 +77,7 @@ argument must have one of the following values:
A cancellation request is deferred until the thread next calls
a function that is a cancellation point (see
.BR pthreads (7)).
-This is the default cancelability type in all new threads,
+This is the default cancellability type in all new threads,
including the initial thread.
.IP
Even with deferred cancellation, a
@@ -148,14 +148,14 @@ POSIX.1-2001, POSIX.1-2008.
For details of what happens when a thread is canceled, see
.BR pthread_cancel (3).
.PP
-Briefly disabling cancelability is useful
+Briefly disabling cancellability is useful
if a thread performs some critical action
that must not be interrupted by a cancellation request.
-Beware of disabling cancelability for long periods,
+Beware of disabling cancellability for long periods,
or around operations that may block for long periods,
since that will render the thread unresponsive to cancellation requests.
-.SS Asynchronous cancelability
-Setting the cancelability type to
+.SS Asynchronous cancellability
+Setting the cancellability type to
.B PTHREAD_CANCEL_ASYNCHRONOUS
is rarely useful.
Since the thread could be canceled at
@@ -185,7 +185,7 @@ be async-cancel-safe.
In general, other library functions
can't be safely called from an asynchronously cancelable thread.
.PP
-One of the few circumstances in which asynchronous cancelability is useful
+One of the few circumstances in which asynchronous cancellability is useful
is for cancellation of a thread that is in a pure compute-bound loop.
.SS Portability notes
The Linux threading implementations permit the
@@ -193,7 +193,7 @@ The Linux threading implementations permit the
argument of
.BR pthread_setcancelstate ()
to be NULL, in which case the information about the previous
-cancelability state is not returned to the caller.
+cancellability state is not returned to the caller.
Many other implementations also permit a NULL
.I oldstat
argument,
diff --git a/man3/pthread_testcancel.3 b/man3/pthread_testcancel.3
index 8dc2d61..88cfa94 100644
--- a/man3/pthread_testcancel.3
+++ b/man3/pthread_testcancel.3
@@ -41,7 +41,7 @@ creates a cancellation point within the calling thread,
so that a thread that is otherwise executing code that contains
no cancellation points will respond to a cancellation request.
.PP
-If cancelability is disabled (using
+If cancellability is disabled (using
.BR pthread_setcancelstate (3)),
or no cancellation request is pending,
then a call to
diff --git a/man7/pthreads.7 b/man7/pthreads.7
index 6f4f6e7..1a347a7 100644
--- a/man7/pthreads.7
+++ b/man7/pthreads.7
@@ -242,7 +242,7 @@ wctomb()
.in
.SS Async-cancel-safe functions
An async-cancel-safe function is one that can be safely called
-in an application where asynchronous cancelability is enabled (see
+in an application where asynchronous cancellability is enabled (see
.BR pthread_setcancelstate (3)).
.PP
Only the following functions are required to be async-cancel-safe by
@@ -258,7 +258,7 @@ pthread_setcanceltype()
.SS Cancellation points
POSIX.1 specifies that certain functions must,
and certain other functions may, be cancellation points.
-If a thread is cancelable, its cancelability type is deferred,
+If a thread is cancelable, its cancellability type is deferred,
and a cancellation request is pending for the thread,
then the thread is canceled when it calls a function
that is a cancellation point.
--
2.33.1
next reply other threads:[~2021-11-13 12:05 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-11-13 11:56 Samanta Navarro [this message]
2021-11-13 12:40 ` [patch] pthread_cancel.3, pthread_cleanup_push_defer_np.3, pthread_setcancelstate.3, pthread_testcancel.3, pthreads.7: tfix G. Branden Robinson
2021-11-13 13:00 ` Samanta Navarro
2021-11-22 17:09 ` Alejandro Colomar (man-pages)
2021-11-24 11:58 ` Samanta Navarro
2021-11-29 11:59 ` Alejandro Colomar (man-pages)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20211113115656.5oomvy443gapjtx4@localhost \
--to=ferivoz@riseup.net \
--cc=alx.manpages@gmail.com \
--cc=linux-man@vger.kernel.org \
--cc=mtk.manpages@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.