{"thread":{"id":"33485","subject":"[PATCH] git-cherry.txt: cross reference \"git log --cherry\"","startedAt":"2013-04-11T21:39:39Z","lastAt":"2013-12-22T06:58:02Z","messageCount":3,"participants":["Samuel Bronson","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"214013","messageId":"5167369f.ea15340a.5e12.0282@mx.google.com","threadId":"33485","inReplyTo":null,"subject":"[PATCH] git-cherry.txt: cross reference \"git log --cherry\"","fromName":"Samuel Bronson","fromEmail":"naesten@gmail.com","sentAt":"2013-04-11T21:39:39Z","receivedAt":"2013-04-11T21:39:39Z","isPatch":true,"sender":{"key":"naesten@gmail.com","avatar":"https://avatars.githubusercontent.com/u/13903?v=4"},"body":"I learned of \"git cherry\" some days ago, but only learned of --cherry\nand related options to \"git log\" today (more-or-less by chance).\n\nIf the git-cherry(1) manpage had mentioned --cherry, I would have\nlearned of these options sooner.\n\nSigned-off-by: Samuel Bronson <naesten@gmail.com>\n---\n Documentation/git-cherry.txt | 3 ++-\n 1 file changed, 2 insertions(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-cherry.txt b/Documentation/git-cherry.txt\nindex f6c19c7..076fe68 100644\n--- a/Documentation/git-cherry.txt\n+++ b/Documentation/git-cherry.txt\n@@ -62,7 +62,8 @@ OPTIONS\n \n SEE ALSO\n --------\n-linkgit:git-patch-id[1]\n+linkgit:git-patch-id[1],\n+the `--cherry` option to linkgit:git-log[1]\n \n GIT\n ---\n-- \n1.8.2.1\n"},{"id":"232253","messageId":"1387484450-935-1-git-send-email-naesten@gmail.com","threadId":"33485","inReplyTo":"5167369f.ea15340a.5e12.0282@mx.google.com","subject":"[PATCH] git-cherry.txt: cross reference \"git log --cherry\"","fromName":"Samuel Bronson","fromEmail":"naesten@gmail.com","sentAt":"2013-12-19T20:20:50Z","receivedAt":"2013-12-19T20:20:50Z","isPatch":true,"sender":{"key":"naesten@gmail.com","avatar":"https://avatars.githubusercontent.com/u/13903?v=4"},"body":"I learned of \"git cherry\" some days ago, but only learned of --cherry\nand related options to \"git log\" today[1] (more-or-less by chance).\n\nIf the git-cherry(1) manpage had mentioned --cherry, I would have\nlearned of these options sooner.\n\n[1]: Thu, 11 Apr 2013\n\nSigned-off-by: Samuel Bronson <naesten@gmail.com>\n---\n Documentation/git-cherry.txt | 3 ++-\n 1 file changed, 2 insertions(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-cherry.txt b/Documentation/git-cherry.txt\nindex 0ea921a..cff9ae5 100644\n--- a/Documentation/git-cherry.txt\n+++ b/Documentation/git-cherry.txt\n@@ -138,7 +138,8 @@ $ git cherry origin/master topic base\n \n SEE ALSO\n --------\n-linkgit:git-patch-id[1]\n+linkgit:git-patch-id[1],\n+the `--cherry` option to linkgit:git-log[1]\n \n GIT\n ---\n-- \n1.8.4.3\n"},{"id":"232342","messageId":"7vk3exjrt1.fsf@alter.siamese.dyndns.org","threadId":"33485","inReplyTo":"1387484450-935-1-git-send-email-naesten@gmail.com","subject":"Re: [PATCH] git-cherry.txt: cross reference \"git log --cherry\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-12-22T06:58:02Z","receivedAt":"2013-12-22T06:58:02Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Samuel Bronson <naesten@gmail.com> writes:\n\n> I learned of \"git cherry\" some days ago, but only learned of --cherry\n> and related options to \"git log\" today[1] (more-or-less by chance).\n>\n> If the git-cherry(1) manpage had mentioned --cherry, I would have\n> learned of these options sooner.\n\nThis proposed log message is of an unusual style.  It is curious\nthat somebody learn \"cherry\" first before \"log\".\n\n>  SEE ALSO\n>  --------\n> -linkgit:git-patch-id[1]\n> +linkgit:git-patch-id[1],\n> +the `--cherry` option to linkgit:git-log[1]\n\nThe description text talks about \"changeset (or \"diff\")\", \"compares\nthe changeset rather than the commit id\", \"diffs are compared\",\netc., which is a hint that a lone reference to \"patch-id\" would be a\npage to read about that comparison, which is a good motivation that\nmay entice the readers to follow that reference.\n\nI am not sure what value the readers of this man page would see to\nthis addition, though. Unlike the reference to patch-id, it is not\nso obvious what gives them motivation to follow this new reference\nto \"log --cherry\".  A new sentence in DESCRIPTION section to mention\nit (e.g. \"'log --cherry' gives similar information\") may be needed\nat the same time.\n"}]}