Ævar Arnfjörð Bjarmason <avarab@xxxxxxxxx> writes: > Optional parts are enclosed in square brackets: > - [<extra>] > - (Zero or one <extra>.) > + [<file>...] > + (Zero or more of <file>.) OK. > + Use spacing around "|" token(s), but not immediately after opening or > + before closing a [] or () pair: > + Do: [-q | --quiet] > + Don't: [-q|--quiet] > + > + Don't use spacing around "|" tokens when they're used to seperate the > + alternate arguments of an option: > + Do: --track[=(direct|inherit)] > + Don't: --track[=(direct | inherit)] > + Hmph, that sounds inconsistent; I would have expected the same use (or omission) of space around the vertical bar. But if that is the prevailing style, I won't complain about writing it down. Thanks.
