Referring to arguments in documentation.

[rleonid]

Apologies if this is mentioned in the documentation, but what is the recommended way to consistently refer to arguments in documentation?

For example if I have a flag --do-it-this-way, I usually define a variable with value "do-it-this-way" and then sprintf it into the documentation (such as in an examples or doc of another argument). This is a bit tedious and I wonder if cmdliner supports a better pattern?

[dbuenzli]

In the doc of an option itself you can use $(opt) as mentioned here. Other than there's nothing else you can do. There was a plan for this but TBH I find that a bit overkill.

[rleonid]

I see, the plan looks good to me and would be useful to me. As has this library in general, so thank you!