Reorganize `git-log' man page to clarify common diff options.
authorEli Barzilay <eli@barzilay.org>
Thu, 8 Jul 2010 02:14:31 +0000 (22:14 -0400)
committerJunio C Hamano <gitster@pobox.com>
Fri, 9 Jul 2010 00:00:09 +0000 (17:00 -0700)
commit4ded69169b02f08eb3e097bdf068d3061c049e91
tree2345d1fd1668564967f4e64c45947a41f3f6df4d
parent9918285fb10d81af9021dae99c5f4de88ded497c
Reorganize `git-log' man page to clarify common diff options.

This will reduce considerably the common confusion where people miss the
`--follow' option, and wonder why `-M'/`-C' is not working.

* Move the diff options include to after the log-specific flags, and add
  a "Common diff options" subtitle before them.  (These options apply
  only when patches are shown, which is not a common use case among
  newbies, so having them first is confusing.)

* Move the `--follow' description to the top of the listed options.  The
  options before that seem less important: `--full-diff' applies only
  when patches are shown, `--source' and `--decorate' are less useful
  with many common commit specifications.

* Clarify that `--follow' works only for a single path argument.

Signed-off-by: Eli Barzilay <eli@barzilay.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-log.txt