On Tue, Feb 27, 2007 at 01:57:18PM +0100, Johannes Schindelin wrote: > git-show, of all, is _not_ plumbing. It is one of the foremost porcelain > programs core Git ships. Maybe, but its man page doesn't show it. The average end-user isn't going to be thinking about blobs, tree objects, and tag objects. Furthermore, the EXAMPLES section in the man page is misformatted due to some ASCII doc issues. I'll send a patch to correct the EXAMPLES section, but if git-show is a foremost porecelain program the DISCRIPTION section probably needs to be rewritten as well. > git show v.37:e2fsck/pass1.c Thanks, I just didn't know about tree-ish:pathname syntax, and I've been playing with git for a while. As a suggestion, maybe we should be moving (or at least copying) things like the <object> identifier syntax from the git-rev-parse manpage (which is plumbing, right?) to the top-level git manpage? I don't think it's a good idea to force users to read man pages for plumbing commands in order to learn key git command-line concepts. - Ted - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html