Re: [PATCH v1 08/11] man/man3type/stat.3type: HISTORY: Specify first POSIX appearance of st_{rdev,blksize,blocks}

[Alejandro Colomar <alx@kernel.org>]

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

Hi Seth,

On Thu, Jan 08, 2026 at 01:03:14PM +1000, Seth McDonald wrote:
> From: Seth McDonald <sethmcmail@pm.me>
> 
> 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>
> 
> Signed-off-by: Seth McDonald <sethmcmail@pm.me>
> ---
>  man/man3type/stat.3type | 8 ++++++++
>  1 file changed, 8 insertions(+)
> 
> diff --git a/man/man3type/stat.3type b/man/man3type/stat.3type
> index 44d45b4a52b4..83f6e881a5ae 100644
> --- a/man/man3type/stat.3type
> +++ b/man/man3type/stat.3type
> @@ -137,6 +137,14 @@ .SH STANDARDS
>  .SH HISTORY
>  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

I think this would be simpler like this:

	@@ -135,7 +135,14 @@ .SH DESCRIPTION
	 .SH STANDARDS
	 POSIX.1-2024.
	 .SH HISTORY
	+.TP
	+.I stat
	 POSIX.1-1988.
	+.TP
	+.I .st_rdev
	+.I .st_blksize
	+.I .st_blocks
	+SUSv1, POSIX.1-2001 XSI.
	 .P
	 Old kernels and old standards did not support nanosecond timestamp fields.
	 Instead, there were three timestamp fields

What do you think?


Have a lovely day!
Alex

>  Old kernels and old standards did not support nanosecond timestamp fields.
>  Instead, there were three timestamp fields
>  .RI \[em] .st_atime ,
> -- 
> 2.47.3
> 

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

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