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

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 5822 bytes --]

Hi Seth,

On Fri, Jan 09, 2026 at 02:18:54PM +1000, Seth McDonald wrote:
> 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.

This patch set doesn't apply.  Maybe you need to git-fetch(1) and
git-rebase(1)?


Cheers,
Alex

> 
> 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
> 
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]