From: Junio C Hamano Date: Wed, 25 Mar 2009 07:26:42 GMT Subject: Re: [PATCH] Documentation: git-format-patch.txt rewordings and cleanups Message-ID: <7vhc1i83m5.fsf@gitster.siamese.dyndns.org> In-Reply-To: <780e0a6b0903242321q252c4b44k3909bd79003ded6b@mail.gmail.com> Stephen Boyd writes: > On Tue, Mar 24, 2009 at 4:55 PM, Junio C Hamano wrote: >> Stephen Boyd writes: >> >>> How about a sentence with no negation? >>> >>> "Note that the leading dot is required if you want a dot between the >>> patch name and the suffix." >> >> How about a sentence that does not sound requirement but freedom? >> >> "The leading character does not have to be a dot; for example, you >> can use --suffix=-patch to get 0001-description-of-my-change-patch". > > Looks even better. Do we still want to start off by saying "Note that the..." ? Perhaps; I wasn't paying much attention to the whole sentence, but was primarily interested about giving the description less negative connotation.