Skip to main content

regen_syntax/
regen_syntax.rs

1//! Regenerate `content/en/syntax.md` from the Syntax fragments.
2//!
3//! `content/en/syntax.md` is a committed, drift-tested mirror of
4//! `kaish_help::render_syntax_reference()`. After editing any Syntax fragment in
5//! `src/fragments.rs`, run:
6//!
7//! ```sh
8//! cargo run -p kaish-help --example regen_syntax
9//! ```
10//!
11//! The `syntax_md_matches_fragments` test fails until the file is regenerated.
12
13fn main() -> std::io::Result<()> {
14    let path = concat!(env!("CARGO_MANIFEST_DIR"), "/content/en/syntax.md");
15    std::fs::write(path, kaish_help::render_syntax_reference())?;
16    println!("regenerated {path}");
17    Ok(())
18}