docs: explain the order of output in the batched mode of git-cat-file(1)
The batched mode of git-cat-file(1) reads multiple objects from stdin and prints their respective contents to stdout. The order in which those objects are printed is not documented and may not be immediately obvious to the user. Document it. Signed-off-by: ahmed akef <aemed.akef.1@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
ahmed akef committed
Aug 22, 2024 at 19:50 UTC
4881328617ee714cdef9d92d3ee25b3a4402ed4f
1 file changed
+3
-3
Documentation/git-cat-file.txt
+3
-3
@@ -270,9 +270,9 @@ BATCH OUTPUT
270
------------
271
272
If `--batch` or `--batch-check` is given, `cat-file` will read objects
273
-from stdin, one per line, and print information about them. By default,
274
-the whole line is considered as an object, as if it were fed to
275
-linkgit:git-rev-parse[1].
273
+from stdin, one per line, and print information about them in the same
274
+order as they have been read. By default, the whole line is
275
+considered as an object, as if it were fed to linkgit:git-rev-parse[1].
276
277
When `--batch-command` is given, `cat-file` will read commands from stdin,
278
one per line, and print information based on the command given. With