Skip to content

{evolve,topic}: improving synopsis strings of commands

Raphaël Gomès requested to merge topic/stable/command-synopsis into branch/stable

This is a quick pass over commands from the two extensions (except debug commands) to see if the first line of hg help cmd can be improved.

Everything should be self-explanatory. Even though this string is just for users only, it has some rules (or, rather, conventions). For example, metavariable for a revision is REV, for a file is FILE, etc. If an option can be provided multiple times (e.g. revision), it has an ellipsis after it: -r REV.... Optional parts (including whole options) are given in square brackets, e.g. [[-r] REV] means not only specifying a revision is optional, but it can be specified either with -r or without it.

Merge request reports

Loading