summaryrefslogtreecommitdiffstats
path: root/git-cat-file.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2023-06-23 13:26:29 -0700
committerJunio C Hamano <gitster@pobox.com>2023-06-23 13:26:29 -0700
commit9469c13db24e0edec73595887cf74f38efd89a55 (patch)
tree269e9e6ab7f3dc3a8481c537a8e49f018f6361c2 /git-cat-file.txt
parenta7b2c10835189668841231edffc77e7dbb020487 (diff)
downloadgit-htmldocs-9469c13db24e0edec73595887cf74f38efd89a55.tar.gz
Autogenerated HTML docs for v2.41.0-191-g6ff334
Diffstat (limited to 'git-cat-file.txt')
-rw-r--r--git-cat-file.txt15
1 files changed, 13 insertions, 2 deletions
diff --git a/git-cat-file.txt b/git-cat-file.txt
index 411de2e27..0e4936d18 100644
--- a/git-cat-file.txt
+++ b/git-cat-file.txt
@@ -14,7 +14,7 @@ SYNOPSIS
'git cat-file' (-t | -s) [--allow-unknown-type] <object>
'git cat-file' (--batch | --batch-check | --batch-command) [--batch-all-objects]
[--buffer] [--follow-symlinks] [--unordered]
- [--textconv | --filters] [-z]
+ [--textconv | --filters] [-Z]
'git cat-file' (--textconv | --filters)
[<rev>:<path|tree-ish> | --path=<path|tree-ish> <rev>]
@@ -243,10 +243,16 @@ respectively print:
/etc/passwd
--
+-Z::
+ Only meaningful with `--batch`, `--batch-check`, or
+ `--batch-command`; input and output is NUL-delimited instead of
+ newline-delimited.
+
-z::
Only meaningful with `--batch`, `--batch-check`, or
`--batch-command`; input is NUL-delimited instead of
- newline-delimited.
+ newline-delimited. This option is deprecated in favor of
+ `-Z` as the output can otherwise be ambiguous.
OUTPUT
@@ -384,6 +390,11 @@ notdir SP <size> LF
is printed when, during symlink resolution, a file is used as a
directory name.
+Alternatively, when `-Z` is passed, the line feeds in any of the above examples
+are replaced with NUL terminators. This ensures that output will be parsable if
+the output itself would contain a linefeed and is thus recommended for
+scripting purposes.
+
CAVEATS
-------