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

[Alejandro Colomar <alx@kernel.org>]

Hi!

In v2, I've removed the explicit sentence saying that one should use
aligned_alloc(3) instead of memalign(3).

I've also documented that C11 had a bogus specification for
aligned_alloc(3), and that OpenBSD still implements that (although at
least, they don't exploit the UB).  I've CCed them, in case they're not
aware that C17 fixed those issues.

I've documented that while the C11 specification had a lot of UB, no
implementation has ever implemented that, and so it's just theoretical
(and thankfully extinct) UB.

Apart from that, there are minor wording tweaks.

See the range-diff below.


Have a lovely day!
Alex


Alejandro Colomar (14):
  man/man3/posix_memalign.3: Remove confusing exception
  man/man3/posix_memalign.3: wfix
  man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to 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/memalign.3: wfix
  man/man3/aligned_alloc.3: HISTORY: Document bogus specification from
    C11

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

Range-diff against v1:
 1:  90f18b452 =  1:  90f18b452 man/man3/posix_memalign.3: Remove confusing exception
 2:  19b5ea61e =  2:  19b5ea61e man/man3/posix_memalign.3: wfix
 3:  95f523f48 !  3:  82bcf3b0f man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to ISO C17, not C11
    @@ Metadata
     Author: Alejandro Colomar <alx@kernel.org>
     
      ## Commit message ##
    -    man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to ISO C17, not C11
    +    man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C17, not C11
     
         ISO C17 removed a restriction that was in place in C11.  This
         documentation doesn't conform to C11; it conforms to C17.
 4:  9db9d670c =  4:  04f5087e5 man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C23
 5:  032768ed7 =  5:  c8ffb2124 man/man3/posix_memalign.3: STANDARDS: aligned_alloc() and posix_memalign() conform to POSIX.1-2024
 6:  de49191b8 !  6:  51b7f9f43 man/man3/{posix_,}memalign.3: Split memalign() from posix_memalign(3)
    @@ man/man3/memalign.3
     +.SH DESCRIPTION
     +.BR memalign ()
     +is the same as
    -+.BR aligned_alloc ().
    -+Use that instead.
    ++.BR aligned_alloc (3).
     +.\" The behavior of memalign() for size==0 is as for posix_memalign()
     +.\" but no standards govern this.
     +.SH ATTRIBUTES
 7:  af29aac57 =  7:  a60d6283f man/man3/{posix_memalign,pvalloc}.3: Split pvalloc() from posix_memalign(3)
 8:  03408db2f =  8:  126c39d0f man/man3/{posix_memalign,valloc}.3: Split valloc() from posix_memalign(3)
 9:  6da397d5c =  9:  b23cb7bc6 man/man3/{aligned_alloc,posix_memalign}.3: Split aligned_alloc() from posix_memalign(3)
10:  213710d2c = 10:  1e5a0260e man/man3/posix_memalign.3: CAVEATS: Add section, and move paragraph to it
11:  7960911fc = 11:  c0b9fd96a man/man3/posix_memalign.3: Remove redundant text
12:  54e7d20ee = 12:  34d984534 man/man3/posix_memalign.3: NOTES: Remove superfluous section
 -:  --------- > 13:  a5342ef55 man/man3/memalign.3: wfix
 -:  --------- > 14:  cdfc42078 man/man3/aligned_alloc.3: HISTORY: Document bogus specification from C11
-- 
2.51.0