From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 08 Oct 2010 19:43:51 GMT
Subject: Re: [PATCH 0/6] Unify argument and option notation in the docs
Message-ID: <7v1v80wjuw.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1286559080-27257-1-git-send-email-stepnem@gmail.com>

I had to fix up the whitespace damage in the rerolled 2/6 but otherwise
looked good.

Thanks, both.  It might make sense to outline the rules applied somewhere in
CodingGuidelines to help people who add to our documents.  Something along
the lines of...

 - A placeholder is spelled inside angle brackets, e.g. <file>, <object>.

 - Choosing one from many is written with possible choices separated with
   a vertical bar and the whole thing enclosed in parentheses, e.g.
   answer=(yes|no|true|false)

 - Repetition of zero or more times of X is spelled as [(X)...], e.g.
   [(-p <parent>)...]