[PATCH v2 00/12] man/man3type/*: Update simple history of types

[Seth McDonald <seth.i.mcdonald@gmail.com>]

Hello,

v2 applies Alex's feedback and reformats the stat(3type) page's history
section by listing the structure's members' different origins in a way
consistent with other man pages.  I also added a separate patch for
splitting stat(3type) and its members' listed standards for nicer
logical ordering.

Seth McDonald (12):
  man/man3type/itimerspec.3type: HISTORY: Update first POSIX appearance
    of itimerspec(3type)
  man/man3type/mode_t.3type: HISTORY: Update first POSIX appearance of
    mode_t(3type)
  man/man3type/off_t.3type: Change VERSIONS to HISTORY
  man/man3type/off_t.3type: HISTORY: Update first POSIX appearance of
    off_t(3type)
  man/man3type/sigevent.3type: HISTORY: Update first POSIX appearance of
    sig{event,val}(3type)
  man/man3type/stat.3type: SYNOPSIS: wfix
  man/man3type/stat.3type: HISTORY: Update first POSIX appearance of
    stat(3type)
  man/man3type/stat.3type: HISTORY: Split stat(3type) from
    st_{rdev,blksize,blocks}
  man/man3type/stat.3type: HISTORY: Specify first POSIX appearance of
    st_{rdev,blksize,blocks}
  man/man3type/stat.3type: HISTORY: Specify initial datatypes of
    st_{blksize,blocks}
  man/man3type/timer_t.3type: HISTORY: Update first POSIX appearance of
    timer_t(3type)
  man/man3type/timespec.3type: HISTORY: Update first POSIX appearance of
    timespec(3type)

 man/man3type/itimerspec.3type |  2 +-
 man/man3type/mode_t.3type     |  2 +-
 man/man3type/off_t.3type      |  4 ++--
 man/man3type/sigevent.3type   |  2 +-
 man/man3type/stat.3type       | 22 ++++++++++++++++++++--
 man/man3type/timer_t.3type    |  2 +-
 man/man3type/timespec.3type   |  2 +-
 7 files changed, 27 insertions(+), 9 deletions(-)

Range-diff against v1:
 1:  48b823b1a965 =  1:  48b823b1a965 man/man3type/itimerspec.3type: HISTORY: Update first POSIX appearance of itimerspec(3type)
 2:  90f54d80c479 =  2:  90f54d80c479 man/man3type/mode_t.3type: HISTORY: Update first POSIX appearance of mode_t(3type)
 3:  c1498253ab68 =  3:  c1498253ab68 man/man3type/off_t.3type: Change VERSIONS to HISTORY
 4:  6b062b0d6afa =  4:  6b062b0d6afa man/man3type/off_t.3type: HISTORY: Update first POSIX appearance of off_t(3type)
 5:  6919cafeb4e3 =  5:  6919cafeb4e3 man/man3type/sigevent.3type: HISTORY: Update first POSIX appearance of sig{event,val}(3type)
 6:  84a9e467d506 =  6:  84a9e467d506 man/man3type/stat.3type: SYNOPSIS: wfix
 7:  0611f62eeedb =  7:  0611f62eeedb man/man3type/stat.3type: HISTORY: Update first POSIX appearance of stat(3type)
 8:  9d3a705508aa !  8:  623290de35e6 man/man3type/stat.3type: HISTORY: Specify first POSIX appearance of st_{rdev,blksize,blocks}
    @@ Metadata
     Author: Seth McDonald <sethmcmail@pm.me>
     
      ## Commit message ##
    -    man/man3type/stat.3type: HISTORY: Specify first POSIX appearance of
    +    man/man3type/stat.3type: HISTORY: Split stat(3type) from
         st_{rdev,blksize,blocks}
     
    -    The st_rdev, st_blksize, and st_blocks fields of the stat(3type)
    -    structure first appeared in SUSv1.[1]  They were added to POSIX.1-2001
    -    when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
    -
    -    [1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
    -    Version 2, Chapter 4 "Headers", p. 830.
    -    [2] IEEE Std 1003.1-2001, Volume 1, Chapter 13 "Headers", p. 356.
    -    <https://pubs.opengroup.org/onlinepubs/009604499/basedefs/sys/stat.h.html>
    -
      ## man/man3type/stat.3type ##
    -@@ man/man3type/stat.3type: .SH STANDARDS
    +@@ man/man3type/stat.3type: .SH DESCRIPTION
    + .SH STANDARDS
    + POSIX.1-2024.
      .SH HISTORY
    ++.TP
    ++.I stat
    ++POSIX.1-1988.
    ++.TP
    ++.I .st_rdev
    ++.TQ
    ++.I .st_blksize
    ++.TQ
    ++.I .st_blocks
      POSIX.1-1988.
      .P
    -+The
    -+.IR .st_rdev ,
    -+.IR .st_blksize ,
    -+and
    -+.I .st_blocks
    -+fields first appeared in SUSv1
    -+before being added to POSIX.1-2001 XSI.
    -+.P
      Old kernels and old standards did not support nanosecond timestamp fields.
    - Instead, there were three timestamp fields
    - .RI \[em] .st_atime ,
 -:  ------------ >  9:  a33e91f7c1b7 man/man3type/stat.3type: HISTORY: Specify first POSIX appearance of st_{rdev,blksize,blocks}
 9:  e13690db2fb6 ! 10:  3ffb01f7c196 man/man3type/stat.3type: HISTORY: Specify initial datatypes of st_{blksize,blocks}
    @@ Commit message
     
      ## man/man3type/stat.3type ##
     @@ man/man3type/stat.3type: .SH HISTORY
    - .I .st_blocks
    - fields first appeared in SUSv1
    - before being added to POSIX.1-2001 XSI.
    + SUSv1,
    + POSIX.1-2001 XSI.
    + .P
     +Initially, SUSv1 specified
     +.I .st_blksize
     +and
     +.I .st_blocks
     +with type
     +.IR long .
     +This was remedied in SUSv2.
    - .P
    ++.P
      Old kernels and old standards did not support nanosecond timestamp fields.
      Instead, there were three timestamp fields
    + .RI \[em] .st_atime ,
10:  eb28bf22aed9 = 11:  d6fc0ff67155 man/man3type/timer_t.3type: HISTORY: Update first POSIX appearance of timer_t(3type)
11:  d25e140aaabe = 12:  9b6fedfdc71e man/man3type/timespec.3type: HISTORY: Update first POSIX appearance of timespec(3type)
-- 
2.47.3