diff options
Diffstat (limited to 'doc/guix.texi')
| -rw-r--r-- | doc/guix.texi | 58 |
1 files changed, 47 insertions, 11 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 3557c977e1..750483706b 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -76,7 +76,7 @@ Copyright @copyright{} 2020 Damien Cassou@* Copyright @copyright{} 2020 Jakub Kądziołka@* Copyright @copyright{} 2020 Jack Hill@* Copyright @copyright{} 2020 Naga Malleswari@* -Copyright @copyright{} 2020 Brice Waegeneire@* +Copyright @copyright{} 2020, 2021 Brice Waegeneire@* Copyright @copyright{} 2020 R Veera Kumar@* Copyright @copyright{} 2020 Pierre Langlois@* Copyright @copyright{} 2020 pinoaffe@* @@ -787,6 +787,13 @@ To use substitutes from @code{@value{SUBSTITUTE-SERVER}} or one of its mirrors ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER}.pub @end example +@quotation Note +If you do not enable substitutes, Guix will end up building +@emph{everything} from source on your machine, making each installation +and upgrade very expensive. @xref{On Trusting Binaries}, for a +discussion of reasons why one might want do disable substitutes. +@end quotation + @item Each user may need to perform a few additional steps to make their Guix environment ready for use, @pxref{Application Setup}. @@ -833,8 +840,7 @@ GNU Guix is available for download from its website at GNU Guix depends on the following packages: @itemize -@item @url{https://gnu.org/software/guile/, GNU Guile}, version 3.0.x or -2.2.x; +@item @url{https://gnu.org/software/guile/, GNU Guile}, version 3.0.x; @item @url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt}, version 0.1.0 or later; @item @@ -11624,6 +11630,28 @@ using this mode, the symbol of the package is made by appending the version to its name, so that multiple versions of the same package can coexist. @end table + +@item egg +@cindex egg +Import metadata for @uref{https://wiki.call-cc.org/eggs, CHICKEN eggs}. +The information is taken from @file{PACKAGE.egg} files found in the +@uref{git://code.call-cc.org/eggs-5-latest, eggs-5-latest} Git +repository. However, it does not provide all the information that we +need, there is no ``description'' field, and the licenses used are not +always precise (BSD is often used instead of BSD-N). + +@example +guix import egg sourcehut +@end example + +Additional options include: +@table @code +@item --recursive +@itemx -r +Traverse the dependency graph of the given upstream package recursively +and generate package expressions for all those packages that are not yet +in Guix. +@end table @end table The structure of the @command{guix import} code is modular. It would be @@ -11778,6 +11806,8 @@ the updater for KDE packages; the updater for X.org packages; @item kernel.org the updater for packages hosted on kernel.org; +@item egg +the updater for @uref{https://wiki.call-cc.org/eggs/, Egg} packages; @item elpa the updater for @uref{https://elpa.gnu.org/, ELPA} packages; @item cran @@ -16450,6 +16480,7 @@ configuration rejecting all incoming connections except those to the ssh port :INPUT ACCEPT :FORWARD ACCEPT :OUTPUT ACCEPT +-A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT -A INPUT -p tcp --dport 22 -j ACCEPT -A INPUT -j REJECT --reject-with icmp-port-unreachable COMMIT @@ -16458,6 +16489,7 @@ COMMIT :INPUT ACCEPT :FORWARD ACCEPT :OUTPUT ACCEPT +-A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT -A INPUT -p tcp --dport 22 -j ACCEPT -A INPUT -j REJECT --reject-with icmp6-port-unreachable COMMIT @@ -19236,7 +19268,7 @@ The MATE package to use. @end deftp @deffn {Scheme Variable} lxqt-desktop-service-type -This is the type of the service that runs the @uref{https://lxqt.github.io, +This is the type of the service that runs the @uref{https://lxqt-project.org, LXQt desktop environment}. Its value is a @code{lxqt-desktop-configuration} object (see below). @@ -33868,6 +33900,13 @@ every time you modify your @command{config.scm} file and the @command{-o StrictHostKeyChecking=no} prevents you from having to allow a connection to an unknown host every time you connect. +@quotation Note +If you find the above @samp{hostfwd} example not to be working (e.g., +your SSH client hangs attempting to connect to the mapped port of your +VM), make sure that your Guix System VM has networking support, such as +by using the @code{dhcp-client-service-type} service type. +@end quotation + @subsection Using @command{virt-viewer} with Spice As an alternative to the default @command{qemu} graphical client you can @@ -34395,13 +34434,10 @@ This service type is intended to be extended by other service types, such as below: @lisp -(define module-installing-service-type - (service-type - (name 'module-installing-service) - (extensions (list (service-extension linux-loadable-module-service-type - (const (list module-to-install-1 - module-to-install-2))))) - (default-value #f))) +(simple-service 'installing-module + linux-loadable-module-service-type + (list module-to-install-1 + module-to-install-2)) @end lisp This does not actually load modules at bootup, only adds it to the |