Confusing tip texts for unexpected argunments, etc.

[ip1981]

I've seen some users that get confused by tip texts like this:

unexpected argument '-m' found

 tip: to pass '-m' as a value, use '-- -m'

The users then try to pass literally '-- -m' (with quotes) and get more confused with suggestion to use '-- -- -m' :)

I'm looking for ways to change tips to be more straight.

[epage]

What version of clap are you using? Does your command accept positional arguments?

The tip is trying to help users like those who run rg --some-arg but really want rg -- --some-arg (ie "search for --some-arg in my files). -- "escapes" any type of argument so it can be captured in its raw form as a positional value.

We try to limit this tip to just that situation but obviously something is going wrong if we are suggesting -- -- -m. I'd need more context to better say what can or should be done.

[ip1981]

I meant the quotes themselves are confusing users: instead of -- -m (two args) they type '-- -m' (single arg).

[epage]

We're quoting everything else also. It is helpful to other users to be able to tell when a literal stops and ends. I'm not sure what more we can do to improve this for those users.