From: "Junio C Hamano" <gitster@xxxxxxxxx>
Sent: Tuesday, August 28, 2012 12:22 AM
"Philip Oakley" <philipoakley@xxxxxxx> writes:
I searched for all occurrences of '[[' which would indicate a double
optional argument within the synopsis and only found git-read-tree.
Double-optional? That is not an issue.
For clarification, I was picking out the particular case that I saw in
the git checkout syntax of an option (which necessarily starts with a
first `[` ) which is actually then a multi-choice option, so has a
second '[' for that, and then has the required parameter after the
closing ']' of the multi-choice, then another ']' after the parameter -
hence my 'double optional argument' statement.
It was the multi-choice option, with parameter case that I was looking
for, as that multi-choice part would be easy to confuse with the normal
list of many options.
If an option always takes a parameter, we would have
git cmd [--option parameter]
instead of one of
git cmd [--option]
git cmd [--option] parameter
git cmd [--option] parameter...
and if we had
--option::
This option distims the parameter ...
that needs to be updated to
--option parameter::
This option distims the parameter ...
Agreed.
Philip
--
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