summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)Author
2020-11-18gnu: vpn: Make ca, key and cert optional.Julien Lepiller
* gnu/services/vpn.scm (openvpn-client-configuration) (openvpn-server-configuration): Make ca, key an cert fields optional. * doc/guix.texi (VPN Services): Document the change.
2020-11-18services: cups: Add some extensions by default.Danny Milosavljevic
* gnu/services/cups.scm (cups-configuration): Add some extensions by default. doc/guix.texi (Printing Services): Document the default value.
2020-11-17doc: Add a backslash escape to the disk-image example.Maxim Cournoyer
* doc/guix.texi (Invoking guix system): Add a backslash escape.
2020-11-17Merge remote-tracking branch 'origin/version-1.2.0' into masterMaxim Cournoyer
Conflicts: gnu/packages/bioinformatics.scm The python-pysam package fixed in master was kept instead of the update done in the version-1.2.0 branch.
2020-11-17guix: system: Make disk-image root file system non-volatile by default.Maxim Cournoyer
And add a new '--volatile' option to have it volatile otherwise. * guix/scripts/system.scm (%options)[volatile-root?]: New boolean option. (%default-options): Set its default value to #f. (show-help): Add help doc. * guix/scripts/system.scm (perform-action): Propagate option... (system-derivation-for-action): ...here. Use it to set the volatile-root? field of the image object passed to SYSTEM-IMAGE. * doc/guix.texi (Invoking guix system): Document it.
2020-11-17doc: Detail which bootloader get used with disk-image or vm-image.Maxim Cournoyer
* doc/guix.texi (Invoking guix system): Extend doc.
2020-11-15Merge branch 'master' into stagingMarius Bakke
2020-11-15doc: Add a note about SELinux relabeling after upgrades to guix-daemon.Daniel Brooks
* doc/guix.texi (SELinux Support): Add note about upgrades. Signed-off-by: Marius Bakke <marius@gnu.org>
2020-11-14doc: Remove superfluous comma.Matthew Kraai
* doc/guix.texi (Managing Software the Guix Way): Remove comma. Signed-off-by: Leo Famulari <leo@famulari.name>
2020-11-14doc: Document hg-fetch.Holger Peters
* doc/guix.texi (origin Reference): Add documentation for hg-fetch. Signed-off-by: Christopher Baines <mail@cbaines.net>
2020-11-14doc: Fix Guix Build Coordinator agent configuration defaults.Christopher Baines
* doc/guix.texi (Guix Build Coordinator): Fix some guix-build-coordinator-agent-configuration defaults.
2020-11-12maint: update-guix-package: Optionally add sources to store.Maxim Cournoyer
Following discussions in <https://issues.guix.gnu.org/43893>, keeping a copy of the updated package source is desirable when generating a release. * build-aux/update-guix-package.scm (version-controlled?): Remove variable. (call-with-temporary-git-worktree): Renamed from 'with-temporary-git-worktree'. Update doc. Do not change directory implicitly. Define as a procedure, not a syntax. (keep-source-in-store): New procedure. (main): Adjust to use with call-with-temporary-git-worktree. Add the sources to the store when GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT is set. Exit gracefully when FIND-ORIGIN-REMOTE returns #f. (%savannah-guix-git-repo-push-url-regexp): Adjust match for a potential colon separator. * Makefile.am (GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT): Adjust. * .dir-locals.el (scheme-mode): Remove entry for with-temporary-git-worktree. * doc/contributing.texi (Updating the Guix Package): Update doc. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2020-11-11gnu: mingetty-shepherd-service: Make 'clear-on-logout' configurable.Mark H Weaver
Also change the default configuration to clear on logout, which is the upstream default. * gnu/services/base.scm (<mingetty-configuration>): Add 'clear-on-logout?' field. (mingetty-shepherd-service): Pass the "--noclear" option to mingetty only if 'clear-on-logout?' is #false. * doc/guix.texi (Base Services): Document the 'clear-on-logout?' field.
2020-11-07Merge branch 'master' into stagingMarius Bakke
Conflicts: gnu/local.mk gnu/packages/gdb.scm gnu/packages/lisp-xyz.scm gnu/packages/web-browsers.scm
2020-11-07doc: Fix Zabbix ‘db-secret-file’ documentation.Tobias Geerinckx-Rice
* doc/guix.texi (Monitoring Services): Clarify ‘db-secret-file’'s (lack of) structure and gexp support.
2020-11-05services: Add yggdrasil-service-type.raingloom
* gnu/services/networking.scm (yggdrasil-configuration) (yggdrasil-configuration?, yggdrasil-configuration-package) (yggdrasil-configuration-auto-conf, yggdrasil-configuration-log-level) (yggdrasil-configuration-log-to): New procedures. (yggdrasil-service-type): New variable. * doc/guix.texi: Document it. * gnu/system/examples/yggdrasil.tmpl: Provide example. Signed-off-by: Julien Lepiller <julien@lepiller.eu>
2020-11-03doc: Illustrate procedures that return packages.Ludovic Courtès
* doc/guix.texi (Defining Package Variants): Illustrate procedures that return packages.
2020-11-03doc: Use '@lisp' for 'options->transformation' example.Ludovic Courtès
* doc/guix.texi (Defining Package Variants): Use @lisp for 'options->transformation' example.
2020-11-02doc: Fix typo.Miguel Ángel Arruga Vivas
* doc/guix.texi (Invoking guix publish)<cache-bypass-threshold>: The unit suffixes the numeric value.
2020-11-02doc: Complete sentence in earlyoom-configuration doc.Maxim Cournoyer
* doc/guix.texi (Linux Services): Complete sentence in earlyoom-configuration doc. Reported-by: Julien Lepiller <julien@lepiller.eu>
2020-11-01doc: Fix typo.Julien Lepiller
* doc/guix.texi (DNS Services): Fix typo.
2020-11-01doc: Fix typo.Julien Lepiller
* doc/guix.texi (Sound Services): Fix typo.
2020-11-01doc: Add missing period at the end of the sentence.Miguel Ángel Arruga Vivas
2020-10-31doc: Add "Defining Package Variants" section.Ludovic Courtès
* doc/guix.texi (Defining Packages): Move documentation of 'package-input-rewriting' & co. to... (Defining Package Variants): ... here. New node. Also document 'inherit' and 'options->transformation'.
2020-10-30services: guix-publish: Add 'cache-bypass-threshold' field.Ludovic Courtès
This is a followup to ecaa102a58ad3ab0b42e04a3d10d7c761c05ec98. * gnu/services/base.scm (<guix-publish-configuration>)[cache-bypass-threshold]: New field. (guix-publish-shepherd-service): Honor it.
2020-10-30services: swap: Allow for UUIDs and file system labels.Ludovic Courtès
* gnu/services/base.scm (swap-service-type)[device-lookup, device-name]: New variables. Add 'modules' field to 'shepherd-service'. In 'start' and 'stop', use 'device-lookup' to resolve UUIDs and labels. * doc/guix.texi (operating-system Reference): Adjust accordingly.
2020-10-30scripts: lint: Add '--exclude' option.zimoun
* guix/scripts/lint.scm (%options, parse-options): Add '--exclude' option. (option-checker): New helper function. * doc/guix.texi (Invoking guix lint): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-10-30scripts: lint: Fix '--no-network' option.zimoun
* guix/scripts/lint.scm: (show-help): Add '--no-network' option message. (%options, parse-options): Fix argument order. * doc/guix.texi (Invoking guix lint): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-10-28doc: Fix claimed archive timestamps.Tobias Geerinckx-Rice
Reported by Leo Famulari <leo@famulari.name>. * doc/guix.texi (Binary Installation): Use a correct timestamp of 1 instead of an incorrect one of 0.
2020-10-28publish: Add '--cache-bypass-threshold'.Ludovic Courtès
* guix/scripts/publish.scm (show-help, %options): Add '--cache-bypass-threshold'. (low-compression): New procedure. (cache-bypass-threshold): New parameter. (bypass-cache?): New procedure. (render-narinfo/cached): Call 'render-narinfo' when 'bypass-cache?' returns true. (render-nar/cached): Call 'render-nar' when 'bypass-cache?' returns true. (guix-publish): Parameterize 'cache-bypass-threshold'. * tests/publish.scm ("with cache", "with cache, lzip + gzip") ("with cache, uncompressed"): Pass '--cache-bypass-threshold=0'. ("with cache, vanishing item"): Expect 200 for RESPONSE. ("with cache, cache bypass"): New test.
2020-10-28doc: Update the PostgreSQL extension packages example.Christopher Baines
* doc/guix.texi (PostgreSQL): Update the extension packages example.
2020-10-28doc: Use @code rather than @var for data type items.Christopher Baines
In the couple of cases where it's inconsistent. * doc/guix.texi (PostgreSQL, Sound Services): Replace @var with @code within data type sections.
2020-10-27doc: Fix various minor typos.Lulu
* doc/guix.texi (Top): Add end of line period to menu entry in the node listing. (Invoking guix time-machine): Remove duplicate word. (Invoking guix environment): As above. (PAM Mount Service): As above. (Running Guix in a Virtual Machine): Remove erroneous hyphen and duplicate word. Signed-off-by: Leo Famulari <leo@famulari.name>
2020-10-27services: Add gmnisrv web service.Alexandru-Sergiu Marton
* gnu/services/web.scm (<gmnisrv-configuration>): New record type. (%default-gmnisrv-config-file): New variable. (%gmnisrv-accounts, %gmnisrv-activation): New variables. (gmnisrv-shepherd-service): New procedure. (gmnisrv-service-type): New variable. * doc/guix.texi (Web Services): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-10-27doc: Fix xref translation macro.Ludovic Courtès
* doc/local.mk (xref_command): Wrap loop body in 'if [ -n "$$e" ]'. This avoids shell syntax errors when producing doc/guix-cookbook.de.texi, which for some reason gets an empty 'e' at one point. Quote the first argument to 'head'.
2020-10-25doc: Document the postgresql-config-file.Christopher Baines
* doc/guix.texi (PostgreSQL): Document the postgresql-config-file record.
2020-10-25doc: Add "Getting Substitutes from Other Servers" section.Ludovic Courtès
* doc/guix.texi (Getting Substitutes from Other Servers): New node. (Invoking guix-daemon): Add cross-reference. (Substitute Server Authorization): Clarify that this is unnecessary on Guix System. (Invoking guix publish): Add cross-reference.
2020-10-25services: guix: Make /etc/guix/acl really declarative by default.Ludovic Courtès
Fixes <https://bugs.gnu.org/39819>. Reported by Maxim Cournoyer <maxim.cournoyer@gmail.com>. * gnu/services/base.scm (substitute-key-authorization): Symlink DEFAULT-ACL to /etc/guix/acl unconditionally. Add code to optionally back up /etc/guix/acl if it was possibly modified by hand. * doc/guix.texi (Base Services): Clarify the effect of setting 'authorize-keys?' to true. Mention the backup. Give an example showing how to authorize substitutes from another server.
2020-10-24build: Add GUIX_GIT_KEYRING variable for make authenticate.Miguel Ángel Arruga Vivas
* Makefile.am (GUIX_GIT_KEYRING): New variable. (authenticate): Use GUIX_GIT_KEYRING to select the keyring branch reference. * doc/contributing.texi (Building from Git): Add an example about the use of GUIX_GIT_KEYRING.
2020-10-22git: Require Guile-Git 0.3.0 or later.Ludovic Courtès
* guix/git.scm (auth-supported?): Remove. (clone*): Inline code that was dependent on AUTH-SUPPORTED?. (update-cached-checkout): Likewise. (resolve-reference): Remove check for 'object-lookup-prefix' and use it unconditionally. (load-git-submodules): Remove. (update-submodules): Use 'repository-submodules', 'submodule-lookup', etc. unconditionally. (update-cached-checkout): Use 'repository-close!' unconditionally. * m4/guix.m4 (GUIX_CHECK_GUILE_GIT): New macro. * configure.ac: Use it and error out when it fails. * doc/guix.texi (Requirements): Bump to Guile-Git 0.3.0.
2020-10-21doc: Move documentation of singularity-service-type.Ricardo Wurmus
Fixes <https://bugs.gnu.org/44126>. * doc/guix.texi: Move documentation of singularity-service-type from "Auditd Service" heading to "Docker Service" heading.
2020-10-21doc: Capitalize "Hurd" in 'operating-system' reference.Ludovic Courtès
* doc/guix.texi (operating-system Reference): Capitalize "Hurd".
2020-10-21doc: Add an entry for the 'keyboard-layout' procedure.Ludovic Courtès
* doc/guix.texi (Keyboard Layout): Add @deffn entry for 'keyboard-layout'.
2020-10-21doc: Fix typo in 'avahi-service-type' description.Ludovic Courtès
* doc/guix.texi (Networking Services): Change "zero-configuration" to "avahi-configuration".
2020-10-21doc: Fix typo in 'git-fetch' description.Ludovic Courtès
* doc/guix.texi (origin Reference): Replace "git-download" with "git-fetch" in one sentence.
2020-10-21doc: Cookbook links to /manual/devel, not /manual.Ludovic Courtès
Since the Cookbook is built from the 'master' branch, it should point to the manual from that same branch. * doc/build.scm (guix-mono-node-indexes, guix-split-node-indexes): Link to /manual/devel when %MANUAL is not "guix".
2020-10-20services: databases: Don't specify a default postgresql version.Christopher Baines
Currently, if the postgresql package major version changes, this is going to break the service upon upgrade, because PostgreSQL will reject the data files from the differing major version of the service. Because it's important to either keep running a particular major version, or intentionally upgrade, I think the configuration would be better with no default. I think this is also going to be helpful when trying to assist users upgrading PostgreSQL. * gnu/services/databases.scm (<postgresql-configuration>): Remove default for postgresql. (postgresql-service-type): Remove the default value. * gnu/tests/databases.scm (%postgresql-os): Update accordingly. * gnu/tests/guix.scm (%guix-data-service-os): Update accordingly. * gnu/tests/monitoring.scm (%zabbix-os): Update accordingly. * gnu/tests/web.scm (patchwork-os): Update accordingly. * doc/guix.texi (PostgreSQL): Update accordingly.
2020-10-20services: databases: Deprecate the postgresql-service procedure.Christopher Baines
Using the service type directly is a better approach, making it easier to configure the service. * gnu/services/databases.scm (postgresql-service): Deprecate this procedure. * doc/guix.texi (PostgreSQL): Update the documentation for the use of (service postgresql-service-type).
2020-10-20doc: Add subheadings in to the Databases section.Christopher Baines
To make it clearer where the relevant documentation for a particular service starts and ends. * doc/guix.texi (Database Services): Add subheadings.
2020-10-20guix build: Move package transformation options behind '--help-transform'.Ludovic Courtès
This change declutters the '--help' output. * guix/scripts/build.scm (show-build-options-help) (%standard-build-options): Add '--help-transform'. (show-transformation-options-help): Make private. (show-help): Remove call to 'show-transformation-options-help'. * guix/scripts/build.scm (show-help): Likewise. * guix/scripts/environment.scm (show-help): Likewise. * guix/scripts/graph.scm (show-help): Likewise. * guix/scripts/install.scm (show-help): Likewise. * guix/scripts/pack.scm (show-help): Likewise. * guix/scripts/package.scm (show-help): Likewise. * guix/scripts/upgrade.scm (show-help): Likewise. * doc/guix.texi (Package Transformation Options): Mention '--help-transform'.