about summary refs log tree commit diff
diff options
context:
space:
mode:
authorFlorian Weimer <fweimer@redhat.com>2019-10-11 20:15:24 +0200
committerFlorian Weimer <fweimer@redhat.com>2019-10-11 20:15:24 +0200
commit7f0e1933f08d52b22b02fdcd075382506f7b2e9c (patch)
treedaf8aed3eac11f3ad10a6a02136cd747fc61e308
parent2f959dfe849e0646e27403f2e4091536496ac0f0 (diff)
downloadglibc-7f0e1933f08d52b22b02fdcd075382506f7b2e9c.tar.gz
glibc-7f0e1933f08d52b22b02fdcd075382506f7b2e9c.tar.xz
glibc-7f0e1933f08d52b22b02fdcd075382506f7b2e9c.zip
manual: Remove warning in the documentation of the abort function
The warning is confusing to those who do not understand the context,
and the warning is easy to misunderstand:

A reader needs to know that it was written by someone who is generally
skeptical of government influence and control, otherwise it reads as
an affirmation of the U.S. government's role as the ultimate editor of
the manual.  This is precisely the opposite of what the warning
intends to convey.  (Reportedly, it criticizes that several
U.S. administrations have tried to restrict the medical advice that
U.S.-funded health care workers can provide abroad, considering that
censorship.)

The warning is also misleading on a technical level.  A reader who
makes the connection to pregnancy termination will get the wrong
impression that calling the abort function will terminate subprocesses
of the current process, but this is not what generally happens.

Finally, for both GNU and the FSF, it is inappropriate to use female
reproductive health as mere joke material, since these organizations
do not concern themselves with such issues otherwise, and the warning
is purportedly about something else entirely.

This reinstates commit 340d9652b9d0e1d4136588f18b726662d195777c
("manual/startup.texi (Aborting a Program): Remove inappropriate
joke."), effectively reverting the revert in commit
ffa81c22a3ac0fb75ad9bf2b1c3cdbf9eafa0bc9 ("Revert:").

Reviewed-by: Adhemerval Zanella  <adhemerval.zanella@linaro.org>
Reviewed-by: Carlos O'Donell <carlos@redhat.com>
-rw-r--r--ChangeLog4
-rw-r--r--manual/startup.texi8
2 files changed, 4 insertions, 8 deletions
diff --git a/ChangeLog b/ChangeLog
index 6bf3462b58..be1ab6469e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2019-10-11  Florian Weimer  <fweimer@redhat.com>
+
+	* manual/startup.texi (Aborting a Program): Remove warning.
+
 2019-10-10  Adhemerval Zanella  <adhemerval.zanella@linaro.org>
 
 	[BZ #18231]
diff --git a/manual/startup.texi b/manual/startup.texi
index 7395d32dd0..21c48cd037 100644
--- a/manual/startup.texi
+++ b/manual/startup.texi
@@ -1005,14 +1005,6 @@ This function actually terminates the process by raising a
 intercept this signal; see @ref{Signal Handling}.
 @end deftypefun
 
-@c Put in by rms.  Don't remove.
-@cartouche
-@strong{Future Change Warning:} Proposed Federal censorship regulations
-may prohibit us from giving you information about the possibility of
-calling this function.  We would be required to say that this is not an
-acceptable way of terminating a program.
-@end cartouche
-
 @node Termination Internals
 @subsection Termination Internals