public inbox for libc-alpha@sourceware.org
 help / color / mirror / Atom feed
* [PATCH] NEWS: Reindent and copyedit
@ 2018-04-23 15:27 Zack Weinberg
  0 siblings, 0 replies; only message in thread
From: Zack Weinberg @ 2018-04-23 15:27 UTC (permalink / raw)
  To: libc-alpha

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 <libio.h> and <_G_config.h> are no longer
-   installed.  Software that was using either header should be updated to
-   use standard <stdio.h> 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 <sys/sysmacros.h>; not from <sys/types.h> or various other
-   headers that happen to include <sys/types.h>.  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.
-
-   <sys/sysmacros.h> is a GNU extension.  Portable programs that require
-   these macros should first include <sys/types.h>, and then include
-   <sys/sysmacros.h> if __GNU_LIBRARY__ is defined.
+* The nonstandard header files <libio.h> and <_G_config.h> are no longer
+  installed.  Software that was using either header should be updated to
+  use standard <stdio.h> 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 <sys/sysmacros.h>; not from <sys/types.h> or various other
+  headers that happen to include <sys/types.h>.  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.
+
+  <sys/sysmacros.h> is a GNU extension.  Portable programs that require
+  these macros should first include <sys/types.h>, and then include
+  <sys/sysmacros.h> if __GNU_LIBRARY__ is defined.
 
 Changes to build and runtime requirements:
 
-- 
2.17.0

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2018-04-23 15:27 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-04-23 15:27 [PATCH] NEWS: Reindent and copyedit Zack Weinberg

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).