# [PATCH] git-cherry.txt: cross reference "git log --cherry" 3 messages from 2013-04-11 to 2013-12-22. Participants: Samuel Bronson, Junio C Hamano. Thread: https://gitlist.dev/t/33485 ## Samuel Bronson, 2013-04-11 21:39 Subject: [PATCH] git-cherry.txt: cross reference "git log --cherry" Message-ID: <5167369f.ea15340a.5e12.0282@mx.google.com> URL: https://gitlist.dev/e/5167369f.ea15340a.5e12.0282%40mx.google.com ``` I learned of "git cherry" some days ago, but only learned of --cherry and related options to "git log" today (more-or-less by chance). If the git-cherry(1) manpage had mentioned --cherry, I would have learned of these options sooner. Signed-off-by: Samuel Bronson --- Documentation/git-cherry.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/git-cherry.txt b/Documentation/git-cherry.txt index f6c19c7..076fe68 100644 --- a/Documentation/git-cherry.txt +++ b/Documentation/git-cherry.txt @@ -62,7 +62,8 @@ OPTIONS SEE ALSO -------- -linkgit:git-patch-id[1] +linkgit:git-patch-id[1], +the `--cherry` option to linkgit:git-log[1] GIT --- -- 1.8.2.1 ``` ## Samuel Bronson, 2013-12-19 20:20 Subject: [PATCH] git-cherry.txt: cross reference "git log --cherry" Message-ID: <1387484450-935-1-git-send-email-naesten@gmail.com> URL: https://gitlist.dev/e/1387484450-935-1-git-send-email-naesten%40gmail.com In-Reply-To: <5167369f.ea15340a.5e12.0282@mx.google.com> ``` I learned of "git cherry" some days ago, but only learned of --cherry and related options to "git log" today[1] (more-or-less by chance). If the git-cherry(1) manpage had mentioned --cherry, I would have learned of these options sooner. [1]: Thu, 11 Apr 2013 Signed-off-by: Samuel Bronson --- Documentation/git-cherry.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/git-cherry.txt b/Documentation/git-cherry.txt index 0ea921a..cff9ae5 100644 --- a/Documentation/git-cherry.txt +++ b/Documentation/git-cherry.txt @@ -138,7 +138,8 @@ $ git cherry origin/master topic base SEE ALSO -------- -linkgit:git-patch-id[1] +linkgit:git-patch-id[1], +the `--cherry` option to linkgit:git-log[1] GIT --- -- 1.8.4.3 ``` ## Junio C Hamano, 2013-12-22 06:58 Subject: Re: [PATCH] git-cherry.txt: cross reference "git log --cherry" Message-ID: <7vk3exjrt1.fsf@alter.siamese.dyndns.org> URL: https://gitlist.dev/e/7vk3exjrt1.fsf%40alter.siamese.dyndns.org In-Reply-To: <1387484450-935-1-git-send-email-naesten@gmail.com> ``` Samuel Bronson writes: > I learned of "git cherry" some days ago, but only learned of --cherry > and related options to "git log" today[1] (more-or-less by chance). > > If the git-cherry(1) manpage had mentioned --cherry, I would have > learned of these options sooner. This proposed log message is of an unusual style. It is curious that somebody learn "cherry" first before "log". > SEE ALSO > -------- > -linkgit:git-patch-id[1] > +linkgit:git-patch-id[1], > +the `--cherry` option to linkgit:git-log[1] The description text talks about "changeset (or "diff")", "compares the changeset rather than the commit id", "diffs are compared", etc., which is a hint that a lone reference to "patch-id" would be a page to read about that comparison, which is a good motivation that may entice the readers to follow that reference. I am not sure what value the readers of this man page would see to this addition, though. Unlike the reference to patch-id, it is not so obvious what gives them motivation to follow this new reference to "log --cherry". A new sentence in DESCRIPTION section to mention it (e.g. "'log --cherry' gives similar information") may be needed at the same time. ```