From ef3b291a5f19d7e3b7f4cc4524003e50d40614f7 Mon Sep 17 00:00:00 2001 From: Jeff King Date: Sat, 4 Mar 2023 05:26:40 -0500 Subject: bundle: document handling of "-" as stdin We have always allowed "bundle create -" to write to stdout, but it was never documented. And a recent patch let reading operations like "bundle list-heads -" read from stdin. Let's document all of these cases. Signed-off-by: Jeff King Signed-off-by: Junio C Hamano --- Documentation/git-bundle.txt | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) (limited to 'Documentation/git-bundle.txt') diff --git a/Documentation/git-bundle.txt b/Documentation/git-bundle.txt index 18a022b4b4..d19f4cf2b3 100644 --- a/Documentation/git-bundle.txt +++ b/Documentation/git-bundle.txt @@ -66,7 +66,7 @@ create [options] :: Used to create a bundle named 'file'. This requires the '' arguments to define the bundle contents. 'options' contains the options specific to the 'git bundle create' - subcommand. + subcommand. If 'file' is `-`, the bundle is written to stdout. verify :: Used to check that a bundle file is valid and will apply @@ -77,12 +77,13 @@ verify :: Finally, information about additional capabilities, such as "object filter", is printed. See "Capabilities" in linkgit:gitformat-bundle[5] for more information. The exit code is zero for success, but will - be nonzero if the bundle file is invalid. + be nonzero if the bundle file is invalid. If 'file' is `-`, the + bundle is read from stdin. list-heads :: Lists the references defined in the bundle. If followed by a list of references, only references matching those given are - printed out. + printed out. If 'file' is `-`, the bundle is read from stdin. unbundle :: Passes the objects in the bundle to 'git index-pack' @@ -90,6 +91,7 @@ unbundle :: defined references. If a list of references is given, only references matching those in the list are printed. This command is really plumbing, intended to be called only by 'git fetch'. + If 'file' is `-`, the bundle is read from stdin. :: A list of arguments, acceptable to 'git rev-parse' and -- cgit v1.2.3