me
/
guix
Archived
1
0
Fork 0
Code

services: git-daemon: Deprecate 'git-daemon-service' procedure. 

* gnu/services/version-control.scm
(git-daemon-service): Define with 'define-deprecated'
* doc/guix.texi (Version Control Services): Replace with
'git-daemon-service-type'

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Bruno Victal 2023-01-03 14:07:49 +00:00 committed by Ludovic Courtès
parent 7ebeafff15
commit 22e9b01bda
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
2 changed files with 14 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
doc/guix.texi
View File

@ -34907,27 +34907,24 @@ How often to run the node cleaning job. The default is once per day, at
The @code{(gnu services version-control)} module provides a service to The @code{(gnu services version-control)} module provides a service to
allow remote access to local Git repositories. There are three options: allow remote access to local Git repositories. There are three options:
the @code{git-daemon-service}, which provides access to repositories via the @code{git-daemon-service-type}, which provides access to repositories via
the @code{git://} unsecured TCP-based protocol, extending the the @code{git://} unsecured TCP-based protocol, extending the
@code{nginx} web server to proxy some requests to @code{nginx} web server to proxy some requests to
@code{git-http-backend}, or providing a web interface with @code{git-http-backend}, or providing a web interface with
@code{cgit-service-type}. @code{cgit-service-type}.
@deffn {Scheme Procedure} git-daemon-service [#:config (git-daemon-configuration)] @defvar git-daemon-service-type
Type for a service that runs @command{git daemon}, a simple TCP server to
Return a service that runs @command{git daemon}, a simple TCP server to
expose repositories over the Git protocol for anonymous access. expose repositories over the Git protocol for anonymous access.
The optional @var{config} argument should be a The value for this service type is a @code{<git-daemon-configuration>}
@code{<git-daemon-configuration>} object, by default it allows read-only record, by default it allows read-only access to exported@footnote{By
access to exported@footnote{By creating the magic file creating the magic file @file{git-daemon-export-ok} in the repository
@file{git-daemon-export-ok} in the repository directory.} repositories under directory.} repositories under @file{/srv/git}.
@file{/srv/git}. @end defvar
@end deffn
@deftp {Data Type} git-daemon-configuration @deftp {Data Type} git-daemon-configuration
Data type representing the configuration for @code{git-daemon-service}. Data type representing the configuration for @code{git-daemon-service-type}.
@table @asis @table @asis
@item @code{package} (default: @code{git}) @item @code{package} (default: @code{git})
@ -34964,8 +34961,8 @@ Whether to listen on an alternative port, which defaults to 9418.
If not empty, only allow access to this list of directories. If not empty, only allow access to this list of directories.
@item @code{extra-options} (default: @code{'()}) @item @code{extra-options} (default: @code{'()})
Extra options will be passed to @command{git daemon}, please run Extra options that will be passed to @command{git daemon}.@footnote{Run
@command{man git-daemon} for more information. @command{man git-daemon} for more information.}
@end table @end table
@end deftp @end deftp

4
gnu/services/version-control.scm
View File

@ -29,6 +29,7 @@
#:use-module (gnu system shadow) #:use-module (gnu system shadow)
#:use-module (gnu packages version-control) #:use-module (gnu packages version-control)
#:use-module (gnu packages admin) #:use-module (gnu packages admin)
#:use-module (guix deprecation)
#:use-module (guix records) #:use-module (guix records)
#:use-module (guix gexp) #:use-module (guix gexp)
#:use-module (guix store) #:use-module (guix store)
@ -178,7 +179,8 @@
protocol.") protocol.")
(default-value (git-daemon-configuration)))) (default-value (git-daemon-configuration))))
(define* (git-daemon-service #:key (config (git-daemon-configuration))) (define-deprecated (git-daemon-service #:key (config (git-daemon-configuration)))
git-daemon-service-type
"Return a service that runs @command{git daemon}, a simple TCP server to "Return a service that runs @command{git daemon}, a simple TCP server to
expose repositories over the Git protocol for anonymous access. expose repositories over the Git protocol for anonymous access.