From cdf4fd1d71bcfcf415d7daa6cb8322a25a49a799 Mon Sep 17 00:00:00 2001
From: auronandace <auronandace@googlemail.com>
Date: Wed, 20 May 2026 09:35:35 +0100
Subject: [PATCH] add descriptions to endian functions

---
 src/header/endian/cbindgen.toml |  1 -
 src/header/endian/mod.rs        | 36 +++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/src/header/endian/cbindgen.toml b/src/header/endian/cbindgen.toml
index 698eb0088c..fe43cca175 100644
--- a/src/header/endian/cbindgen.toml
+++ b/src/header/endian/cbindgen.toml
@@ -7,6 +7,5 @@ sys_includes = ["stdint.h"]
 include_guard = "_RELIBC_ENDIAN_H"
 trailer = "#include <machine/endian.h>"
 language = "C"
-style = "Tag"
 no_includes = true
 cpp_compat = true
diff --git a/src/header/endian/mod.rs b/src/header/endian/mod.rs
index 8c78b3bdfa..3e3b76c201 100644
--- a/src/header/endian/mod.rs
+++ b/src/header/endian/mod.rs
@@ -5,72 +5,108 @@
 use crate::platform::types::{uint16_t, uint32_t, uint64_t};
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint16_t` from big endian representation to host endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn be16toh(x: uint16_t) -> uint16_t {
     uint16_t::from_be(x)
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint32_t` from big endian representation to host endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn be32toh(x: uint32_t) -> uint32_t {
     uint32_t::from_be(x)
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint64_t` from big endian representation to host endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn be64toh(x: uint64_t) -> uint64_t {
     uint64_t::from_be(x)
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint16_t` from host endian representation to big endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn htobe16(x: uint16_t) -> uint16_t {
     x.to_be()
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint32_t` from host endian representation to big endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn htobe32(x: uint32_t) -> uint32_t {
     x.to_be()
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint64_t` from host endian representation to big endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn htobe64(x: uint64_t) -> uint64_t {
     x.to_be()
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint16_t` from host endian representation to little endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn htole16(x: uint16_t) -> uint16_t {
     x.to_le()
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint32_t` from host endian representation to little endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn htole32(x: uint32_t) -> uint32_t {
     x.to_le()
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint64_t` from host endian representation to little endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn htole64(x: uint64_t) -> uint64_t {
     x.to_le()
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint16_t` from little endian representation to host endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn le16toh(x: uint16_t) -> uint16_t {
     uint16_t::from_le(x)
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint32_t` from little endian representation to host endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn le32toh(x: uint32_t) -> uint32_t {
     uint32_t::from_le(x)
 }
 
 /// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/be16toh.html>.
+///
+/// Convert a `uint64_t` from little endian representation to host endian
+/// respresentation.
 #[unsafe(no_mangle)]
 pub extern "C" fn le64toh(x: uint64_t) -> uint64_t {
     uint64_t::from_le(x)