This is the mail archive of the glibc-cvs@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[glibc] manual: Remove warning in the documentation of the abort function


https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=7f0e1933f08d52b22b02fdcd075382506f7b2e9c

commit 7f0e1933f08d52b22b02fdcd075382506f7b2e9c
Author: Florian Weimer <fweimer@redhat.com>
Date:   Fri Oct 11 20:15:24 2019 +0200

    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>

Diff:
---
 ChangeLog           | 4 ++++
 manual/startup.texi | 8 --------
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 6bf3462..be1ab64 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 7395d32..21c48cd 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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]