X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-archive.txt;h=d3eaa16af122b8f048d09ba6f7ba5a1932f59e80;hb=31a3c6bb45aa61e45f1663871620eaf742f0abbb;hp=4da07c158053bd037f32ff74516c7b2dfeec723b;hpb=75d8ff138dd640a117c6aaa625d0f6b835adbd3a;p=git.git diff --git a/Documentation/git-archive.txt b/Documentation/git-archive.txt index 4da07c158..d3eaa16af 100644 --- a/Documentation/git-archive.txt +++ b/Documentation/git-archive.txt @@ -10,12 +10,14 @@ 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