CLI help shows inconsistent argument naming between source and input_sources.

[yasqdb]

Bug

The "docling --help" command output :
Top section shows: Usage: "docling [OPTIONS] source"
Arguments section shows: "* input_sources source"

Steps to reproduce

Running "docling --help" command in terminal .

Docling version

Docling version: 2.90.0
Docling Core version: 2.74.0
Docling IBM Models version: 3.13.0
Docling Parse version: 5.9.0
Python: cpython-313 (3.13.13)
Platform: Windows-11-10.0.26200-SP0

Python version

Python 3.13.13

[dosubot]

Hi @yasqdb! I'm Dosu and I’m helping the docling team.

This is a known quirk of how the CLI is defined using the Typer framework. The positional argument's Python parameter is named input_sources, but the metavar is set to "source":

input_sources: Annotated[
    list[str],
    typer.Argument(
        ...,
        metavar="source",
        help="PDF files to convert. Can be local file / directory paths or URL.",
    ),
],

In Typer, the metavar controls what's shown in the "Usage:" line (hence source), while the Arguments section shows both the internal parameter name (input_sources) and the metavar. This is standard Typer behavior — the "inconsistency" in the help output is just how Typer renders arguments that have a metavar different from the parameter name.

That said, aligning them (e.g., changing the parameter name to source or the metavar to input_sources) would make the help output less confusing. This could be a small improvement worth a PR if maintainers agree.

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.