On 11-01-21 00:34, Jeff King wrote: > On Fri, Jan 21, 2011 at 12:16:49AM +0100, Nicolas Sebrecht wrote: > 4. Do (3), but also list the all (or common) diff options in a succint > list without descriptions, and refer the user to git-diff(1). Then > they can grep if they like, and while they won't get the immediate > answer, they will get referred to the right place. > > As you can probably guess, I favor option (4), though we already do (3) > in some places. I also favor (4), for the following reasons: - sometimes you want to read the whole manpage, e.g., it's good for beginners to get feeling what is it all about. - repeated information makes the page too long and reading too boring. - too long manpages may scare beginners. Maybe there could be sort-of extended manpage, containing everything, but it would need some markup beyond the capabilities of a terminal (a grayed or collapsed area in html, or whatever). However, this could be a lot of additional work, and I don't claim it should be done, just an idea. -- 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