threads / patch / 1695

patchDocumentation for git-daemon.

Subject: [PATCH] Documentation for git-daemon.

## tl;dr

3 messages between Aug 30, 2005 and Aug 30, 2005. Diffs are folded; open one to read it.

replies: 2people: 2as markdown or json

A Large Angry SCM· Aug 30, 2005, 02:31 UTC · lore

Copy & paste source comments into documentation.

Signed-off-by:  <gitzilla@gmail.com>

---

 Documentation/git-daemon.txt |   26 +++++++++++++++++---------
 1 files changed, 17 insertions(+), 9 deletions(-)

ea71ec7bde99f05a3766f5e1ad4ecc7bcb89ab13

Show changes to Documentation/git-daemon.txt +17 −8

diff --git a/Documentation/git-daemon.txt b/Documentation/git-daemon.txt
--- a/Documentation/git-daemon.txt
+++ b/Documentation/git-daemon.txt
@@ -3,26 +3,34 @@ git-daemon(1)
 
 NAME
 ----
-git-daemon - Some git command not yet documented.
-
+git-daemon - A really simple server for GIT repositories.
 
 SYNOPSIS
 --------
-'git-daemon' [ --option ] <args>...
+'git-daemon' [--inetd | --port=n]
 
 DESCRIPTION
 -----------
-Does something not yet documented.
+A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT"
+aka 9418. It waits for a connection, and will just execute "git-upload-pack"
+when it gets one.
+
+It's careful in that there's a magic request-line that gives the command and
+what directory to upload, and it verifies that the directory is ok.
+
+It verifies that the directory has the magic file "git-daemon-export-ok", and
+it will refuse to export any git directory that hasn't explicitly been marked
+for export this way.
 
+This is ideally suited for read-only updates, ie pulling from git repositories.
 
 OPTIONS
 -------
---option::
-	Some option not yet documented.
-
-<args>...::
-	Some argument not yet documented.
+--inetd::
+	Have the server run as an inetd service.
 
+--port::
+	Listen on an alternative port.
 
 Author
 ------

Linus Torvalds· Aug 30, 2005, 02:53 UTC · re: A Large Angry SCM · lore

Re: [PATCH] Documentation for git-daemon.

On Mon, 29 Aug 2005, A Large Angry SCM wrote:

> 
> Signed-off-by:  <gitzilla@gmail.com>

Btw, I enjoy your email address and name, but especially with something that is supposed to hopefully have some legal value down the line if somebody starts making SCO noises, it really would be nice to have a real person to associate things with..

It would be embarrassing later if there is no way to even look you up somehow.

If you don't want your realname/affiliation to be public/official, maybe you could at least let people know in private?

		Linus

A Large Angry SCM· Aug 30, 2005, 03:11 UTC · re: Linus Torvalds · lore

Re: [PATCH] Documentation for git-daemon.

Linus Torvalds wrote:

Show 13 quoted lines

> On Mon, 29 Aug 2005, A Large Angry SCM wrote:
>>Signed-off-by:  <gitzilla@gmail.com>
> 
> Btw, I enjoy your email address and name, but especially with something 
> that is supposed to hopefully have some legal value down the line if 
> somebody starts making SCO noises, it really would be nice to have a real 
> person to associate things with..
> 
> It would be embarrassing later if there is no way to even look you up 
> somehow.
> 
> If you don't want your realname/affiliation to be public/official, maybe
> you could at least let people know in private?

Thanks. I tried to find something interesting for this mailing list.

My real[*1*] name is Raymond S Brand and I currently no affiliation.

Footnotes --------- *1* For some definition of "real".