Value terminator is not included anywhere in help message #4812
Labels
A-help
Area: documentation, including docs.rs, readme, examples, etc...
C-enhancement
Category: Raise on the bar on expectations
E-easy
Call for participation: Experience needed to fix: Easy / not much
Please complete the following tasks
Clap Version
v4.2.0
Describe your use case
The following rust program:
currently produces this output:
For a user, it is not clear that the options before
last
must be delimited with:
so the last argument is not assumed to be part ofmultiple_options
.Ideally, it should be included in both the usage itself and the Argument list in some way, mentioning it in the help message for each argument which may use this style would become tedious.
Describe the solution you'd like
I would expect the program to output something similar to this:
without any additional changes by default.
Alternatives, if applicable
An alternative to this is specifying the usage directly, but this falls flat as soon as
a
is turned into an option, as it's representation in the option list cannot be changed.It could also be explained in the help message of the argument itself, but I feel like the automatically generated usage strings should include this.
Additional Context
The following program already produces includes the
--
token for arguments specified asrequired(false)
andlast(true)
(although only in the usage), which is why I believe my feature request falls inline with the current design philosophy of clap.The text was updated successfully, but these errors were encountered: