Prep for first publish: fix docs.rs build and crates.io metadata

- build.rs: stop short-circuiting on CARGO_DOC/DOCS_RS. src/bindings.rs
  include!s $OUT_DIR/bindings.rs, so skipping bindgen during doc builds
  made `cargo doc` (and docs.rs) fail to compile. The build is hermetic
  (libclang + vendored headers, both available on docs.rs), so always
  generate the bindings.
- src/bindings.rs: allow(rustdoc::all) to silence ~144 rustdoc warnings
  from the generated C-header doc comments (bare URLs, etc.).
- Cargo.toml: add readme, keywords, categories for crates.io, and
  exclude dev-only tooling (flake.*, justfile, deny.toml, toolchain) from
  the published tarball.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: kixelated

Cargo.toml

@@ -5,9 +5,15 @@ description = "VA-API H.264 hardware encoder, vendored and trimmed from cros-lib
 authors = ["The ChromiumOS Authors", "Discord", "Luke Curley <kixelated@gmail.com>"]
 repository = "https://github.com/moq-dev/vaapi"
 license = "BSD-3-Clause"
+readme = "README.md"
+keywords = ["vaapi", "h264", "encoder", "video", "hardware"]
+categories = ["multimedia::encoding", "hardware-support", "external-ffi-bindings"]
 edition = "2021"
 rust-version = "1.85"
 
+# Dev-only tooling; not needed to build the crate from the published tarball.
+exclude = ["flake.nix", "flake.lock", "justfile", "deny.toml", "rust-toolchain.toml", ".rustfmt.toml"]
+
 # The build is hermetic: bindgen reads the vendored libva headers checked into
 # `libva/` (refreshed by `just vendor`, pinned to a known VA-API version so a
 # system libva bump can't drift the bindings), and libva is dlopen'd at runtime

build.rs

@@ -60,11 +60,10 @@ fn generate_vendored_version_header(out_dir: &Path) -> (u32, u32) {
 }
 
 fn main() {
-	// Do not require dependencies when generating docs.
-	if std::env::var("CARGO_DOC").is_ok() || std::env::var("DOCS_RS").is_ok() {
-		return;
-	}
-
+	// NOTE: do not short-circuit for docs builds (CARGO_DOC / DOCS_RS). `src/bindings.rs`
+	// `include!`s the generated `$OUT_DIR/bindings.rs`, so skipping bindgen makes
+	// `cargo doc` (and docs.rs) fail to compile. The build is hermetic — it only needs
+	// libclang and the vendored headers, both available on docs.rs — so always generate.
 	let out_dir = PathBuf::from(env::var("OUT_DIR").expect("`OUT_DIR` is not set"));
 
 	// Always build against the vendored libva headers (checked into `libva/`,

src/bindings.rs

@@ -11,5 +11,8 @@
 #![allow(non_snake_case)]
 #![allow(non_camel_case_types)]
 #![allow(dead_code)]
+// The bindings are generated from vendored C headers; their doc comments carry
+// bare URLs and other rustdoc-unfriendly markup. Don't lint generated docs.
+#![allow(rustdoc::all)]
 
 include!(concat!(env!("OUT_DIR"), "/bindings.rs"));