docs: fix three stale CLI flags in the how-to examples (--line-number, --tokens, --exclude-from-tree)

[cnYui]

Problem

Three flags used in the "how to" examples no longer exist in the CLI, so every one of those commands fails outright — clap rejects unknown arguments:

Documented	Reality (crates/code2prompt/src/args.rs)
--line-number	pub line_numbers: bool → -l / --line-numbers
--tokens	removed; the token count is always printed, --token-format <raw,format> selects the rendering
--exclude-from-tree	removed; pruning is the default, --full-directory-tree is the opt-out

Reproduced against main (6f7a7ff), after cargo build -p code2prompt:

$ ./target/debug/code2prompt . --line-number
error: unexpected argument '--line-number' found
  tip: a similar argument exists: '--line-numbers'
exit=2

$ ./target/debug/code2prompt . --tokens
error: unexpected argument '--tokens' found
  tip: a similar argument exists: '--token-map'
exit=2

$ ./target/debug/code2prompt . --exclude-from-tree
error: unexpected argument '--exclude-from-tree' found
  tip: a similar argument exists: '--exclude'
exit=2

There is no clap alias or infer_long_args keeping the old spellings alive (grep -rnE 'clap\(.*alias|visible_alias|infer_long_args' crates/ → no output), and --exclude-from-tree appears nowhere in crates/ any more.

--help confirms the real names:

$ ./target/debug/code2prompt --help | grep -E 'line-numbers|full-directory-tree|token-format|encoding'
      --full-directory-tree
      --encoding <cl100k, p50k, p50k_edit, r50k>
      --token-format <raw,format>
  -l, --line-numbers

Change

Three independent commits, one per flag, so a smaller subset can be taken if preferred:

1. --line-number → --line-numbers (pure rename).

2. --tokens → --token-format=format; the tokenizer example only needs --encoding=p50k, so the dead flag is just dropped there. The count itself is printed unconditionally now (crates/code2prompt/src/main.rs, format_number(token_count, &session.config.token_format)).

3. --exclude-from-tree removed from the exclude example. The surrounding sentence ("Exclude files/folders from the source tree based on exclude patterns") stays accurate, because that pruning is now the default:

   // crates/code2prompt-core/src/path.rs
   let include_in_tree = config.full_directory_tree || entry_match;

   Only the English page gains one extra line pointing at --full-directory-tree as the opt-out — I deliberately did not machine-translate that sentence into the six localized copies, so their diff stays a pure token deletion.

14 files: README_ES.md, website/src/content/docs/docs/how_to/cli.mdx, and the de/es/fr/ja/ru/zh copies of cli.mdx and filter_files.md. README.md and the English filter_files.md are untouched (the former does not contain these flags, the latter does not exist).

Verification

Tree semantics, on a scratch dir containing keep.txt, drop.wav, sub/also.wav:

$ code2prompt DIR --exclude="*.wav" -q -O -
treedemo1
├── keep.txt
└── sub

$ code2prompt DIR --exclude="*.wav" --full-directory-tree -q -O -
treedemo1
├── drop.wav
├── keep.txt
└── sub
    └── also.wav

Every command as it now reads in the docs exits 0:

--exclude=*.npy,*.wav -> exit=0
--token-format=format -> exit=0
--encoding=p50k       -> exit=0
--line-numbers        -> exit=0

Post-change greps are empty:

$ grep -rn --exclude-dir=.git -- '--exclude-from-tree' .   # 0
$ grep -rnE --exclude-dir=.git -- '--line-number([^s]|$)' .  # 0
$ grep -rn --exclude-dir=.git -- '--tokens' .              # 0

The docs site still builds, and the rendered page picks up the new note:

$ cd website && pnpm install --frozen-lockfile && pnpm build
[build] 174 page(s) built in 17.27s
[build] Complete!
$ grep -c 'full-directory-tree' dist/docs/how_to/cli/index.html   # 1
$ grep -rn --binary-files=text -- '--exclude-from-tree' dist/     # 0

Limitations

• Docs only — no Rust source is touched, so cargo test behaviour is unchanged; I did not run the full test suite.
• The localized pages keep their existing prose; only the dead flag tokens changed there.
• Precedent for this class of fix: Fix argument typo in quickstart: --output-file #309 (--output-file typo in the quickstart) and Fix the broken star history chart in the README #333.

🤖 Generated with Claude Code