From 6f458cf1f381726e5ba87bd741b9a71d8b8de773 Mon Sep 17 00:00:00 2001
From: Peter Limkilde Svendsen <peter.limkilde@proton.me>
Date: Wed, 1 Apr 2026 23:20:05 +0200
Subject: [PATCH] Document moved spec of timeval struct

---
 src/header/sys_select/mod.rs | 4 ++++
 src/header/sys_time/mod.rs   | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/src/header/sys_select/mod.rs b/src/header/sys_select/mod.rs
index 72b4d65978..c70581db1c 100644
--- a/src/header/sys_select/mod.rs
+++ b/src/header/sys_select/mod.rs
@@ -23,6 +23,10 @@ use crate::{
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_select.h.html>.
 ///
+/// Note that the `timeval` struct was specified for
+/// [`sys/time.h`](crate::header::sys_time) in the Open Group Base
+/// Specifications Issue 7 and prior, see
+/// <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_time.h.html>.
 #[repr(C)]
 #[derive(Default)]
 pub struct timeval {
diff --git a/src/header/sys_time/mod.rs b/src/header/sys_time/mod.rs
index 1a02d5d74f..2637e04076 100644
--- a/src/header/sys_time/mod.rs
+++ b/src/header/sys_time/mod.rs
@@ -1,6 +1,10 @@
 //! `sys/time.h` implementation.
 //!
 //! See <https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_time.h.html>.
+//!
+//! Note that since the Open Group Base Specifications Issue 8, the
+//! [`timeval`](crate::header::sys_select::timeval) struct has been moved to
+//! the [`sys/select.h`](crate::header::sys_select) header.
 
 use crate::{
     c_str::CStr,