Re: [PATCH v2 3/6] transport-helper: clarify pushing without refspecs
- From
John Keeping <john@keeping.me.uk>
- Date
- Apr 18, 2013, 10:24 UTC
- Message-ID
- <20130418102428.GX2278@serenity.lan>
- In-Reply-To
- <CAMP44s33WLE6xJ_bFJBX2z0hdkALqCKpq7Ve+8hZw2URWUPz_w@mail.gmail.com>
On Thu, Apr 18, 2013 at 05:14:18AM -0500, Felipe Contreras wrote:
Show 30 quoted lines
> On Thu, Apr 18, 2013 at 5:11 AM, John Keeping <john@keeping.me.uk> wrote: > > On Wed, Apr 17, 2013 at 11:14:30PM -0500, Felipe Contreras wrote: > >> This has never worked, since it's inception the code simply skips all > >> the refs, essentially telling fast-export to do nothing. > >> > >> Let's at least tell the user what's going on. > >> > >> Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com> > >> --- > >> Documentation/gitremote-helpers.txt | 4 ++-- > >> t/t5801-remote-helpers.sh | 6 +++--- > >> transport-helper.c | 5 +++-- > >> 3 files changed, 8 insertions(+), 7 deletions(-) > >> > >> diff --git a/Documentation/gitremote-helpers.txt b/Documentation/gitremote-helpers.txt > >> index ba7240c..4d26e37 100644 > >> --- a/Documentation/gitremote-helpers.txt > >> +++ b/Documentation/gitremote-helpers.txt > >> @@ -162,8 +162,8 @@ Miscellaneous capabilities > >> For remote helpers that implement 'import' or 'export', this capability > >> allows the refs to be constrained to a private namespace, instead of > >> writing to refs/heads or refs/remotes directly. > >> - It is recommended that all importers providing the 'import' or 'export' > >> - capabilities use this. > >> + It is recommended that all importers providing the 'import' > >> + capability use this. It's mandatory for 'export'. > > > > s/It's/It is/ > > What's the difference?
"It's" is considered informal, while we do adopt that tone on the mailing list and sometimes in the documentation, in general I think we should avoid contractions in the formal documentation.
In this case it is particularly jarring because it immediately follows a sentence where we use the full "It is" form.