[bug#30906] [PATCH] doc: Move Cgit Service documentation to the Version Control section.

[Leo Famulari]

* doc/guix.texi (Miscellaneous Services): Move the Cgit Service to
section Version Control Services.
---
 doc/guix.texi | 393 +++++++++++++++++++++++++++++-----------------------------
 1 file changed, 197 insertions(+), 196 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 7617d7fe1..91e4670ff 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -18327,11 +18327,12 @@ Return the name of @var{platform}---a string such as 
@code{"arm"}.
 @subsubsection Version Control Services
 
 The @code{(gnu services version-control)} module provides a service to
-allow remote access to local Git repositories.  There are two 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://} unsecured TCP-based protocol, or extending the
+the @code{git://} unsecured TCP-based protocol, extending the
 @code{nginx} web server to proxy some requests to
address@hidden
address@hidden, or providing a web interface with
address@hidden
 
 @deffn {Scheme Procedure} git-daemon-service [#:config 
(git-daemon-configuration)]
 
@@ -18464,199 +18465,6 @@ HTTPS.  You will also need to add an @code{fcgiwrap} 
proxy to your
 system services.  @xref{Web Services}.
 @end deffn
 
address@hidden Game Services
address@hidden Game Services
-
address@hidden The Battle for Wesnoth Service
address@hidden wesnothd
address@hidden://wesnoth.org, The Battle for Wesnoth} is a fantasy, turn
-based tactical strategy game, with several single player campaigns, and
-multiplayer games (both networked and local).
-
address@hidden {Scheme Variable} wesnothd-service-type
-Service type for the wesnothd service.  Its value must be a
address@hidden object.  To run wesnothd in the default
-configuration, instantiate it as:
-
address@hidden
-(service wesnothd-service-type)
address@hidden example
address@hidden defvar
-
address@hidden {Data Type} wesnothd-configuration
-Data type representing the configuration of @command{wesnothd}.
-
address@hidden @asis
address@hidden @code{package} (default: @code{wesnoth-server})
-The wesnoth server package to use.
-
address@hidden @code{port} (default: @code{15000})
-The port to bind the server to.
address@hidden table
address@hidden deftp
-
address@hidden Miscellaneous Services
address@hidden Miscellaneous Services
-
address@hidden sysctl
address@hidden System Control Service
-
-The @code{(gnu services sysctl)} provides a service to configure kernel
-parameters at boot.
-
address@hidden {Scheme Variable} sysctl-service-type
-The service type for @command{sysctl}, which modifies kernel parameters
-under @file{/proc/sys/}.  To enable IPv4 forwarding, it can be
-instantiated as:
-
address@hidden
-(service sysctl-service-type
-         (sysctl-configuration
-           (settings '(("net.ipv4.ip_forward" . "1")))))
address@hidden example
address@hidden defvr
-
address@hidden {Data Type} sysctl-configuration
-The data type representing the configuration of @command{sysctl}.
-
address@hidden @asis
address@hidden @code{sysctl} (default: @code{(file-append procps 
"/sbin/sysctl"})
-The @command{sysctl} executable to use.
-
address@hidden @code{settings} (default: @code{'()})
-An association list specifies kernel parameters and their values.
address@hidden table
address@hidden deftp
-
address@hidden lirc
address@hidden Lirc Service
-
-The @code{(gnu services lirc)} module provides the following service.
-
address@hidden {Scheme Procedure} lirc-service [#:lirc lirc] @
-       [#:device #f] [#:driver #f] [#:config-file #f] @
-       [#:extra-options '()]
-Return a service that runs @url{http://www.lirc.org,LIRC}, a daemon that
-decodes infrared signals from remote controls.
-
-Optionally, @var{device}, @var{driver} and @var{config-file}
-(configuration file name) may be specified.  See @command{lircd} manual
-for details.
-
-Finally, @var{extra-options} is a list of additional command-line options
-passed to @command{lircd}.
address@hidden deffn
-
address@hidden spice
address@hidden Spice Service
-
-The @code{(gnu services spice)} module provides the following service.
-
address@hidden {Scheme Procedure} spice-vdagent-service [#:spice-vdagent]
-Returns a service that runs @url{http://www.spice-space.org,VDAGENT}, a daemon
-that enables sharing the clipboard with a vm and setting the guest display
-resolution when the graphical console window resizes.
address@hidden deffn
-
address@hidden Dictionary Services
address@hidden dictionary
-The @code{(gnu services dict)} module provides the following service:
-
address@hidden {Scheme Procedure} dicod-service [#:config (dicod-configuration)]
-Return a service that runs the @command{dicod} daemon, an implementation
-of DICT server (@pxref{Dicod,,, dico, GNU Dico Manual}).
-
-The optional @var{config} argument specifies the configuration for
address@hidden, which should be a @code{<dicod-configuration>} object, by
-default it serves the GNU Collaborative International Dictonary of English.
-
-You can add @command{open localhost} to your @file{~/.dico} file to make
address@hidden the default server for @command{dico} client
-(@pxref{Initialization File,,, dico, GNU Dico Manual}).
address@hidden deffn
-
address@hidden {Data Type} dicod-configuration
-Data type representing the configuration of dicod.
-
address@hidden @asis
address@hidden @code{dico} (default: @var{dico})
-Package object of the GNU Dico dictionary server.
-
address@hidden @code{interfaces} (default: @var{'("localhost")})
-This is the list of IP addresses and ports and possibly socket file
-names to listen to (@pxref{Server Settings, @code{listen} directive,,
-dico, GNU Dico Manual}).
-
address@hidden @code{handlers} (default: @var{'()})
-List of @code{<dicod-handler>} objects denoting handlers (module instances).
-
address@hidden @code{databases} (default: @var{(list %dicod-database:gcide)})
-List of @code{<dicod-database>} objects denoting dictionaries to be served.
address@hidden table
address@hidden deftp
-
address@hidden {Data Type} dicod-handler
-Data type representing a dictionary handler (module instance).
-
address@hidden @asis
address@hidden @code{name}
-Name of the handler (module instance).
-
address@hidden @code{module} (default: @var{#f})
-Name of the dicod module of the handler (instance).  If it is @code{#f},
-the module has the same name as the handler.
-(@pxref{Modules,,, dico, GNU Dico Manual}).
-
address@hidden @code{options}
-List of strings or gexps representing the arguments for the module handler
address@hidden table
address@hidden deftp
-
address@hidden {Data Type} dicod-database
-Data type representing a dictionary database.
-
address@hidden @asis
address@hidden @code{name}
-Name of the database, will be used in DICT commands.
-
address@hidden @code{handler}
-Name of the dicod handler (module instance) used by this database
-(@pxref{Handlers,,, dico, GNU Dico Manual}).
-
address@hidden @code{complex?} (default: @var{#f})
-Whether the database configuration complex.  The complex configuration
-will need a corresponding @code{<dicod-handler>} object, otherwise not.
-
address@hidden @code{options}
-List of strings or gexps representing the arguments for the database
-(@pxref{Databases,,, dico, GNU Dico Manual}).
address@hidden table
address@hidden deftp
-
address@hidden {Scheme Variable} %dicod-database:gcide
-A @code{<dicod-database>} object serving the GNU Collaborative International
-Dictionary of English using the @code{gcide} package.
address@hidden defvr
-
-The following is an example @code{dicod-service} configuration.
-
address@hidden
-(dicod-service #:config
-  (dicod-configuration
-   (handlers (list (dicod-handler
-                    (name "wordnet")
-                    (module "dictorg")
-                    (options
-                     (list #~(string-append "dbdir=" #$wordnet))))))
-   (databases (list (dicod-database
-                     (name "wordnet")
-                     (complex? #t)
-                     (handler "wordnet")
-                     (options '("database=wn")))
-                    %dicod-database:gcide))))
address@hidden example
-
-
 @subsubheading Cgit Service
 
 @cindex Cgit service
@@ -19595,6 +19403,199 @@ could instantiate a cgit service like this:
           (cgitrc "")))
 @end example
 
+
address@hidden Game Services
address@hidden Game Services
+
address@hidden The Battle for Wesnoth Service
address@hidden wesnothd
address@hidden://wesnoth.org, The Battle for Wesnoth} is a fantasy, turn
+based tactical strategy game, with several single player campaigns, and
+multiplayer games (both networked and local).
+
address@hidden {Scheme Variable} wesnothd-service-type
+Service type for the wesnothd service.  Its value must be a
address@hidden object.  To run wesnothd in the default
+configuration, instantiate it as:
+
address@hidden
+(service wesnothd-service-type)
address@hidden example
address@hidden defvar
+
address@hidden {Data Type} wesnothd-configuration
+Data type representing the configuration of @command{wesnothd}.
+
address@hidden @asis
address@hidden @code{package} (default: @code{wesnoth-server})
+The wesnoth server package to use.
+
address@hidden @code{port} (default: @code{15000})
+The port to bind the server to.
address@hidden table
address@hidden deftp
+
address@hidden Miscellaneous Services
address@hidden Miscellaneous Services
+
address@hidden sysctl
address@hidden System Control Service
+
+The @code{(gnu services sysctl)} provides a service to configure kernel
+parameters at boot.
+
address@hidden {Scheme Variable} sysctl-service-type
+The service type for @command{sysctl}, which modifies kernel parameters
+under @file{/proc/sys/}.  To enable IPv4 forwarding, it can be
+instantiated as:
+
address@hidden
+(service sysctl-service-type
+         (sysctl-configuration
+           (settings '(("net.ipv4.ip_forward" . "1")))))
address@hidden example
address@hidden defvr
+
address@hidden {Data Type} sysctl-configuration
+The data type representing the configuration of @command{sysctl}.
+
address@hidden @asis
address@hidden @code{sysctl} (default: @code{(file-append procps 
"/sbin/sysctl"})
+The @command{sysctl} executable to use.
+
address@hidden @code{settings} (default: @code{'()})
+An association list specifies kernel parameters and their values.
address@hidden table
address@hidden deftp
+
address@hidden lirc
address@hidden Lirc Service
+
+The @code{(gnu services lirc)} module provides the following service.
+
address@hidden {Scheme Procedure} lirc-service [#:lirc lirc] @
+       [#:device #f] [#:driver #f] [#:config-file #f] @
+       [#:extra-options '()]
+Return a service that runs @url{http://www.lirc.org,LIRC}, a daemon that
+decodes infrared signals from remote controls.
+
+Optionally, @var{device}, @var{driver} and @var{config-file}
+(configuration file name) may be specified.  See @command{lircd} manual
+for details.
+
+Finally, @var{extra-options} is a list of additional command-line options
+passed to @command{lircd}.
address@hidden deffn
+
address@hidden spice
address@hidden Spice Service
+
+The @code{(gnu services spice)} module provides the following service.
+
address@hidden {Scheme Procedure} spice-vdagent-service [#:spice-vdagent]
+Returns a service that runs @url{http://www.spice-space.org,VDAGENT}, a daemon
+that enables sharing the clipboard with a vm and setting the guest display
+resolution when the graphical console window resizes.
address@hidden deffn
+
address@hidden Dictionary Services
address@hidden dictionary
+The @code{(gnu services dict)} module provides the following service:
+
address@hidden {Scheme Procedure} dicod-service [#:config (dicod-configuration)]
+Return a service that runs the @command{dicod} daemon, an implementation
+of DICT server (@pxref{Dicod,,, dico, GNU Dico Manual}).
+
+The optional @var{config} argument specifies the configuration for
address@hidden, which should be a @code{<dicod-configuration>} object, by
+default it serves the GNU Collaborative International Dictonary of English.
+
+You can add @command{open localhost} to your @file{~/.dico} file to make
address@hidden the default server for @command{dico} client
+(@pxref{Initialization File,,, dico, GNU Dico Manual}).
address@hidden deffn
+
address@hidden {Data Type} dicod-configuration
+Data type representing the configuration of dicod.
+
address@hidden @asis
address@hidden @code{dico} (default: @var{dico})
+Package object of the GNU Dico dictionary server.
+
address@hidden @code{interfaces} (default: @var{'("localhost")})
+This is the list of IP addresses and ports and possibly socket file
+names to listen to (@pxref{Server Settings, @code{listen} directive,,
+dico, GNU Dico Manual}).
+
address@hidden @code{handlers} (default: @var{'()})
+List of @code{<dicod-handler>} objects denoting handlers (module instances).
+
address@hidden @code{databases} (default: @var{(list %dicod-database:gcide)})
+List of @code{<dicod-database>} objects denoting dictionaries to be served.
address@hidden table
address@hidden deftp
+
address@hidden {Data Type} dicod-handler
+Data type representing a dictionary handler (module instance).
+
address@hidden @asis
address@hidden @code{name}
+Name of the handler (module instance).
+
address@hidden @code{module} (default: @var{#f})
+Name of the dicod module of the handler (instance).  If it is @code{#f},
+the module has the same name as the handler.
+(@pxref{Modules,,, dico, GNU Dico Manual}).
+
address@hidden @code{options}
+List of strings or gexps representing the arguments for the module handler
address@hidden table
address@hidden deftp
+
address@hidden {Data Type} dicod-database
+Data type representing a dictionary database.
+
address@hidden @asis
address@hidden @code{name}
+Name of the database, will be used in DICT commands.
+
address@hidden @code{handler}
+Name of the dicod handler (module instance) used by this database
+(@pxref{Handlers,,, dico, GNU Dico Manual}).
+
address@hidden @code{complex?} (default: @var{#f})
+Whether the database configuration complex.  The complex configuration
+will need a corresponding @code{<dicod-handler>} object, otherwise not.
+
address@hidden @code{options}
+List of strings or gexps representing the arguments for the database
+(@pxref{Databases,,, dico, GNU Dico Manual}).
address@hidden table
address@hidden deftp
+
address@hidden {Scheme Variable} %dicod-database:gcide
+A @code{<dicod-database>} object serving the GNU Collaborative International
+Dictionary of English using the @code{gcide} package.
address@hidden defvr
+
+The following is an example @code{dicod-service} configuration.
+
address@hidden
+(dicod-service #:config
+  (dicod-configuration
+   (handlers (list (dicod-handler
+                    (name "wordnet")
+                    (module "dictorg")
+                    (options
+                     (list #~(string-append "dbdir=" #$wordnet))))))
+   (databases (list (dicod-database
+                     (name "wordnet")
+                     (complex? #t)
+                     (handler "wordnet")
+                     (options '("database=wn")))
+                    %dicod-database:gcide))))
address@hidden example
+
 @node Setuid Programs
 @subsection Setuid Programs
 
-- 
2.16.2