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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox