man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections

-  Add a new HISTORY section that covers the history of an API, both
   regarding implementations and regarding old standards.  This was
   previously covered in VERSIONS, and in some cases in STANDARDS.

-  Repurpose VERSIONS to cover differing implementations in _current_
   systems.

-  STANDARDS is reduced to only cover current versions of standards.
   That basically means only C11 (C99 has been superseeded by C11; C17
   is just a bugfix of C11, so not really a new version), and
   POSIX.1-2008 (*-2001 was superseeded by *-2008; *-2017 was just a
   bugfix for *-2008).  The section also mentions for example 'Linux',
   'GNU' or 'BSD' when a non-standard API is Linux- or GNU-only or if
   it's (de-facto) standard in the BSDs.

-  In some cases content that should go into one of these sections was
   in NOTES.  Move it from there to where it corresponds.

-  In the SYNOPSIS, I added [[deprecated]] in some functions that I
   found are deprecated by the relevant standards.

-  A few other related changes...

Cc: Oskari Pirhonen <xxc3ncoredxx@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

4 files changed, 10 insertions, 10 deletions

diff --git a/man1/iconv.1 b/man1/iconv.1
index ece86aa6d..959275183 100644
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -160,6 +160,8 @@ Depending on the architecture,
 the above files may instead be located at directories with the path prefix
 .IR /usr/lib64 .
 .SH STANDARDS
+POSIX.1-2008.
+.SH HISTORY
 POSIX.1-2001.
 .SH EXAMPLES
 Convert text from the ISO 8859-15 character encoding to UTF-8:
diff --git a/man1/locale.1 b/man1/locale.1
index 368bb5eea..4e257eb7b 100644
--- a/man1/locale.1
+++ b/man1/locale.1
@@ -119,7 +119,9 @@ Usual default locale archive location.
 .I /usr/share/i18n/locales
 Usual default path for locale definition files.
 .SH STANDARDS
-POSIX.1-2001, POSIX.1-2008.
+POSIX.1-2008.
+.SH HISTORY
+POSIX.1-2001.
 .SH EXAMPLES
 .EX
 $ \fBlocale\fP
diff --git a/man1/pldd.1 b/man1/pldd.1
index 36d8a48dd..f7bff8c2f 100644
--- a/man1/pldd.1
+++ b/man1/pldd.1
@@ -39,15 +39,13 @@ or no command-line arguments are supplied,
 exists with a status of 1.
 If given an invalid option, it exits with the status 64.
 .SH VERSIONS
-.B pldd
-is available since glibc 2.15.
-.SH STANDARDS
-The
-.B pldd
-command is not specified by POSIX.1.
 Some other systems
 .\" There are man pages on Solaris and HP-UX.
 have a similar command.
+.SH STANDARDS
+None.
+.SH HISTORY
+glibc 2.15.
 .SH NOTES
 The command
 .PP
diff --git a/man1/sprof.1 b/man1/sprof.1
index 79c86b499..04903d6e9 100644
--- a/man1/sprof.1
+++ b/man1/sprof.1
@@ -53,9 +53,7 @@ Display a short usage message and exit.
 .BR \-V ", " \-\-version
 Display the program version and exit.
 .SH STANDARDS
-The
-.B sprof
-command is a GNU extension, not present in POSIX.1.
+GNU.
 .SH EXAMPLES
 The following example demonstrates the use of
 .BR sprof .