chore(doc): add top-level doc comments to published crates

cef/src/lib.rs

@@ -1,4 +1,4 @@
-//! # cef-rs
+//! # cef
 //!
 //! Use the [Chromium Embedded Framework](https://github.com/chromiumembedded/cef) in Rust.
 

download-cef/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "download-cef"
 description = "Download and extract pre-built CEF (Chromium Embedded Framework) archives."
-version = "1.2.0"
+version = "1.2.1"
 
 edition.workspace = true
 license.workspace = true

download-cef/src/lib.rs

@@ -1,3 +1,8 @@
+//! # download-cef
+//!
+//! Utility functions to download and extract prebuilt [Chromium Embedded Framework](https://github.com/chromiumembedded/cef)
+//! archives on any supported platform.
+
 use bzip2::bufread::BzDecoder;
 use serde::{Deserialize, Serialize};
 use sha1_smol::Sha1;

export-cef-dir/src/main.rs

@@ -1,3 +1,26 @@
+//! # export-cef-dir
+//!
+//! Export files from the prebuilt [Chromium Embedded Framework](https://github.com/chromiumembedded/cef)
+//! archive on any supported platform. The structure of the exported directory matches the way that
+//! the `cef-dll-sys` crate expects to see them.
+//!
+//! To use the target directory when building, set the `CEF_PATH` environment variable to the path of the
+//! exported directory, e.g., `~/.local/share/cef`.
+//!
+//! To use the DLLs in this directory at runtime, the library loader path varies by platform:
+//! - Linux
+//! ```sh
+//! export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$CEF_PATH"
+//! ```
+//! - macOS
+//! ```sh
+//! export DYLD_FALLBACK_LIBRARY_PATH="$DYLD_FALLBACK_LIBRARY_PATH:$CEF_PATH"
+//! ```
+//! - Windows (using PowerShell)
+//! ```pwsh
+//! $env:PATH = "$env:PATH;$env:CEF_PATH"
+//! ```
+
 use clap::Parser;
 use download_cef::{CefIndex, OsAndArch};
 use std::{

sys/src/lib.rs

@@ -1,3 +1,8 @@
+//! # cef-dll-sys
+//!
+//! Generated bindings for the prebuilt [Chromium Embedded Framework](https://github.com/chromiumembedded/cef)
+//! C API on any supported platform.
+
 #[allow(
     non_snake_case,
     non_camel_case_types,