diff options
author | Florian Weimer <fweimer@redhat.com> | 2019-10-11 20:15:24 +0200 |
---|---|---|
committer | Florian Weimer <fweimer@redhat.com> | 2019-10-11 20:15:24 +0200 |
commit | 7f0e1933f08d52b22b02fdcd075382506f7b2e9c (patch) | |
tree | daf8aed3eac11f3ad10a6a02136cd747fc61e308 | |
parent | 2f959dfe849e0646e27403f2e4091536496ac0f0 (diff) | |
download | glibc-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-- | ChangeLog | 4 | ||||
-rw-r--r-- | manual/startup.texi | 8 |
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 |