Skip to content

docs: correct --gpu-split-auto CLI flag in server options - #439

Open
latent-9 wants to merge 1 commit into
theroyallab:mainfrom
latent-9:docs/fix-gpu-split-auto-flag
Open

docs: correct --gpu-split-auto CLI flag in server options#439
latent-9 wants to merge 1 commit into
theroyallab:mainfrom
latent-9:docs/fix-gpu-split-auto-flag

Conversation

@latent-9

Copy link
Copy Markdown

Is your pull request related to a problem? Please describe.
docs/02.-Server-options.md (line 9) documents the boolean-override example with the flag --gpu_split-auto:

Example: A user sets gpu_split_auto to True. The CLI arg will then be --gpu_split-auto False to override that previous config.yml setting.

That flag string does not exist. common/args.py builds every CLI flag from the config field name by replacing underscores with hyphens:

sub_field_name = sub_field_name.replace("_", "-")   # common/args.py

So the gpu_split_auto field is exposed as --gpu-split-auto, not --gpu_split-auto. A user copy-pasting the documented example hits:

error: unrecognized arguments: --gpu_split-auto False

Why should this feature be added?
This is a one-word docs fix. The example is meant to teach the boolean-override behavior, but as written it fails verbatim, which is confusing precisely for the users who follow the docs. The config key gpu_split_auto (used in config.yml) is correct and unchanged — only the CLI arg string is fixed.

Examples

  • Before (documented): --gpu_split-auto Falseunrecognized arguments
  • After (fixed): --gpu-split-auto False → parses correctly

Additional context
Docs-only, single line, no code change.

The server-options example writes the override flag as `--gpu_split-auto`,
but tabbyAPI builds CLI flags by replacing underscores with hyphens
(common/args.py: `sub_field_name.replace("_", "-")`), so the actual flag
for the `gpu_split_auto` config field is `--gpu-split-auto`. Copy-pasting
`--gpu_split-auto False` fails with `unrecognized arguments`. The config
key name itself is unchanged.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant