X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-archive.txt;h=d3eaa16af122b8f048d09ba6f7ba5a1932f59e80;hb=31a3c6bb45aa61e45f1663871620eaf742f0abbb;hp=721e0351c3b7b50cfeadaa64af4a9e8cd5be27d5;hpb=d1c7c27ea3d9c92be2c7a9c5fc72ba5f228c424a;p=git.git diff --git a/Documentation/git-archive.txt b/Documentation/git-archive.txt index 721e0351c..d3eaa16af 100644 --- a/Documentation/git-archive.txt +++ b/Documentation/git-archive.txt @@ -3,19 +3,21 @@ git-archive(1) NAME ---- -git-archive - Creates an archive of files from a named tree +git-archive - Create an archive of files from a named tree SYNOPSIS -------- [verse] 'git-archive' --format= [--list] [--prefix=/] [] - [--remote=] [path...] + [--remote= [--exec=]] + [path...] DESCRIPTION ----------- Creates an archive of the specified format containing the tree -structure for the named tree. If is specified it is +structure for the named tree, and writes it out to the standard +output. If is specified it is prepended to the filenames in the archive. 'git-archive' behaves differently when given a tree ID versus when @@ -31,7 +33,7 @@ OPTIONS ------- --format=:: - Format of the resulting archive: 'tar', 'zip'... The default + Format of the resulting archive: 'tar' or 'zip'. The default is 'tar'. --list, -l:: @@ -51,6 +53,10 @@ OPTIONS Instead of making a tar archive from local repository, retrieve a tar archive from a remote repository. +--exec=:: + Used with --remote to specify the path to the + git-upload-archive executable on the remote side. + :: The tree or commit to produce an archive for. @@ -72,16 +78,13 @@ zip CONFIGURATION ------------- -By default, file and directories modes are set to 0666 or 0777 in tar -archives. It is possible to change this by setting the "umask" variable -in the repository configuration as follows : - -[tar] - umask = 002 ;# group friendly -The special umask value "user" indicates that the user's current umask -will be used instead. The default value remains 0, which means world -readable/writable files and directories. +tar.umask:: + This variable can be used to restrict the permission bits of + tar archive entries. The default is 0002, which turns off the + world write bit. The special value "user" indicates that the + archiving user's umask will be used instead. See umask(2) for + details. EXAMPLES -------- @@ -115,4 +118,4 @@ Documentation by David Greaves, Junio C Hamano and the git-list