refactor: deprecate RAND_MAX constant in FreeBSD

This constant does not seem to have had any changes since a binding was
defined in all modules but the FreeBSD tree.

This deprecation may or may not be worth it, as the only real change was
between FreeBSD 12 and FreeBSD 13.

Author: dybucc

src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs

@@ -259,6 +259,12 @@ s! {
 }
 
 pub const ELAST: c_int = 96;
+#[deprecated(
+    since = "0.2.187",
+    note = "This constant, among others often used in C for the purposes of denoting the latest \
+            value or limit in a set of constants, has been deprecated. See #3131 for details and \
+            discussion."
+)]
 pub const RAND_MAX: c_int = 0x7fff_fffd;
 pub const KI_NSPARE_PTR: usize = 6;
 pub const MINCORE_SUPER: c_int = 0x20;

src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs

@@ -303,6 +303,12 @@ s! {
     }
 }
 
+#[deprecated(
+    since = "0.2.187",
+    note = "This constant, among others often used in C for the purposes of denoting the latest \
+            value or limit in a set of constants, has been deprecated. See #3131 for details and \
+            discussion."
+)]
 pub const RAND_MAX: c_int = 0x7fff_fffd;
 pub const ELAST: c_int = 97;
 

src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs

@@ -316,6 +316,12 @@ s! {
     }
 }
 
+#[deprecated(
+    since = "0.2.187",
+    note = "This constant, among others often used in C for the purposes of denoting the latest \
+            value or limit in a set of constants, has been deprecated. See #3131 for details and \
+            discussion."
+)]
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 pub const ELAST: c_int = 97;
 

src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs

@@ -318,6 +318,12 @@ s! {
     }
 }
 
+#[deprecated(
+    since = "0.2.187",
+    note = "This constant, among others often used in C for the purposes of denoting the latest \
+            value or limit in a set of constants, has been deprecated. See #3131 for details and \
+            discussion."
+)]
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 pub const ELAST: c_int = 97;
 

src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs

@@ -320,6 +320,12 @@ s! {
     }
 }
 
+#[deprecated(
+    since = "0.2.187",
+    note = "This constant, among others often used in C for the purposes of denoting the latest \
+            value or limit in a set of constants, has been deprecated. See #3131 for details and \
+            discussion."
+)]
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 pub const ELAST: c_int = 97;