From: Joey Hess <id@joeyh.name>
Date: Fri, 17 Jun 2016 02:48:03 GMT
Subject: Re: [PATCH 1/4] clarify %f documentation
Message-ID: <20160617024803.GB17088@kitenet.net>
In-Reply-To: <xmqq8ty44y4t.fsf@gitster.mtv.corp.google.com>

Junio C Hamano wrote:
> I agree that "the name of the file" can be interpreted in many ways,
> and I agree that it would be a good idea to find a better phrase to
> name the path that is being worked on, but I do not think "the file
> in the git repository" is that phrase.

> I think using the word "path" somewhere in the updated description
> is more likely to have the effect you desire.

"path" is also very ambiguous. I see that "tracked" is often used to
describe what %f is, so how about:
 
+ Note that "%f" is the name of a file tracked by Git. Depending on the
+ version that is being filtered, the corresponding file on disk may not
+ exist, or may have different contents. So, smudge and clean commands should
+ not try to access the file on disk.

-- 
see shy jo