summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* services: connman: Add iwd backend support.Declan Tsien2023-01-16
| | | | | | | | | * gnu/services/networking.scm (connman-configuration)[iwd?]: New field. (connman-shepherd-service): Add iwd? logic, remove wpa-supplicant requirement. * doc/guix.texi: Add information about connman-configuration iwd? option. Co-authored-by: Andrew Tropin <andrew@trop.in> Signed-off-by: Andrew Tropin <andrew@trop.in>
* doc: Fix erroneous copyright line.Maxim Cournoyer2023-01-16
| | | | * doc/guix.texi: Fix copyright line for Antero Mejr.
* scripts: repl: Add -i, --interactive flag.Antero Mejr2023-01-16
| | | | | | | | * guix/scripts/repl.scm (%options): Add -i, --interactive flag. (guix-repl): Honor -i, --interactive flag. * doc/guix.texi (Invoking guix repl): Add documentation for -i, --interactive. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
* scripts: repl: Add --list-types flag.Antero Mejr2023-01-16
| | | | | | | * guix/scripts/repl.scm (%options): Add --list-types. * doc/guix.texi (Invoking guix repl): Add documentation for --list-types. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
* transformations: Add '--with-version'.Ludovic Courtès2023-01-16
| | | | | | | | | | | | | | | This is a followup to 8aeccc6240ec45f0bc7bed655e0c8149ae4253eb. * guix/transformations.scm (package-with-upstream-version): New procedure. (transform-package-latest)[package-with-latest-upstream]: Remove. Use 'package-with-upstream-version' instead. (transform-package-version): New procedure. (%transformations, %transformation-options) (show-transformation-options-help/detailed): Add '-with-version'. * tests/transformations.scm ("options->transformation, with-version"): New test. * doc/guix.texi (Package Transformation Options): Document '--with-version'. (Defining Package Variants): Mention it.
* services: greetd: Add 'source-profile?' configuration field.Jelle Licht2023-01-15
| | | | | | | | * gnu/services/base.scm (<greetd-terminal-configuration>)[source-profile?]: New field. (make-greetd-terminal-configuration-file): Serialize new field to configuration file. * doc/guix.texi (Base Services): Document it.
* gnu: services: Add joycond-service.David Thompson2023-01-14
| | | | | | | * gnu/services/games.scm (joycond-configuration): New configuration type. (joycond-shepherd-service): New procedure. (joycond-service-type): New variable. * doc/guix.texi (Game Services): Document it.
* doc: Clarify how to use the #:go key of go-build-system.Leo Famulari2023-01-11
| | | | | | This is a followup to commit 9ec62d1b9c55104f9ab81b95d82988c627a23415. * doc/guix.texi (Build Systems): Clarify the '#:go' key.
* doc: Document the #:go key of the Go build system.Leo Famulari2023-01-11
| | | | * doc/guix.texi (Build Systems): Document '#:go'.
* doc: contributing: Note '-v REVISION' bug in 'git send-email'.(2023-01-11
| | | | | | | | * doc/contributing.texi ("Submitting Patches")["Sending a Patch Series"]: Note that a bug in 'git send-email' means '-v REVISION' (with a space) will not work. Signed-off-by: Christopher Baines <mail@cbaines.net>
* doc: contributing: Tweak the Commit Policy.Christopher Baines2023-01-11
| | | | | | | | | | | | | | | | | | | | | | | Add more examples of when it can be appropriate to push changes without review, as I think this can be appropriate in the case of trivial changes (as mentioned before), but also non-trivial fixes. No longer suggest pushing simple new packages or package upgrades (that don't cause lots of rebuilds) without sending to guix-patches. Now there's some automation for testing changes sent to guix-patches, sending changes there before pushing can mean that more rigorous testing takes place and help speed up substitutes becoming available. This is true, even if no human review takes place. Only suggest waiting one week for review for simpler changes, wait two weeks for more significant changes. Also, reorder some of the information in this section so it's grouped together better. * doc/contributing.texi (Commit Policy): Tweak. Signed-off-by: Christopher Baines <mail@cbaines.net>
* doc: Fix documentation typo.jgart2023-01-10
| | | | | | * doc/guix.texi (VNC Services): Fix typo. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
* services: unattended-upgrade: Add 'operating-system-expression' field.Giacomo Leidi2023-01-10
| | | | | | | | | * gnu/services/admin.scm (<unattended-upgrade-configuration>) [operating-system-expression]: New field. (unattended-upgrade-mcron-jobs): Honor it. * doc/guix.texi (Unattended Upgrades): Document it. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* services: git-daemon: Deprecate 'git-daemon-service' procedure.Bruno Victal2023-01-10
| | | | | | | | | * 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>
* doc: Fix <openntpd-configuration> openntpd default.Tobias Geerinckx-Rice2023-01-08
| | | | | | * doc/guix.texi (Networking Services): <openntpd-configuration>'s openntpd field takes a package: it does not default to a FILE-APPEND call.
* doc: cookbook: Add "Installing Guix on a Cluster" chapter.Ludovic Courtès2023-01-09
| | | | | | | | This is derived from the article at <https://hpc.guix.info/blog/2017/11/installing-guix-on-a-cluster/>, with clarifications and updates. * doc/guix-cookbook.texi (Installing Guix on a Cluster): New chapter.
* services: base: Add environment support to guix-configuration.Mathieu Othacehe2023-01-09
| | | | | | * gnu/services/base.scm (<guix-configuration>)[extra-env]: New field. (guix-shepherd-service): Honor it. * doc/guix.texi (Base Services): Document it.
* Revert "services: base: Add extra-env support to guix-configuration."Mathieu Othacehe2023-01-07
| | | | | This reverts commit 78a9b4f996ba18b4460ba380b87e9538007c27e0. It was pushed by error, while not reviewed yet.
* services: base: Add extra-env support to guix-configuration.Mathieu Othacehe2023-01-07
| | | | | | * gnu/services/base.scm (<guix-configuration>)[extra-env]: New field. (guix-shepherd-service): Honor it. * doc/guix.texi (Base Services): Document it.
* doc: cookbook: Remove 404 link to mitpress.mit.edu.Ludovic Courtès2023-01-06
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Remove 404 link to mitpress.mit.edu.
* doc: Introduce using swap space for hibernation, with examples.Ivan Vilata-i-Balaguer2023-01-05
| | | | | | | | | | * doc/guix.texi (Swap Space): Add a concise introduction to hibernation and specifying a swap space to the kernel to make resume work. Mention space requirements and the need of an offset for swap files. Include a trivial example on how to set up a mapped swap volume for hibernation and another one for a swap file, including how to compute the file offset. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* home: services: environment-variables: Add support for literal strings.Ludovic Courtès2023-01-05
| | | | | | | | | * gnu/home/services.scm (<literal-string>): New record type. (environment-variable-shell-definitions): Split 'shell-quote' into 'quote-string' and 'shell-double-quote'. Add 'shell-single-quote'. Add clause for 'literal-string' records. * tests/guix-home.sh: Test it. * doc/guix.texi (Essential Home Services): Document it.
* doc: Fix broken link for go-build-system.Bruno Victal2023-01-03
| | | | | | * doc/guix.texi (Build Systems): Fix broken link for go-build-system. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
* import/cran: Allow custom license prefix.Lars-Dominik Braun2022-12-31
| | | | | | | | | | | | * guix/import/cran.scm (string-licenses): Add license-prefix argument. (string->license): Ditto. (description->package): Ditto. (cran->guix-package): Ditto. (cran-recursive-import): Ditto. * guix/scripts/import/cran.scm (%options): Add new option -p/--license-prefix. (show-help): Document it. (parse-options): Pass it to importer. * doc/guix.texi (Invoking guix import): Document it.
* doc: Give example of when to use describe in .guix-channel file.Karl Hallsby2022-12-29
| | | | | | | * doc/guix.texi (Package Modules in a Sub-directory): Mention "guix deploy" files as an example. Signed-off-by: Ricardo Wurmus <rekado@elephly.net>
* doc: Describe format of channel that uses directory field.Karl Hallsby2022-12-29
| | | | | * doc/guix.texi (Package Modules in a Sub-directory): Explain that directory must be the module root.
* doc: Update expired URL.Marius Bakke2022-12-28
| | | | * doc/guix.texi (DNS Services): Update knot-resolver documentation link.
* doc: Describe how to update to a specific version.Hartmut Goebel2022-12-26
| | | | | * doc/guix.texi (Invoking guix refresh): Describe how to update to a specific version.
* gnu: services: Fix bluetooth-service docstring.Ivan Vilata i Balaguer2022-12-26
| | | | | | | | * gnu/services/desktop.scm (bluetooth-service): Sync docstring with info, remove mention to group not really needed to access D-Bus service. * doc/guix.texi (Desktop Services): Also remove mention to group here. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: wireguard: Allow specifying pre-shared keys.Timo Wilken2022-12-25
| | | | | | | * gnu/services/vpn.scm (<wireguard-peer>)[preshared-key]: New field. * doc/guix.texi (VPN Services): Document it. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
* doc: Fix typo.Tobias Geerinckx-Rice2022-12-18
| | | | | | | * doc/contributing.texi (Sending a Patch Series): Fix e-mail address of <guix-patches@gnu.org>. Reported by Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>.
* doc: Wrap $localstatedir in Texinfo syntax.Ricardo Wurmus2022-12-23
| | | | * doc/guix.texi (Limitations): Use @file syntax.
* doc: Suggest remounting store before relabeling the file system.Ricardo Wurmus2022-12-23
| | | | | * doc/guix.texi (Installing the SELinux policy): Mention that the store may need to be remounted before writing to it.
* services: opensmtpd: Add 'shepherd-requirement' field.Bruno Victal2022-12-20
| | | | | | | | | * gnu/services/mail.scm (<opensmtpd-configuration>)[shepherd-requirement]: New field. (opensmtpd-shepherd-service): Honor it. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Avoid 'match' on the <udev-configuration> record.Ludovic Courtès2022-12-20
| | | | | | | | Fixes <https://issues.guix.gnu.org/59907>. Reported by MANCINI Raffael <Raffael.MANCINI@mnhn.lu>. * doc/guix.texi (Service Types and Services): Change 'udev-configuration' example to avoid 'match'.
* Merge branch 'version-1.4.0'Ludovic Courtès2022-12-19
|\
| * doc: Update URLs for the manual and cookbook translations.v1.4.0Ludovic Courtès2022-12-18
| | | | | | | | * doc/htmlxref.cnf: Update URLs for "guix" and "guix-cookbook".
| * doc: Add guile-netlink to 'htmlxref.cnf'.Ludovic Courtès2022-12-18
| | | | | | | | * doc/htmlxref.cnf: Add guile-netlink.
| * doc: Use VM image file name consistently.Ludovic Courtès2022-12-15
| | | | | | | | | | | | | | | | | | | | | | Previously, what "/tmp/qemu-image" refers to could be unclear at first. * doc/guix.texi (Running Guix in a VM): Use the original image file name instead of /tmp/qemu-image. * po/doc/guix-manual.de.po, po/doc/guix-manual.es.po, po/doc/guix-manual.fr.po, po/doc/guix-manual.pt_BR.po, po/doc/guix-manual.ru.po, po/doc/guix-manual.zh_CN.po: Adjust accordingly.
| * doc: Fix formatting for 'computed-file'.Bruno Victal2022-12-14
| | | | | | | | | | | | * doc/guix.texi (G-Expressions): Fix formatting for 'computed-file'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
| * doc: Verify the release with my own OpenPGP key.Ludovic Courtès2022-12-14
| | | | | | | | | | * doc/guix.texi (OPENPGP-SIGNING-KEY-ID, OPENPGP-SIGNING-KEY-URL): Switch to my key.
| * doc: Recommend 'match-record'.Ludovic Courtès2022-12-08
| | | | | | | | | | * doc/contributing.texi (Data Types and Pattern Matching): Recommend 'match-record'.
* | doc: Tweak cross-ref Texinfo command.Ludovic Courtès2022-12-18
| | | | | | | | | | * doc/guix.texi (Swap Space): Use @pxref instead of @xref at the end of a sentence.
* | services: ganeti: Add support for cluster hooks.Marius Bakke2022-12-17
| | | | | | | | | | | | | | | | | | | | * gnu/services/ganeti.scm (<ganeti-configuration>): Add HOOKS. (hooks->directory): Rename to ... (debootstrap-hooks->directory): ... this, for clarity. (debootstrap-configuration-compiler): Adjust accordingly. (ganeti-directory): Add HOOKS when set. (ganeti-etc-service): Pass HOOKS. * doc/guix.texi (Virtualization Services): Mention it.
* | gnu: slapd-configuration: Update default for run-dir.Ricardo Wurmus2022-12-14
| | | | | | | | | | | | * gnu/services/ldap.scm (slapd-configuration): Update default value for run-dir to match defaults of 389-ds-base package. * doc/guix.texi: Update documentation.
* | gnu: Add directory-server-service-type.Ricardo Wurmus2022-12-14
| | | | | | | | | | | | * gnu/services/ldap.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (LDAP Services): Document it.
* | doc: Fix formatting for 'computed-file'.Bruno Victal2022-12-14
| | | | | | | | | | | | * doc/guix.texi (G-Expressions): Fix formatting for 'computed-file'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | services: nix: Add more configuration fields.Petr Hodina2022-12-13
| | | | | | | | | | | | | | | | * gnu/services/nix.scm (<nix-configuration>)[build-directory]: New field. (nix-service-etc, nix-shepherd-service): Take them into account. * doc/guix.texi (Nix): Update it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | doc: Replace reference to Freenode.Ludovic Courtès2022-12-08
| | | | | | | | | | * doc/guix.texi (Reduced Binary Seed Bootstrap): Libera.Chat, not Freenode.
* | services: zabbix: Don't write user to configuration file.Marius Bakke2022-12-07
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The service already runs with the specified user and group, so there is no use in writing it to the configuration files. This change is mainly done for compatibility with 'zabbix-agent2' which does not understand the User= setting, but also to document the correct data type for the "group" setting. * gnu/services/monitoring.scm (serialize-string): Filter USER and GROUP fields. (group?, serialize-group): Remove variables. (zabbix-server-configuration, zabbix-agent-configuration): Document the GROUP field as 'string'. * doc/guix.texi (Monitoring Services): Adjust accordingly.