Browse Source

Fix over-simplified documentation for 'git log -z'

In commit 64485b4a, the documentation for 'git log -z' was
simplified too much. The -z option actually changes the behavior
of 'git log' in two ways: commits will be ended with a NUL
instead of a LF (correctly documented) and the --raw and
--numstat will have NUL as field terminators (omitted in
the documentation for 'git log').

Signed-off-by: Björn Gustavsson <bgustavsson@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Björn Gustavsson 15 years ago committed by Junio C Hamano
parent
commit
5c931c8da2
  1. 12
      Documentation/diff-options.txt

12
Documentation/diff-options.txt

@ -87,19 +87,21 @@ endif::git-format-patch[] @@ -87,19 +87,21 @@ endif::git-format-patch[]
ifndef::git-format-patch[]

-z::
ifdef::git-log[]
Separate the commits with NULs instead of with new newlines.
+
Also, when `--raw` or `--numstat` has been given, do not munge
pathnames and use NULs as output field terminators.
endif::git-log[]
ifndef::git-log[]
When `--raw` or `--numstat` has been given, do not munge
pathnames and use NULs as output field terminators.
endif::git-log[]
+
Without this option, each pathname output will have TAB, LF, double quotes,
and backslash characters replaced with `\t`, `\n`, `\"`, and `\\`,
respectively, and the pathname will be enclosed in double quotes if
any of those replacements occurred.
endif::git-log[]

ifdef::git-log[]
Separate the commits with NULs instead of with new newlines.
endif::git-log[]

--name-only::
Show only names of changed files.

Loading…
Cancel
Save