summaryrefslogtreecommitdiff
path: root/doc/guix.texi
AgeCommit message (Expand)Author
2023-01-20doc: Fix Xvnc service example....Reported by bost on #guix (thank you!) * doc/guix.texi (VNC Services): Add the missing host argument in the SSH command example. Maxim Cournoyer
2023-01-18doc: Fix typo....* doc/guix.texi (Cross-Compilation): Replace "penaly" with "penalty". Replace "few users" with "fewer users". Maxim Cournoyer
2023-01-17doc: Use the right cross-reference command....* doc/guix.texi (Package Transformation Options): Use @pxref, not @ref. Ludovic Courtès
2023-01-16services: connman: Add iwd backend support....* 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> Declan Tsien
2023-01-16doc: Fix erroneous copyright line....* doc/guix.texi: Fix copyright line for Antero Mejr. Maxim Cournoyer
2023-01-16scripts: repl: Add -i, --interactive flag....* 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> Antero Mejr
2023-01-16scripts: repl: Add --list-types flag....* 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> Antero Mejr
2023-01-16transformations: Add '--with-version'....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. Ludovic Courtès
2023-01-15services: greetd: Add 'source-profile?' configuration field....* 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. Jelle Licht
2023-01-14gnu: services: Add joycond-service....* 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. David Thompson
2023-01-11doc: Clarify how to use the #:go key of go-build-system....This is a followup to commit 9ec62d1b9c55104f9ab81b95d82988c627a23415. * doc/guix.texi (Build Systems): Clarify the '#:go' key. Leo Famulari
2023-01-11doc: Document the #:go key of the Go build system....* doc/guix.texi (Build Systems): Document '#:go'. Leo Famulari
2023-01-10doc: Fix documentation typo....* doc/guix.texi (VNC Services): Fix typo. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> jgart
2023-01-10services: unattended-upgrade: Add 'operating-system-expression' field....* 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> Giacomo Leidi
2023-01-10services: git-daemon: Deprecate 'git-daemon-service' procedure....* 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> Bruno Victal
2023-01-08doc: Fix <openntpd-configuration> openntpd default....* doc/guix.texi (Networking Services): <openntpd-configuration>'s openntpd field takes a package: it does not default to a FILE-APPEND call. Tobias Geerinckx-Rice
2023-01-09services: base: Add environment support to guix-configuration....* gnu/services/base.scm (<guix-configuration>)[extra-env]: New field. (guix-shepherd-service): Honor it. * doc/guix.texi (Base Services): Document it. Mathieu Othacehe
2023-01-07Revert "services: base: Add extra-env support to guix-configuration."...This reverts commit 78a9b4f996ba18b4460ba380b87e9538007c27e0. It was pushed by error, while not reviewed yet. Mathieu Othacehe
2023-01-07services: base: Add extra-env support to guix-configuration....* gnu/services/base.scm (<guix-configuration>)[extra-env]: New field. (guix-shepherd-service): Honor it. * doc/guix.texi (Base Services): Document it. Mathieu Othacehe
2023-01-05doc: Introduce using swap space for hibernation, with examples....* 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> Ivan Vilata-i-Balaguer
2023-01-05home: services: environment-variables: Add support for literal strings....* 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. Ludovic Courtès
2023-01-03doc: Fix broken link for go-build-system....* doc/guix.texi (Build Systems): Fix broken link for go-build-system. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Bruno Victal
2022-12-31import/cran: Allow custom license prefix....* 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. Lars-Dominik Braun
2022-12-29doc: Give example of when to use describe in .guix-channel file....* doc/guix.texi (Package Modules in a Sub-directory): Mention "guix deploy" files as an example. Signed-off-by: Ricardo Wurmus <rekado@elephly.net> Karl Hallsby
2022-12-29doc: Describe format of channel that uses directory field....* doc/guix.texi (Package Modules in a Sub-directory): Explain that directory must be the module root. Karl Hallsby
2022-12-28doc: Update expired URL....* doc/guix.texi (DNS Services): Update knot-resolver documentation link. Marius Bakke
2022-12-26doc: Describe how to update to a specific version....* doc/guix.texi (Invoking guix refresh): Describe how to update to a specific version. Hartmut Goebel
2022-12-26gnu: services: Fix bluetooth-service docstring....* 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> Ivan Vilata i Balaguer
2022-12-25services: wireguard: Allow specifying pre-shared keys....* 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> Timo Wilken
2022-12-23doc: Wrap $localstatedir in Texinfo syntax....* doc/guix.texi (Limitations): Use @file syntax. Ricardo Wurmus
2022-12-23doc: Suggest remounting store before relabeling the file system....* doc/guix.texi (Installing the SELinux policy): Mention that the store may need to be remounted before writing to it. Ricardo Wurmus
2022-12-20services: opensmtpd: Add 'shepherd-requirement' field....* 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> Bruno Victal
2022-12-20doc: Avoid 'match' on the <udev-configuration> record....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'. Ludovic Courtès
2022-12-19Merge branch 'version-1.4.0'Ludovic Courtès
2022-12-18doc: Tweak cross-ref Texinfo command....* doc/guix.texi (Swap Space): Use @pxref instead of @xref at the end of a sentence. Ludovic Courtès
2022-12-15doc: Use VM image file name consistently....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. Ludovic Courtès
2022-12-14doc: Fix formatting for 'computed-file'....* doc/guix.texi (G-Expressions): Fix formatting for 'computed-file'. Signed-off-by: Ludovic Courtès <ludo@gnu.org> Bruno Victal
2022-12-14doc: Verify the release with my own OpenPGP key....* doc/guix.texi (OPENPGP-SIGNING-KEY-ID, OPENPGP-SIGNING-KEY-URL): Switch to my key. Ludovic Courtès
2022-12-17services: ganeti: Add support for cluster hooks....* 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. Marius Bakke
2022-12-14gnu: slapd-configuration: Update default for run-dir....* 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. Ricardo Wurmus
2022-12-14gnu: Add directory-server-service-type....* gnu/services/ldap.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (LDAP Services): Document it. Ricardo Wurmus
2022-12-14doc: Fix formatting for 'computed-file'....* doc/guix.texi (G-Expressions): Fix formatting for 'computed-file'. Signed-off-by: Ludovic Courtès <ludo@gnu.org> Bruno Victal
2022-12-13services: nix: Add more configuration fields....* 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> Petr Hodina
2022-12-08doc: Replace reference to Freenode....* doc/guix.texi (Reduced Binary Seed Bootstrap): Libera.Chat, not Freenode. Ludovic Courtès
2022-12-07services: zabbix: Don't write user to configuration file....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. Marius Bakke
2022-12-01gnu: bootloader: Rework chaining, add grub-efi-netboot-removable-bootloader....This rework allows to use an (efi-bootloader-chain) like this, which is able to boot over network or local storage, depending on whether the bootloader target has support for symbolic links: (operating-system (bootloader (bootloader-configuration (bootloader (efi-bootloader-chain grub-efi-netboot-removable-bootloader #:packages (list my-firmware-package my-u-boot-package) #:files (list (plain-file "config.txt" "kernel=u-boot.bin")) #:hooks my-special-bootloader-profile-manipulator)) (targets '("/booti/efi")) …)) …) * doc/guix.texi (Bootloader Configuration): Describe the new ‘grub-efi-netboot-removable-bootloader’. Mention the file names used and that the UEFI Boot Manager is not modified. Advise to disable write-access over TFTP. * gnu/bootloader.scm (efi-bootloader-profile): Allow a list of packages and collect everything directly in the profile, avoiding a separate collection directory. Renamed the profile from "bootloader-profile" to "efi-bootloader-profile". [bootloader-collection]: Rename to... [efi-bootloader-profile-hook]: ... this and remove unused modules. Do not create the now extraneous collection directory. (efi-bootloader-chain): Add PACKAGES and DISK-IMAGE-INSTALLER arguments. Remove handling of the collection directory, now only calling the given installer procedure. * gnu/bootloader/grub.scm (make-grub-efi-netboot-installer): New helper. (make-grub-configuration): New helper based on (grub-configuration-file). Add a GRUB argument, fix indentation, remove previous code retrieving GRUB from CONFIG. (grub-configuration-file): Make use of make-grub-configuration. (grub-efi-configuration-file): New procedure. (grub-cfg): New variable to replace "/boot/grub/grub.cfg". (install-grub-efi-netboot): Remove, splitting logic to... (make-grub-efi-netboot-installer): ... this new helper procedure, as well as to make-grub-efi-netboot, added below. (grub-bootloader): Adjust to use the GRUB-CFG. (grub-efi-bootloader): Likewise. Removed inheritance and declare all fields explicitly. (make-grub-efi-netboot-bootloader): New procedure. (grub-efi-netboot-bootloader): Use it. (grub-efi-netboot-removable-bootloader): New variable. * gnu/packages/bootloaders.scm (make-grub-efi-netboot): New procedure. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Modified-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Stefan
2022-12-01services: network-manager: Add iwd backend support....* gnu/services/networking.scm (network-manager-configuration)[iwd?]: New field. (network-manager-shepherd-service): Add iwd to requirements if needed. * doc/guix.texi: Add information about iwd? option. Andrew Tropin
2022-11-29doc: Remove unimplemented 'herd rules udev'....Since this text was added, the rules.d directory is now exposed straightforwardly via the standard /etc/udev/rules.d directory, so there's no need for a special 'rules' service action to print that directory. * doc/guix.texi (Base Services): Remove the paragraph documenting the nonexistent 'herd rules udev' command. Maxim Cournoyer
2022-11-28doc: Recommend avoiding execl, execle or execlp in mcron job specifications....* doc/guix.texi (Scheduled Job Execution): Adjust the 'updatedb' example and add a new tip. Maxim Cournoyer
2022-11-20doc: Note that ‘guix package’ accepts file names....* doc/guix.texi (Package Management)[Invoking guix package]: Mention support for operating on store file names. Co-authored-by: Tobias Geerinckx-Rice <me@tobias.gr> Tobias Geerinckx-Rice