On Tue, Nov 7, 2023 at 5:26 PM Junio C Hamano <gitster@xxxxxxxxx> wrote: > > Elijah Newren <newren@xxxxxxxxx> writes: > > > I find that marginally better; but I still don't think it answers the > > user's question of why they should pick one option or the other. The > > wording for the `--find-copies-harder` does explain when it's useful: > > > > For performance reasons, by default, `-C` option finds copies only > > if the original file of the copy was modified in the same > > changeset. This flag makes the command > > inspect unmodified files as candidates for the source of > > copy. This is a very expensive operation for large > > projects, so use it with caution. > > > > We probably don't want to copy all three of those sentences here, but > > I think we need to make sure users can find them, thus my suggestion > > to reference the `--find-copies-harder` option to git-diff so that > > affected users can get the info they need to choose. > > "in addition to paths that are different, will look for more copies > even in unmodified paths" then? That's much better. I still slightly prefer referencing `--find-copies-harder` so that there's a link between "copies-harder" and `--find-copies-harder`; but this version would also be fine.