[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
03/08: doc: Create "Version Control Services" section.
From: |
Ludovic Courtès |
Subject: |
03/08: doc: Create "Version Control Services" section. |
Date: |
Tue, 28 Nov 2017 17:36:32 -0500 (EST) |
civodul pushed a commit to branch master
in repository guix.
commit 05f1cb3cdaf9f8bf4c50de6c0464641678e5b50f
Author: Andy Wingo <address@hidden>
Date: Thu Apr 27 10:59:44 2017 +0200
doc: Create "Version Control Services" section.
* doc/guix.texi (Version Control Services): Move to its own node.
Signed-off-by: Ludovic Courtès <address@hidden>
---
doc/guix.texi | 124 ++++++++++++++++++++++++++++++----------------------------
1 file changed, 64 insertions(+), 60 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 704a726..f90bb3d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -244,6 +244,7 @@ Services
* Power management Services:: The TLP tool.
* Audio Services:: The MPD.
* Virtualization Services:: Virtualization services.
+* Version Control Services:: Providing remote access to Git repositories.
* Miscellaneous Services:: Other services.
Defining Services
@@ -9403,6 +9404,7 @@ declaration.
* Power management Services:: The TLP tool.
* Audio Services:: The MPD.
* Virtualization Services:: Virtualization services.
+* Version Control Services:: Providing remote access to Git repositories.
* Miscellaneous Services:: Other services.
@end menu
@@ -17430,6 +17432,68 @@ Defaults to @samp{3}
@end deftypevr
address@hidden Version Control Services
address@hidden Version Control Services
+
+The @code{(gnu services version-control)} module provides a service to
+allow remote access to local Git repositories.
+
address@hidden {Scheme Procedure} git-daemon-service [#:config
(git-daemon-configuration)]
+
+Return a service that runs @command{git daemon}, a simple TCP server to
+expose repositories over the Git protocol for anonymous access.
+
+The optional @var{config} argument should be a
address@hidden<git-daemon-configuration>} object, by default it allows read-only
+access to address@hidden creating the magic file
+"git-daemon-export-ok" in the repository directory.} repositories under
address@hidden/srv/git}.
+
address@hidden deffn
+
address@hidden {Data Type} git-daemon-configuration
+Data type representing the configuration for @code{git-daemon-service}.
+
address@hidden @asis
address@hidden @code{package} (default: @var{git})
+Package object of the Git distributed version control system.
+
address@hidden @code{export-all?} (default: @var{#f})
+Whether to allow access for all Git repositories, even if they do not
+have the @file{git-daemon-export-ok} file.
+
address@hidden @code{base-path} (default: @file{/srv/git})
+Whether to remap all the path requests as relative to the given path.
+If you run git daemon with @var{(base-path "/srv/git")} on example.com,
+then if you later try to pull @code{git://example.com/hello.git}, git
+daemon will interpret the path as @code{/srv/git/hello.git}.
+
address@hidden @code{user-path} (default: @var{#f})
+Whether to allow @code{~user} notation to be used in requests. When
+specified with empty string, requests to @code{git://host/~alice/foo} is
+taken as a request to access @code{foo} repository in the home directory
+of user @code{alice}. If @var{(user-path "path")} is specified, the
+same request is taken as a request to access @code{path/foo} repository
+in the home directory of user @code{alice}.
+
address@hidden @code{listen} (default: @var{'()})
+Whether to listen on specific IP addresses or hostnames, defaults to
+all.
+
address@hidden @code{port} (default: @var{#f})
+Whether to listen on an alternative port, which defaults to 9418.
+
address@hidden @code{whitelist} (default: @var{'()})
+If not empty, only allow access to this list of directories.
+
address@hidden @code{extra-options} (default: @var{'()})
+Extra options will be passed to @code{git daemon}, please run
address@hidden git-daemon} for more information.
+
address@hidden table
address@hidden deftp
+
+
@node Miscellaneous Services
@subsubsection Miscellaneous Services
@@ -17591,66 +17655,6 @@ The following is an example @code{dicod-service}
configuration.
%dicod-database:gcide))))
@end example
address@hidden Version Control
-
-The @code{(gnu services version-control)} module provides the following
services:
-
address@hidden Git daemon service
-
address@hidden {Scheme Procedure} git-daemon-service [#:config
(git-daemon-configuration)]
-
-Return a service that runs @command{git daemon}, a simple TCP server to
-expose repositories over the Git protocol for anonymous access.
-
-The optional @var{config} argument should be a
address@hidden<git-daemon-configuration>} object, by default it allows read-only
-access to address@hidden creating the magic file
-"git-daemon-export-ok" in the repository directory.} repositories under
address@hidden/srv/git}.
-
address@hidden deffn
-
address@hidden {Data Type} git-daemon-configuration
-Data type representing the configuration for @code{git-daemon-service}.
-
address@hidden @asis
address@hidden @code{package} (default: @var{git})
-Package object of the Git distributed version control system.
-
address@hidden @code{export-all?} (default: @var{#f})
-Whether to allow access for all Git repositories, even if they do not
-have the @file{git-daemon-export-ok} file.
-
address@hidden @code{base-path} (default: @file{/srv/git})
-Whether to remap all the path requests as relative to the given path.
-If you run git daemon with @var{(base-path "/srv/git")} on example.com,
-then if you later try to pull @code{git://example.com/hello.git}, git
-daemon will interpret the path as @code{/srv/git/hello.git}.
-
address@hidden @code{user-path} (default: @var{#f})
-Whether to allow @code{~user} notation to be used in requests. When
-specified with empty string, requests to @code{git://host/~alice/foo} is
-taken as a request to access @code{foo} repository in the home directory
-of user @code{alice}. If @var{(user-path "path")} is specified, the
-same request is taken as a request to access @code{path/foo} repository
-in the home directory of user @code{alice}.
-
address@hidden @code{listen} (default: @var{'()})
-Whether to listen on specific IP addresses or hostnames, defaults to
-all.
-
address@hidden @code{port} (default: @var{#f})
-Whether to listen on an alternative port, which defaults to 9418.
-
address@hidden @code{whitelist} (default: @var{'()})
-If not empty, only allow access to this list of directories.
-
address@hidden @code{extra-options} (default: @var{'()})
-Extra options will be passed to @code{git daemon}, please run
address@hidden git-daemon} for more information.
-
address@hidden table
address@hidden deftp
@subsubheading Cgit Service
- branch master updated (20d2c6e -> 3af03e5), Ludovic Courtès, 2017/11/28
- 05/08: tests: cgit: Add a file to the test repository., Ludovic Courtès, 2017/11/28
- 06/08: tests: Add 'git-http' test., Ludovic Courtès, 2017/11/28
- 08/08: services: certbot: Add default value and description., Ludovic Courtès, 2017/11/28
- 07/08: services: cgit, git-daemon: Add description and default value., Ludovic Courtès, 2017/11/28
- 02/08: services: Add certbot service., Ludovic Courtès, 2017/11/28
- 04/08: services: Add Git HTTP(S) service support., Ludovic Courtès, 2017/11/28
- 01/08: build: Add missing patch., Ludovic Courtès, 2017/11/28
- 03/08: doc: Create "Version Control Services" section.,
Ludovic Courtès <=