author | Eli Barzilay <eli@barzilay.org> | |
Thu, 8 Jul 2010 02:14:31 +0000 (22:14 -0400) | ||
committer | Junio C Hamano <gitster@pobox.com> | |
Fri, 9 Jul 2010 00:00:09 +0000 (17:00 -0700) | ||
commit | 4ded69169b02f08eb3e097bdf068d3061c049e91 | |
tree | 2345d1fd1668564967f4e64c45947a41f3f6df4d | tree | snapshot |
parent | 9918285fb10d81af9021dae99c5f4de88ded497c | commit | diff |
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>
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 | diff | blob | history |