John Keeping <john@xxxxxxxxxxxxx> writes: >> +--[no-]merged [<commit>]:: > > We prefer to write --[no-]* as: > > --option:: > --no-option:: > > although this may be the first instance that we see this combination > with an argument. > > I also found the "[<commit>]" syntax confusing and had to go and figure > out what PARSE_OPT_LASTARG_DEFAULT does; I wonder if it's worth > appending something like the following to the help for this option: > > The `commit` may be omitted if this is the final argument. "may be omitted" must be followed by a description of what happens when omitted (i.e. "defaults to ..."). -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html