01/03: doc: Remove Simple Cuirass section.

[guix-commits]

mothacehe pushed a commit to branch master
in repository guix.

commit 8ac7fae8b0aebee01cb2592fd24c49fc0828c019
Author: Mathieu Othacehe <othacehe@gnu.org>
AuthorDate: Tue Mar 23 16:33:31 2021 +0100

    doc: Remove Simple Cuirass section.
    
    This is no longer needed as the Cuirass specification mechanism has been
    rewritten.
    
    * doc/guix.texi (Continuous Integration): Remove Simple Cuirass section.
---
 doc/guix.texi | 112 ----------------------------------------------------------
 1 file changed, 112 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 94ecd2c..096ffc7 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -27215,118 +27215,6 @@ The Cuirass package to use.
 @end table
 @end deftp
 
-@cindex simple cuirass
-@subsubheading Simple Cuirass
-
-The Cuirass service configuration described above can be a little
-intimidating.  In particular, getting the right @code{specifications}
-can prove difficult.  The @code{simple-cuirass-configuration->specs}
-procedure offers a way to generate those @code{specifications} and thus
-setup a continuous integration server more readily.
-
-@deffn {Scheme Procedure} simple-cuirass-configuration->specs 
@var{configuration}
-This procedure takes a @code{simple-cuirass-configuration} record as
-argument and returns the corresponding Cuirass specifications gexp.
-@end deffn
-
-@deftp {Data Type} simple-cuirass-configuration
-Data type representing the configuration of a simple Cuirass instance.
-
-@table @asis
-@item @code{build} (default: @code{all})
-The packages to be built by Cuirass.  It defaults to @code{all}, which
-means that all the discovered packages in the subsequent @code{channels}
-field are to be selected.
-
-It is also possible to set this field to a list of @code{build-manifest}
-records, so that only the packages that are part of the declared
-manifests are built.  This record is described below.
-
-@deftp {Data Type} build-manifest
-@table @asis
-@item @code{channel-name}
-The name of the channel where the manifest is located.
-
-@item @code{manifest}
-The manifest path inside the channel.
-
-@end table
-@end deftp
-
-@item @code{channels} (default: @code{%default-channels})
-The channels to be fetched by Cuirass (@pxref{Channels}).
-
-@item @code{non-package-channels} (default: @code{'()})
-List the channel names that must not be searched for packages.  That is
-often the case for the channel containing the manifest.
-
-@item @code{systems} (default: @code{(list (%current-system))})
-Build every discovered package for each system in this list.  By default
-only the current system is selected.
-
-@end table
-@end deftp
-
-Here is an example of how to setup a Cuirass instance that builds all
-the packages declared by Guix and a user repository.  The package list
-is re-evaluated each time a commit is pushed in one of the declared
-channels.
-
-@lisp
-(service cuirass-service-type
-         (cuirass-configuration
-          (specifications
-           (simple-cuirass-configuration->specs
-            (simple-cuirass-configuration
-             (build 'all)
-             (channels (cons (channel
-                              (name 'my-guix)
-                              (url "https://my-git-repo/guix.git";))
-                             %default-channels)))))))
-@end lisp
-
-In the same spirit, this builds all the packages that are part of the
-@code{guix} or @code{my-guix} channels and declared in the manifest
-located in the @code{conf} channel.
-
-@lisp
-(service cuirass-service-type
-         (cuirass-configuration
-          (specifications
-           (simple-cuirass-configuration->specs
-            (simple-cuirass-configuration
-             (build (list
-                     (build-manifest
-                      (channel-name 'conf)
-                      (manifest "guix/manifest.scm"))))
-             (channels (cons* (channel
-                               (name 'my-guix)
-                               (url "https://my-git-repo/guix.git";))
-                              (channel
-                               (name 'conf)
-                               (url "https://my-git-repo/conf.git";))
-                              %default-channels))
-             (non-package-channels '(conf)))))))
-@end lisp
-
-Finally, @code{simple-cuirass-services} takes as a second optional
-argument a @code{cuirass-configuration} record.  It can be used to
-customize the configuration of the Cuirass instance.
-
-@lisp
-(simple-cuirass-services
- (simple-cuirass-configuration
-  (build 'all)
-  (channels (cons (channel
-                   (name 'my-guix)
-                   (url "https://my-git-repo/guix.git";))
-                  %default-channels))
-  (non-package-channels '(conf)))
- (cuirass-configuration
-  (inherit %default-cuirass-config)
-  (host "0.0.0.0"))) ;listen on all interfaces.
-@end lisp
-
 @node Power Management Services
 @subsection Power Management Services