Re: [PATCH] show doc: redirect user to git log manual instead of git diff-tree

From: Han Young <hanyang.tony@bytedance.com>
Date: Sep 6, 2023, 06:09 UTC
Message-ID: <CAG1j3zFYbeXokd9kwN06RG7Wih_WsLVBf6jSi-JKtUpa=i4QJg@mail.gmail.com>
In-Reply-To: <xmqq7cp4p5gd.fsf@gitster.g>

> Strictly speaking, "options to control how the changes are shown"
> are options that are meant for "diff" command (e.g. "--stat", "-w"),
> but "log" understands some of the "diff" command options, the
> updated text is *not* incorrect.

On a closer look, the manual page of git show does lists all the "diff" options by including diff-options.txt. The options omitted are revision parsing related. Perhaps we remove the line

> The command takes options applicable to the git diff-tree command to
> control how the changes the commit introduces are shown.

And rephrase the line

> This manual page describes only the most frequently used options.

to

>  This manual page describes only the most frequently used options.
> Some options that `git rev-list` command understands can be used to
> control how commits are shown.