From d5e0a565fcedc24011858b024dc37913a4ef9c26 Mon Sep 17 00:00:00 2001
From: dybucc <149513579+dybucc@users.noreply.github.com>
Date: Thu, 28 May 2026 09:35:15 +0200
Subject: [PATCH] freebsd: annotate unstable `RAND_MAX`

This symbol has changed recently. It needs usage advice. This patch
links to that.
---
 src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs | 5 ++++-
 src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs | 4 +++-
 src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs | 4 +++-
 src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs | 4 +++-
 src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs | 4 +++-
 5 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs
index 6b333560d9fb..3f3a55a281f0 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs
@@ -258,11 +258,14 @@ s! {
     }
 }
 
-/// This symbols is prone to change across releases upstream.
+/// This symbol is prone to change across releases upstream.
 /// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const ELAST: c_int = 96;
 
+/// This symbol is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_fffd;
+
 pub const KI_NSPARE_PTR: usize = 6;
 pub const MINCORE_SUPER: c_int = 0x20;
 /// max length of devicename
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs
index 505e54b2d1e4..a8cce3293143 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs
@@ -303,9 +303,11 @@ s! {
     }
 }
 
+/// This symbol is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_fffd;
 
-/// This symbols is prone to change across releases upstream.
+/// This symbol is prone to change across releases upstream.
 /// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const ELAST: c_int = 97;
 
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs
index 731362a58e0b..26f49d41ff30 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs
@@ -316,9 +316,11 @@ s! {
     }
 }
 
+/// This symbol is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 
-/// This symbols is prone to change across releases upstream.
+/// This symbol is prone to change across releases upstream.
 /// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const ELAST: c_int = 97;
 
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs
index b61df3b1be17..ea5a14d9e5d0 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs
@@ -318,9 +318,11 @@ s! {
     }
 }
 
+/// This symbol is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 
-/// This symbols is prone to change across releases upstream.
+/// This symbol is prone to change across releases upstream.
 /// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const ELAST: c_int = 97;
 
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs
index 7ea5c27eea34..7f415180a196 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs
@@ -320,9 +320,11 @@ s! {
     }
 }
 
+/// This symbol is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 
-/// This symbols is prone to change across releases upstream.
+/// This symbol is prone to change across releases upstream.
 /// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const ELAST: c_int = 97;