From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 22 May 2024 01:35:38 GMT
Subject: Re: [PATCH] diff: document what --name-only shows
Message-ID: <xmqq7cfmiq6t.fsf@gitster.g>
In-Reply-To: <4c4049e9-f5fa-41c3-8a6a-df4fca2f07f1@gmail.com>

Nathan Faulkner <natedogith1@gmail.com> writes:

> This new description sounds to me like it only shows files that exist
> in the to-commit, not any files that were deleted.

True.  

The thing is "diff" works on pair of files from old side and new
side, so a removed path still conceptually exists on both sides as a
change from

    <old path name, old state (has certain contents)>

to

    <new path name, new state (no longer exists)>

It is the same story for a created path.

Having learned that, a proposal to rephrase the updated
documentation is very much welcomed.

Thanks.