This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] manual: Remove warning in the documentation of the abort function
- From: Joseph Myers <joseph at codesourcery dot com>
- To: Florian Weimer <fweimer at redhat dot com>
- Cc: <libc-alpha at sourceware dot org>, <rms at gnu dot org>, Alexandre Oliva <oliva at gnu dot org>, Raymond Nicholson <rain1 at airmail dot cc>
- Date: Mon, 7 Oct 2019 20:44:46 +0000
- Subject: Re: [PATCH] manual: Remove warning in the documentation of the abort function
- Ironport-sdr: +ou9T1VIxWBGWcto4/MxxPpKy6dsjzUTu+/WURyJyjLgSXI81601SqC/hp+65xYo/zABjj5GQi DqGsGjz3nrmRUE9B/iW9IQv6Xrd2xKizA+ITxjI7eZuXP4A9WxdzJX1pWVTqkI5LcLrULJ5C3G mmQkT/QbQEBi/x8ynHsvsWZoiHwzVX8YCVAfc87uan84W3qPfbMag+0KPal2nFSk5ZthI7HPFi iFMAFJfl8J6pljAVaHeIPo+MBanw9A+XvXiyjUYxbDXbUMpSlQbVH+cIfy+zgphM2AdoSXGVBc grI=
- Ironport-sdr: d3Uo4Rg5cMO4jggP0l46n/OawKKt/jRUxKIYRwDy8Ejs67Agmxnn6dhOjRKWVT2Ll1IrxHs+7J uMrOdgJbQI2fWFOh9m2O7zf6mhWzeNeYTOLMqAPxuvzCkIb81V4f7L/RNPFtd06FeJH7aHb3Ut XwM6J7e2h+D2HmDwiDFAlvpU566AbsYcUm9CHohutCd0YSJttL+l6HALodXe8kStCIjQOI3mbt pOSWrJRgh/OoCpu0fV5ChNRKy8mrxUoLyjIKup/Jp4is0xtXALNtv+ZOE0x4g9NiGKJonEoc4f bxA=
- References: <87a7ach367.fsf@oldenburg2.str.redhat.com>
I support this change, as removing something that has been confusing in
practice to readers of the manual and does not in any way benefit those
users in understanding the GNU C Library functionality. While humor is
explicitly accepted in GNU, it is also explicitly not required, and in
this particular instance it has proven actively unhelpful. Similarly,
while "It is ok to refer once in a rare while to spatially or temporally
localized reference points or facts, if it is directly pertinent or as an
aside.", in this particular case it impedes understanding of the technical
content for readers without the relevant cultural reference points to
understand that it is intended as humorous content rather than information
about the abort function. Finally, the original reasons for inclusion of
this joke have been thoroughly explored in previous discussions, and so
the current glibc maintainers have all the information needed about those
reasons to take into account in a decision to override a 1992 decision of
a previous maintainer to include it at that time.
--
Joseph S. Myers
joseph@codesourcery.com