I was confused, because I read "a file under GIT_DIR/objects/pack" to mean 
"just the filename".  Some of the things that deal with packs take just the 
filename (e.g. --keep-pack for git repack).  I'll fix the under under and add 
$, but I do want to clarify that it's the full path.

> -----Original Message-----
> From: Martin Ågren <martin.ag...@gmail.com>
> Sent: Friday, August 30, 2019 12:03 AM
> To: David Turner <david.tur...@twosigma.com>
> Cc: Git Mailing List <git@vger.kernel.org>
> Subject: Re: [PATCH] clarify documentation for remote helpers
> 
> On Thu, 29 Aug 2019 at 23:06, David Turner <dtur...@twosigma.com> wrote:
> 
> > -Optionally may output a 'lock <file>' line indicating a file under
> > -GIT_DIR/objects/pack which is keeping a pack until refs can be
> > -suitably updated.
> > +Optionally may output a 'lock <file>' line indicating the full path
> > +of a file under under GIT_DIR/objects/pack which is keeping a pack
> > +until refs can be suitably updated.  The path must end with ".keep".
> 
> "under under".
> 
> Also -- and I realize this is nothing new in your patch -- "GIT_DIR"
> should be prefixed with a '$' and that whole path wrapped in backticks so it
> gets monospaced. In total, my suggestion would be
> 
> -+a file under under GIT_DIR/objects/pack which is keeping a pack until
> ++a file under `$GIT_DIR/objects/pack` which is keeping a pack until
> 
> Whether what you're saying is actually *true*, sorry, no idea. I just have 
> those
> nits above to offer.
> 
> Martin

Reply via email to