Samuel Bronson <naes...@gmail.com> 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. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
