[PATCH v1 00/12] man/man3/posix_memalign.3: Several fixes, and split the page

[Alejandro Colomar <alx@kernel.org>]

Hi!

After Seth's bug report(s), I've applied several fixes to
posix_memalign.3.  While and after doing that, I've also applied other
patches for improving the page, including a split.

From all of these functions, ISO C's aligned_alloc(3) is the only one
that programmers should be using.  Let's have a page dedicated
exclusively for that function, which documents it well, without noise.

Secondarily, let's have one page for posix_memalign(3), which is still
not officially deprecated, where it is well documented, but point out
that aligned_alloc(3) is preferable.

Then, have one page per each of the other functions, documenting that
they are deprecated, documenting their flaws and subtleties, and
referring to aligned_alloc(3) for the main documentation, as they are
essentially just flawed versions of it.


Have a lovely day!
Alex

Alejandro Colomar (12):
  man/man3/posix_memalign.3: Remove confusing exception
  man/man3/posix_memalign.3: wfix
  man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to ISO
    C17, not C11
  man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C23
  man/man3/posix_memalign.3: STANDARDS: aligned_alloc() and
    posix_memalign() conform to POSIX.1-2024
  man/man3/{posix_,}memalign.3: Split memalign() from posix_memalign(3)
  man/man3/{posix_memalign,pvalloc}.3: Split pvalloc() from
    posix_memalign(3)
  man/man3/{posix_memalign,valloc}.3: Split valloc() from
    posix_memalign(3)
  man/man3/{aligned_alloc,posix_memalign}.3: Split aligned_alloc() from
    posix_memalign(3)
  man/man3/posix_memalign.3: CAVEATS: Add section, and move paragraph to
    it
  man/man3/posix_memalign.3: Remove redundant text
  man/man3/posix_memalign.3: NOTES: Remove superfluous section

 man/man3/aligned_alloc.3  |  99 +++++++++++++++++-
 man/man3/memalign.3       |  77 +++++++++++++-
 man/man3/posix_memalign.3 | 211 +++-----------------------------------
 man/man3/pvalloc.3        |  49 ++++++++-
 man/man3/valloc.3         |  89 +++++++++++++++-
 5 files changed, 326 insertions(+), 199 deletions(-)

Range-diff against v0:
 -:  --------- >  1:  90f18b452 man/man3/posix_memalign.3: Remove confusing exception
 -:  --------- >  2:  19b5ea61e man/man3/posix_memalign.3: wfix
 -:  --------- >  3:  95f523f48 man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to ISO C17, not C11
 -:  --------- >  4:  9db9d670c man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C23
 -:  --------- >  5:  032768ed7 man/man3/posix_memalign.3: STANDARDS: aligned_alloc() and posix_memalign() conform to POSIX.1-2024
 -:  --------- >  6:  de49191b8 man/man3/{posix_,}memalign.3: Split memalign() from posix_memalign(3)
 -:  --------- >  7:  af29aac57 man/man3/{posix_memalign,pvalloc}.3: Split pvalloc() from posix_memalign(3)
 -:  --------- >  8:  03408db2f man/man3/{posix_memalign,valloc}.3: Split valloc() from posix_memalign(3)
 -:  --------- >  9:  6da397d5c man/man3/{aligned_alloc,posix_memalign}.3: Split aligned_alloc() from posix_memalign(3)
 -:  --------- > 10:  213710d2c man/man3/posix_memalign.3: CAVEATS: Add section, and move paragraph to it
 -:  --------- > 11:  7960911fc man/man3/posix_memalign.3: Remove redundant text
 -:  --------- > 12:  54e7d20ee man/man3/posix_memalign.3: NOTES: Remove superfluous section
-- 
2.51.0