summaryrefslogtreecommitdiff
path: root/Documentation/git-archive.txt
diff options
context:
space:
mode:
authorDmitry Potapov <dpotapov@gmail.com>2009-09-13 20:17:01 (GMT)
committerJunio C Hamano <gitster@pobox.com>2009-09-13 20:54:39 (GMT)
commit0f4b377c20fb7d93f8bfeec39efb2b9392d6aebc (patch)
tree89504504d202bdb988edf90aa9c0a7b80e3aa07e /Documentation/git-archive.txt
parent518ef8f07f72271dff4040c1e7452ab6de73d199 (diff)
downloadgit-0f4b377c20fb7d93f8bfeec39efb2b9392d6aebc.zip
git-0f4b377c20fb7d93f8bfeec39efb2b9392d6aebc.tar.gz
git-0f4b377c20fb7d93f8bfeec39efb2b9392d6aebc.tar.bz2
git-archive: infer output format from filename when unspecified
A command line $ git archive -o my-v2.0.zip v2.0 almost certainly wants the output in zip format, even though it does not specify any --format option. When --format is not given, but output filename is, try to infer what format is requested from the filename extension. Currently this code only knows about '.zip'. When the format is unspecified and the filename does not tell us, the output will be in 'tar' format as before. Of course, an explicit --format will not trigger this guesswork. Signed-off-by: Dmitry Potapov <dpotapov@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-archive.txt')
-rw-r--r--Documentation/git-archive.txt13
1 files changed, 11 insertions, 2 deletions
diff --git a/Documentation/git-archive.txt b/Documentation/git-archive.txt
index 1917f2e..3d1c1e7 100644
--- a/Documentation/git-archive.txt
+++ b/Documentation/git-archive.txt
@@ -34,8 +34,11 @@ OPTIONS
-------
--format=<fmt>::
- Format of the resulting archive: 'tar' or 'zip'. The default
- is 'tar'.
+ Format of the resulting archive: 'tar' or 'zip'. If this option
+ is not given, and the output file is specified, the format is
+ inferred from the filename if possible (e.g. writing to "foo.zip"
+ makes the output to be in the zip format). Otherwise the output
+ format is `tar`.
-l::
--list::
@@ -130,6 +133,12 @@ git archive --format=zip --prefix=git-docs/ HEAD:Documentation/ > git-1.4.0-docs
Put everything in the current head's Documentation/ directory
into 'git-1.4.0-docs.zip', with the prefix 'git-docs/'.
+git archive -o latest.zip HEAD::
+
+ Create a Zip archive that contains the contents of the latest
+ commit on the current branch. Note that the output format is
+ inferred by the extension of the output file.
+
SEE ALSO
--------