From patchwork Mon Apr 23 15:27:08 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zack Weinberg X-Patchwork-Id: 26906 Received: (qmail 917 invoked by alias); 23 Apr 2018 15:27:12 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Delivered-To: mailing list libc-alpha@sourceware.org Received: (qmail 905 invoked by uid 89); 23 Apr 2018 15:27:12 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-25.9 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_PASS autolearn=ham version=3.3.2 spammy=sticky, hoped, rewind, terminal X-HELO: mailbackend.panix.com From: Zack Weinberg To: libc-alpha@sourceware.org Subject: [PATCH] NEWS: Reindent and copyedit Date: Mon, 23 Apr 2018 11:27:08 -0400 Message-Id: <20180423152708.20139-1-zackw@panix.com> MIME-Version: 1.0 Make the indentation of the "Deprecated and removed features" section for 2.28 consistent with the indentation of the "Major new features" section above. Also, consistently refer to "stdio functions" instead of "stdio.h functions". Committed. --- NEWS | 58 +++++++++++++++++++++++++++++----------------------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/NEWS b/NEWS index 92c9b14220..3d6b2c8586 100644 --- a/NEWS +++ b/NEWS @@ -27,35 +27,35 @@ Major new features: Deprecated and removed features, and other changes affecting compatibility: - * The nonstandard header files and <_G_config.h> are no longer - installed. Software that was using either header should be updated to - use standard interfaces instead. - - * The stdio.h functions 'getc' and 'putc' are no longer defined as macros. - This was never required by the C standard, and the macros just expanded - to call alternative names for the same functions. If you hoped getc and - putc would provide performance improvements over fgetc and fputc, instead - investigate using (f)getc_unlocked and (f)putc_unlocked, and, if - necessary, flockfile and funlockfile. - - * All stdio functions now treat end-of-file as a sticky condition. If you - read from a file until EOF, and then the file is enlarged by another - process, you must call clearerr or another function with the same effect - (e.g. fseek, rewind) before you can read the additional data. This - corrects a longstanding C99 conformance bug. It is most likely to affect - programs that use stdio to read interactive input from a terminal. - (Bug #1190.) - - * The macros 'major', 'minor', and 'makedev' are now only available from - the header ; not from or various other - headers that happen to include . These macros are rarely - used, not part of POSIX nor XSI, and their names frequently collide with - user code; see https://sourceware.org/bugzilla/show_bug.cgi?id=19239 for - further explanation. - - is a GNU extension. Portable programs that require - these macros should first include , and then include - if __GNU_LIBRARY__ is defined. +* The nonstandard header files and <_G_config.h> are no longer + installed. Software that was using either header should be updated to + use standard interfaces instead. + +* The stdio functions 'getc' and 'putc' are no longer defined as macros. + This was never required by the C standard, and the macros just expanded + to call alternative names for the same functions. If you hoped getc and + putc would provide performance improvements over fgetc and fputc, instead + investigate using (f)getc_unlocked and (f)putc_unlocked, and, if + necessary, flockfile and funlockfile. + +* All stdio functions now treat end-of-file as a sticky condition. If you + read from a file until EOF, and then the file is enlarged by another + process, you must call clearerr or another function with the same effect + (e.g. fseek, rewind) before you can read the additional data. This + corrects a longstanding C99 conformance bug. It is most likely to affect + programs that use stdio to read interactive input from a terminal. + (Bug #1190.) + +* The macros 'major', 'minor', and 'makedev' are now only available from + the header ; not from or various other + headers that happen to include . These macros are rarely + used, not part of POSIX nor XSI, and their names frequently collide with + user code; see https://sourceware.org/bugzilla/show_bug.cgi?id=19239 for + further explanation. + + is a GNU extension. Portable programs that require + these macros should first include , and then include + if __GNU_LIBRARY__ is defined. Changes to build and runtime requirements: