Sync with upstream

rust/nix-c-raw/src/lib.rs

@@ -1,5 +1,22 @@
+//! Raw bindings to Nix C API
+//!
+//! This crate contains automatically generated bindings from the Nix C headers.
+//! The bindings are generated by bindgen and include C-style naming conventions
+//! and documentation comments that don't always conform to Rust standards.
+//!
+//! Normally you don't have to use this crate directly.
+//! Instead use `nix-store` and `nix-expr`.
+
+// Standard bindgen suppressions for C naming conventions
 #![allow(non_upper_case_globals)]
 #![allow(non_camel_case_types)]
 #![allow(non_snake_case)]
+// Rustdoc suppressions for generated C documentation
+// The C headers contain Doxygen-style documentation that doesn't translate
+// well to Rust's rustdoc format, causing various warnings:
+#![allow(rustdoc::broken_intra_doc_links)] // @param[in]/[out] references don't resolve
+#![allow(rustdoc::bare_urls)] // C docs may contain unescaped URLs
+#![allow(rustdoc::invalid_html_tags)] // Doxygen HTML tags like <setting>
+#![allow(rustdoc::invalid_codeblock_attributes)] // C code examples may use unsupported attributes
 
 include!(concat!(env!("OUT_DIR"), "/bindings.rs"));