summaryrefslogtreecommitdiff
path: root/doc/guix.texi
Commit message (Collapse)AuthorAge
* services: Add a service for opendht.Maxim Cournoyer2021-05-17
| | | | | | | | | * gnu/services/networking.scm (maybe-number?, maybe-string?): New procedures. (<opendht-configuration>): New configuration record. (%opendht-accounts): New variable. (opendht-configuration->command-line-arguments): New procedure. (opendht-shepherd-service, opendht-service-type): New variables. * doc/guix.texi (Networking Services): Document the new service.
* publish: Add '--negative-ttl'.Ludovic Courtès2021-05-16
| | | | | | | | | * guix/scripts/publish.scm (show-help, %options): Add '--negative-ttl'. (render-narinfo, render-narinfo/cached, make-request-handler): Add #:negative-ttl and honor it. (run-publish-server): Add #:narinfo-negative-ttl and honor it. (guix-publish): Honor '--negative-ttl'. * tests/publish.scm ("negative TTL", "no negative TTL"): New tests.
* doc: Do not instruct to decompress the VM image.Maxim Cournoyer2021-05-12
| | | | | | | | | Also replace the obsolete 'guix system vm-image' command mention by the 'guix system image'. * doc/guix.texi (Running Guix in a VM): Remove VM image decompression instruction. <guix system vm-image>: Replace by 'guix system image'.
* Merge branch 'version-1.3.0'Maxim Cournoyer2021-05-11
|\
| * build: Do not compress the (already compressed) VM qcow2 images.Maxim Cournoyer2021-05-05
| | | | | | | | | | | | | | | | The qcow2 format supports compression, and the qcow2 type supported by 'guix system image' produces compressed qcow2 images. * Makefile.am (release): Do not re-compress the qcow2 VM images with xz. * doc/guix.texi (Running Guix in a VM): Adjust VM image URL.
| * doc: Update the OpenPGP key used to sign the release.Maxim Cournoyer2021-05-05
| | | | | | | | | | | | | | | | It was discussed on guix-devel that the manual only needs to have correct instructions for the latest release. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID): Update to my public OpenPGP key. (OPENPGP-SIGNING-KEY-URL): Adjust URL.
| * Revert "doc: Update to cover for an additional OpenPGP signing key."Maxim Cournoyer2021-05-05
| | | | | | | | | | | | This reverts commit b9fb13b28437a254683273094f189396a6e1421d. Per discussions simply updating OPENPGP-SIGNING-KEY-ID and OPENPGP-SIGNING-KEY-URL will be enough.
| * doc: Update to cover for an additional OpenPGP signing key.Maxim Cournoyer2021-05-03
| | | | | | | | | | | | | | | | | | | | | | | | | | The upcoming 1.3.0 release will be signed with my OpenPGP key; subsequent releases may also be. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID, OPENPGP-SIGNING-KEY-URL): Rename to... (OPENPGP-SIGNING-KEY-ID-1, OPENPGP-SIGNING-KEY-URL-1): ... these, respectively. (OPENPGP-SIGNING-KEY-ID-2, OPENPGP-SIGNING-KEY-URL-2): New variables. (Binary Installation): Adjust to cover for the new key. (USB Stick and DVD Installation): Likewise. (Invoking guix refresh): Adjust accordingly.
| * maint: Do not xz-compress ISO images.Ludovic Courtès2021-05-03
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The xz-compressed image is 23% smaller than the original ISO image (with built-in zlib compression), but the extra decompression step is unconventional and often a hindrance for users. See discussion at <https://lists.gnu.org/archive/html/guix-devel/2021-04/msg00497.html>. * Makefile.am (release): Do not compress ISO images. * doc/guix.texi (USB Stick and DVD Installation): Remove ".xz" suffix from URL and file name. (Copying to a USB Stick, Burning on a DVD): Remove introductory words, @enumerate, and first item. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
| * doc: Update the URL of the system VM image.Maxim Cournoyer2021-05-03
| | | | | | | | | | | | | | This is a follow up to commit ebf5d77eab, which added the qcow2 file extension to the VM image file name. * doc/guix.texi (Running Guix in a VM): Update URL.
| * import: Remove Nix importer.Ludovic Courtès2021-04-25
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This importer has suffered from bitrot and no longer works with current Nix and Nixpkgs. See <https://bugs.gnu.org/32339> and <https://bugs.gnu.org/36255>. * guix/import/snix.scm, guix/scripts/import/nix.scm, tests/snix.scm: Remove. * Makefile.am (MODULES, SCM_TESTS): Remove them. * guix/scripts/import.scm (importers): Remove "nix". * build-aux/test-env.in: Remove NIXPKGS variable. * configure.ac: Remove '--with-nixpkgs' option. * doc/guix.texi (Invoking guix import): Remove bit about "guix import nix". * etc/completion/fish/guix.fish: Likewise.
* | gnu: Allow services to install kernel-loadable modules.raid5atemyhomework2021-05-11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/system.scm (operating-system-directory-base-entries): Remove code to handle generation of "kernel" for linux-libre kernels. (operating-system-default-essential-services): Instantiate linux-builder-service-type. (package-for-kernel): Move ... * gnu/services.scm: ... to here. (linux-builder-service-type): New variable. (linux-builder-configuration): New type. (linux-loadable-module-service-type): New variable. * gnu/tests/linux-modules.scm (run-loadable-kernel-modules-test): Move code to ... (run-loadable-kernel-modules-test-base): ... new procedure here. (run-loadable-kernel-modules-service-test): New procedure. (%test-loadable-kernel-modules-service-0): New variable. (%test-loadable-kernel-modules-service-1): New variable. (%test-loadable-kernel-modules-service-2): New variable. * doc/guix.texi: Document linux-loadable-module-service-type. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
* | services: dovecot: Add ‘managesieve-sieve-capability’ option.Alexey Abramov2021-05-06
| | | | | | | | | | | | | | | | * gnu/services/mail.scm (protocol-configuration): Add a ‘managesieve-sieve-capability’ field. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
* | services: dovecot: Add ‘managesieve-notify-capability’ option.Alexey Abramov2021-05-06
| | | | | | | | | | | | | | | | * gnu/services/mail.scm (protocol-configuration): Add a ‘managesieve-notify-capability’ field. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
* | services: dovecot: Add ‘imap-metadata?’ protocol configuration option.Alexey Abramov2021-05-06
| | | | | | | | | | | | | | | | * gnu/services/mail.scm (protocol-configuration): Add an ‘imap-metadata?’ setting to enable IMAP METADATA support in the ‘imap’ protocol. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
* | services: dovecot: Add ‘mail-attribute-dict’ configuration option.Alexey Abramov2021-05-06
| | | | | | | | | | | | | | | | * gnu/services/mail.scm (dovecot-configuration): Define a ‘mail-attribute-dict’ directive for IMAP METADATA storage. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
* | gnu: rasdaemon: Fix Texinfo syntax of description.Ludovic Courtès2021-05-05
| | | | | | | | | | | | | | | | Regression introduced in 58805da44dac6b180245edd8a6419343f64d221c. * gnu/packages/linux.scm (rasdaemon)[description]: Avoid @acronym since Guile's Texinfo module doesn't currently support @comma{}. * doc/guix.texi (Linux Services): Use @comma{} within @acronym.
* | Revert "doc: Update to cover for an additional OpenPGP signing key."Maxim Cournoyer2021-05-05
| | | | | | | | | | | | This reverts commit b9fb13b28437a254683273094f189396a6e1421d. Per discussions simply updating OPENPGP-SIGNING-KEY-ID and OPENPGP-SIGNING-KEY-URL will be enough.
* | doc: Fix typo and use @acronym for RAS.Tobias Geerinckx-Rice2021-05-04
| | | | | | | | * doc/guix.texi (Linux Services): Fix typo and use @acronym for RAS.
* | doc: Update to cover for an additional OpenPGP signing key.Maxim Cournoyer2021-05-03
| | | | | | | | | | | | | | | | | | | | | | | | | | The upcoming 1.3.0 release will be signed with my OpenPGP key; subsequent releases may also be. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID, OPENPGP-SIGNING-KEY-URL): Rename to... (OPENPGP-SIGNING-KEY-ID-1, OPENPGP-SIGNING-KEY-URL-1): ... these, respectively. (OPENPGP-SIGNING-KEY-ID-2, OPENPGP-SIGNING-KEY-URL-2): New variables. (Binary Installation): Adjust to cover for the new key. (USB Stick and DVD Installation): Likewise. (Invoking guix refresh): Adjust accordingly.
* | services: mysql: Add extra-environment as configuration option.methuselah-02021-04-27
| | | | | | | | | | | | | | | | * gnu/services/databases.scm (mysql-configuration): Add extra-environment (mysql-service): Use #:log-file and #:environment-variables * doc/guix.texi: Document it. Signed-off-by: Leo Prikler <leo.prikler@student.tugraz.at>
* | doc: Remove extraneous spaces from the net-options default value snippet.Maxim Cournoyer2021-04-26
| | | | | | | | | | | | | | | | | | | | Adapting the snippet corresponding to the default value of the net-options field of the hurd-vm-configuration record shown in the manual would easily lead to a broken childhurd service, due to the presence of extraneous spaces in the option string. * doc/guix.texi (Virtualization Services)[hurd-vm-configuration] <net-options>: Use string-append to properly form the option string.
* | doc: Document translation process.Julien Lepiller2021-04-25
| | | | | | | | | | doc/contributing.texi (Translating Guix): New section. doc/guix.texi (Top): Add a reference to the new section.
* | services: Add a service for rasdaemon.B. Wilson2021-04-24
| | | | | | | | | | | | | | | | * gnu/services/linux.scm (rasdaemon-configuration, rasdaemon-configuration?, rasdaemon-configuration-record?, rasdaemon-service-type): New variables. * doc/guix.texi (Linux Services): Document it. Signed-off-by: Leo Famulari <leo@famulari.name>
* | services: guix-build-coordinator: Fix queue builds default config.Christopher Baines2021-04-23
| | | | | | | | | | | | | | | | Use the default client port rather than the default agent communication port for the queue builds script. * gnu/services/guix.scm (<guix-build-coordinator-queue-builds-configuration>): Change coordinator default.
* | services: guix-build-coordinator: Add max-1min-load-average option.Christopher Baines2021-04-23
| | | | | | | | | | | | | | | | | | | | | | To the agent configuration. * gnu/services/guix.scm (<guix-build-coordinator-agent-configuration>): New field, max-1min-load-average. (guix-build-coordinator-agent-configuration-max-1min-load-average): New procedure. (guix-build-coordinator-agent-shepherd-services): If set, include the max-1min-load-average in the agent arguments.
* | services: wireguard: Add keep-alive support.Guillaume Le Vaillant2021-04-20
| | | | | | | | | | | | * gnu/services/vpn.scm (<wireguard-peer>): Add 'keep-alive' field. (wireguard-configuration-file): Use it. * doc/guix.texi (VPN Services): Document it.
* | import: Remove Nix importer.Ludovic Courtès2021-04-20
|/ | | | | | | | | | | | | | | | This importer has suffered from bitrot and no longer works with current Nix and Nixpkgs. See <https://bugs.gnu.org/32339> and <https://bugs.gnu.org/36255>. * guix/import/snix.scm, guix/scripts/import/nix.scm, tests/snix.scm: Remove. * Makefile.am (MODULES, SCM_TESTS): Remove them. * guix/scripts/import.scm (importers): Remove "nix". * build-aux/test-env.in: Remove NIXPKGS variable. * configure.ac: Remove '--with-nixpkgs' option. * doc/guix.texi (Invoking guix import): Remove bit about "guix import nix". * etc/completion/fish/guix.fish: Likewise.
* git: Honor proxy settings when fetching submodules.Ludovic Courtès2021-04-14
| | | | | | | | Fixes <https://bugs.gnu.org/44593>. * guix/git.scm (update-submodules): Add #:fetch-options and honor it. (update-cached-checkout): Pass #:fetch-options to 'update-submodules'. * doc/guix.texi (Requirements): Adjust comment about Guile-Git.
* Revert "services: mysql: Add extra-environment as configuration option."Leo Prikler2021-04-14
| | | | | | This reverts commit f3626119d738f30b5ab59e76c105fd7b4c077ddc. This commit inadvertently broke a string freeze. Let's be nice to our translators and not do that.
* services: mysql: Add extra-environment as configuration option.methuselah-02021-04-13
| | | | | | | | * gnu/services/databases.scm (mysql-configuration): Add extra-environment (mysql-service): Use #:log-file and #:environment-variables * doc/guix.texi: Document it. Signed-off-by: Leo Prikler <leo.prikler@student.tugraz.at>
* services: postgresql: Change service default socket directory.Christopher Baines2021-04-12
| | | | | | | | | | | | | | | | | | | | | | | Fixes <https://bugs.gnu.org/46737>. PostgreSQL running with a different socket directory to the default one in the package itself breaks some services, this commit restores the previous behaviour where PostgreSQL by default will run with a socket directory that matches the default used by PostgreSQL packaged for Guix. Switching to a different default value can happen, but only alongside changing the PostgreSQL package. * gnu/services/databases.scm (<postgresql-config-file>)[socket-directory]: Change default to #false. * doc/guix.texi (Database Services): Update documentation, and specify a different value for disabling connections via sockets. * gnu/tests/guix.scm (%guix-data-service-os): Use default PostgreSQL behaviour. * gnu/tests/monitoring.scm (%zabbix-os): Likewise. * gnu/tests/web.scm (patchwork-os): Likewise. Signed-off-by: Leo Famulari <leo@famulari.name>
* doc: Document 'gnu-build-system' keyword parameters.Ludovic Courtès2021-04-12
| | | | | * doc/guix.texi (Build Systems): Document keyword parameters of 'gnu-build-system'.
* doc: Move list of build phases to "Build Phases".Ludovic Courtès2021-04-12
| | | | | | | | | Before this change, the 'gnu-build-system' phases were listed in the "Build Systems" section, and then summarized in the "Build Phases" section. This moves everything to "Build Phases". * doc/guix.texi (Build Systems): Move phase table to... (Build Phases): ... here. Rearrange surrounding text.
* services: Add ipfs-service-typeMaxime Devos2021-04-12
| | | | | | | | | | | | | * gnu/services/networking.scm (ipfs-service-type) (%ipfs-home-mapping, %ipfs-environment) (%ipfs-accounts, %ipfs-home): New variables. (ipfs-configuration, ipfs-configuration?) (ipfs-configuration-package, ipfs-configuration-gateway) (ipfs-configuration-api, ipfs-shepherd-service) (ipfs-binary, %ipfs-activation): New procedures. * doc/guix.texi (Networking Services): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: Support DELETE in MODIFY-SERVICES macro.Ricardo Wurmus2021-04-12
| | | | | | | * gnu/services.scm (%modify-service): Add clause for DELETE syntax. (modify-services): Use FILTER-MAP; adjust docstring. * doc/guix.texi (System Services): Mention alternative syntax. (X Window): Use MODIFY-SERVICES syntax.
* doc: Fix connect to the VM over SSH example.Oleg Pykhalov2021-04-11
| | | | | * doc/guix.texi (Running Guix in a VM): Add host which connect to in SSH connection example.
* doc: Fix typos.Tobias Geerinckx-Rice2021-04-10
| | | | | | | | | | * doc/guix.texi (SELinux Support): Fix typo. (Build Systems): Likewise. (DNS Services): Likewise. (Networking Services): Likewise. (Guix Services): Likewise. (Reduced Binary Seed Bootstrap): Likewise. (Documentation): Likewise.
* import: go: Append version to symbol name in the pinned version mode.Maxim Cournoyer2021-04-09
| | | | | | | | | | | | | | | | | | | This allows importing packages with complicated version specific dependency chains without the package symbol names colliding. * doc/guix.texi (Invoking guix import): Document the --pin-versions option. Mention that a specific version can be imported. Remove the experimental warning. * guix/import/go.scm (go-module->guix-package-name)[version]: Add optional argument. Rewrite the character translation in terms of string-map. (go-module->guix-package): Conditionally use dependencies whose symbol include their version, based no the value of the PIN-VERSIONS? argument. * guix/import/utils.scm (package->definition): Add a new case where the full version string is appended to the package symbol. * guix/scripts/import.scm (guix-import): Correctly print forms starting with '(define-public [...]'. * guix/scripts/import/go.scm (guix-import-go): Conditionally include the version in the package symbols defined.
* doc: Quote a URL to avoid misinterpretation by the shell.Leo Famulari2021-04-09
| | | | | | | | | Otherwise, the shell tries to perform pattern-matching based on the "?" character. Reported by nij in #guix. * doc/guix.texi (Binary Installation): Add quotes around OPENPGP-SIGNING-KEY-URL.
* services: Add Laminar.Christopher Baines2021-04-09
| | | | | | * gnu/services/ci.scm: New file. * gnu/tests/ci.scm: New file. * doc/guix.texi (Laminar): Document the Laminar service.
* gnu-maintenance: Add 'sourceforge' updater.Ludovic Courtès2021-04-06
| | | | | | | | This updater currently covers 2.4% of the packages. * guix/gnu-maintenance.scm (latest-sourceforge-release): New procedure. (%sourceforge-updater): New variable. * doc/guix.texi (Invoking guix refresh): Document it.
* doc: Use the shell dollar substitution.zimoun2021-04-05
| | | | | | | | See: https://unix.stackexchange.com/questions/126927/have-backticks-i-e-cmd-in-sh-shells-been-deprecated * doc/guix.texi: Replace the shell backquote deprecated substitution by the dollar one.
* doc: Reorder "Channels with Substitutes".zimoun2021-04-05
| | | | | | | Ordering consistency introduced by 12871cc8db701a89f7f64303e1f16a8537a12561. * doc/guix.texi (Channels): Move section "Channels with Substitutes". Update the master menu.
* services: guix-publish: Add zstd compression by default.Ludovic Courtès2021-04-03
| | | | | | | | | | | That way, the default config with (advertises? #t) and without a cache will offer zstd-compressed substitutes, which should lead to much higher throughput than gzip. * gnu/services/base.scm (default-compression): When 'guix-publish-configuration-cache' returns true, use higher level compression ratios. Add "zstd". * doc/guix.texi (Base Services): Mention zstd.
* doc: Fix typo.Xinglu Chen2021-04-01
| | | | | | * doc/guix.texi (Inferiors): Use past tense. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Discourage ambiguous package names.Tobias Geerinckx-Rice via Bug reports for GNU Guix2021-04-01
| | | | | * doc/contributing.texi (Package Naming): Explicitly mention single-character and otherwise ambiguous names.
* services: kmscon: Add font-engine and font-size fields.qblade2021-04-01
| | | | | | | * gnu/services/base.scm (<kmscon-configuration>): Add font-engine and font-size fields. (kmscon-service-type): Honor them. * doc/guix.texi (Base Services): Document them.
* doc: Fix a typo in the Julia build system section.Leo Famulari2021-03-31
| | | | * doc/guix.texi (julia-build-system): Fix typo.
* status: Don't display download URLs for '--verbosity=1'.Ludovic Courtès2021-03-31
| | | | | | | | | | | | | With this change, each substitute occupies a single line of output (instead of two) when using '-v1', the default for 'guix package' & co. * guix/status.scm (print-build-event): Add #:print-urls? and honor it. (print-build-event/quiet): Pass #:print-urls? #f. (print-build-event/quiet-with-urls): New procedure. (logger-for-level): Add case for LEVEL 2. * doc/guix.texi (Common Build Options): Adjust '--verbosity' documentation.