Autogenerated manpages for v1.5.3-rc7-16-ge340d
authorJunio C Hamano <junio@hera.kernel.org>
Fri, 31 Aug 2007 07:56:40 +0000 (07:56 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Fri, 31 Aug 2007 07:56:40 +0000 (07:56 +0000)
man1/git-daemon.1
man1/git-filter-branch.1

index a1282c05914972f2645483ae945c24a148c7c591..6c52bf294eb8ca32cd98dbb8a1101c27731684b4 100644 (file)
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-DAEMON" "1" "08/01/2007" "Git 1.5.3.rc3.107.g73a7" "Git Manual"
+.TH "GIT\-DAEMON" "1" "08/31/2007" "Git 1.5.3.rc7.16.ge340d" "Git Manual"
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -80,7 +80,7 @@ Use SO_REUSEADDR when binding the listening socket. This allows the server to re
 Detach from the shell. Implies \-\-syslog.
 .TP
 \-\-pid\-file=file
-Save the process id in \fIfile\fR.
+Save the process id in \fIfile\fR. Ignored when the daemon is run under \-\-inetd.
 .TP
 \-\-user=user, \-\-group=group
 Change daemon's uid and gid before entering the service loop. When only \-\-user is given without \-\-group, the primary group ID for the user is used. The values of the option are given to getpwnam(3) and getgrnam(3) and numeric IDs are not supported.
@@ -96,12 +96,16 @@ Allow/forbid overriding the site\-wide default with per repository configuration
 <directory>
 A directory to add to the whitelist of allowed directories. Unless \-\-strict\-paths is specified this will also include subdirectories of each named directory.
 .SH "SERVICES"
+These services can be globally enabled/disabled using the command line options of this command. If a finer\-grained control is desired (e.g. to allow git\-archive to be run against only in a few selected repositories the daemon serves), the per\-repository configuration file can be used to enable or disable them.
 .TP
 upload\-pack
 This serves git\-fetch\-pack and git\-peek\-remote clients. It is enabled by default, but a repository can disable it by setting daemon.uploadpack configuration item to false.
 .TP
 upload\-archive
-This serves git\-archive \-\-remote.
+This serves git\-archive \-\-remote. It is disabled by default, but a repository can enable it by setting daemon.uploadarchive configuration item to true.
+.TP
+receive\-pack
+This serves git\-send\-pack clients, allowing anonymous push. It is disabled by default, as there is _no_ authentication in the protocol (in other words, anybody can push anything into the repository, including removal of refs). This is solely meant for a closed LAN setting where everybody is friendly. This service can be enabled by daemon.receivepack configuration item to true.
 .SH "EXAMPLES"
 .TP
 We assume the following in /etc/services
@@ -155,6 +159,19 @@ To set up git\-daemon as a regular, non\-inetd service that handles repositories
 
 .fi
 In this example, the root\-level directory /pub will contain a subdirectory for each virtual host IP address supported. Repositories can still be accessed by hostname though, assuming they correspond to these IP addresses.
+
+To enable git\-archive \-\-remote and disable git\-fetch against a repository, have the following in the configuration file in the repository (that is the file \fIconfig\fR next to \fIHEAD\fR, \fIrefs\fR and \fIobjects\fR).
+
++
+.sp
+.nf
+.ft C
+[daemon]
+        uploadpack = false
+        uploadarchive = true
+.ft
+
+.fi
 .SH "AUTHOR"
 Written by Linus Torvalds <torvalds@osdl.org>, YOSHIFUJI Hideaki <yoshfuji@linux\-ipv6.org> and the git\-list <git@vger.kernel.org>
 .SH "DOCUMENTATION"
index d854e463f5d3c9ff1aa47d68830271f7196bc9c8..54d65a3553f0b9cbbadd9839078655b011001b59 100644 (file)
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-FILTER\-BRANCH" "1" "08/18/2007" "Git 1.5.3.rc5.19.g0734d" "Git Manual"
+.TH "GIT\-FILTER\-BRANCH" "1" "08/31/2007" "Git 1.5.3.rc7.16.ge340d" "Git Manual"
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -16,7 +16,8 @@ git\-filter\-branch \- Rewrite branches
         [\-\-index\-filter <command>] [\-\-parent\-filter <command>]
         [\-\-msg\-filter <command>] [\-\-commit\-filter <command>]
         [\-\-tag\-name\-filter <command>] [\-\-subdirectory\-filter <directory>]
-        [\-d <directory>] [\-f | \-\-force] [<rev\-list options>\&...]
+        [\-\-original <namespace>] [\-d <directory>] [\-f | \-\-force]
+        [<rev\-list options>\&...]
 .fi
 .SH "DESCRIPTION"
 Lets you rewrite git revision history by creating a new branch from your current branch, applying custom filters on each revision. Those filters can modify each tree (e.g. removing a file or running a perl rewrite on all files) or information about each commit. Otherwise, all information (including original commit times or merge information) will be preserved.
@@ -64,6 +65,9 @@ Note that there is currently no support for proper rewriting of tag objects; in
 \-\-subdirectory\-filter <directory>
 Only look at the history which touches the given subdirectory. The result will contain that directory (and only that) as its project root.
 .TP
+\-\-original <namespace>
+Use this option to set the namespace where the original commits will be stored. The default value is \fIrefs/original\fR.
+.TP
 \-d <directory>
 Use this option to set the path to the temporary directory used for rewriting. When applying a tree filter, the command needs to temporary checkout the tree to some directory, which may consume considerable space in case of large projects. By default it does this in the \fI.git\-rewrite/\fR directory but you can override that choice by this parameter.
 .TP