summaryrefslogtreecommitdiff
path: root/doc/guix.texi
Commit message (Collapse)AuthorAge
* gnu: mingetty-shepherd-service: Make 'clear-on-logout' configurable.Mark H Weaver2020-11-11
| | | | | | | | | | | 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.
* doc: Fix Zabbix ‘db-secret-file’ documentation.Tobias Geerinckx-Rice2020-11-07
| | | | | * doc/guix.texi (Monitoring Services): Clarify ‘db-secret-file’'s (lack of) structure and gexp support.
* services: Add yggdrasil-service-type.raingloom2020-11-05
| | | | | | | | | | | | * 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>
* doc: Illustrate procedures that return packages.Ludovic Courtès2020-11-03
| | | | | * doc/guix.texi (Defining Package Variants): Illustrate procedures that return packages.
* doc: Use '@lisp' for 'options->transformation' example.Ludovic Courtès2020-11-03
| | | | | * doc/guix.texi (Defining Package Variants): Use @lisp for 'options->transformation' example.
* doc: Fix typo.Miguel Ángel Arruga Vivas2020-11-02
| | | | | * doc/guix.texi (Invoking guix publish)<cache-bypass-threshold>: The unit suffixes the numeric value.
* doc: Complete sentence in earlyoom-configuration doc.Maxim Cournoyer2020-11-02
| | | | | | | * doc/guix.texi (Linux Services): Complete sentence in earlyoom-configuration doc. Reported-by: Julien Lepiller <julien@lepiller.eu>
* doc: Fix typo.Julien Lepiller2020-11-01
| | | | * doc/guix.texi (DNS Services): Fix typo.
* doc: Fix typo.Julien Lepiller2020-11-01
| | | | * doc/guix.texi (Sound Services): Fix typo.
* doc: Add missing period at the end of the sentence.Miguel Ángel Arruga Vivas2020-11-01
|
* doc: Add "Defining Package Variants" section.Ludovic Courtès2020-10-31
| | | | | | | * 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'.
* services: guix-publish: Add 'cache-bypass-threshold' field.Ludovic Courtès2020-10-30
| | | | | | | | This is a followup to ecaa102a58ad3ab0b42e04a3d10d7c761c05ec98. * gnu/services/base.scm (<guix-publish-configuration>)[cache-bypass-threshold]: New field. (guix-publish-shepherd-service): Honor it.
* services: swap: Allow for UUIDs and file system labels.Ludovic Courtès2020-10-30
| | | | | | | | * 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.
* scripts: lint: Add '--exclude' option.zimoun2020-10-30
| | | | | | | | * 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>
* scripts: lint: Fix '--no-network' option.zimoun2020-10-30
| | | | | | | | * 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>
* doc: Fix claimed archive timestamps.Tobias Geerinckx-Rice2020-10-28
| | | | | | | 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.
* publish: Add '--cache-bypass-threshold'.Ludovic Courtès2020-10-28
| | | | | | | | | | | | | | | | | * 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.
* doc: Update the PostgreSQL extension packages example.Christopher Baines2020-10-28
| | | | * doc/guix.texi (PostgreSQL): Update the extension packages example.
* doc: Use @code rather than @var for data type items.Christopher Baines2020-10-28
| | | | | | | In the couple of cases where it's inconsistent. * doc/guix.texi (PostgreSQL, Sound Services): Replace @var with @code within data type sections.
* doc: Fix various minor typos.Lulu2020-10-27
| | | | | | | | | | * 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>
* services: Add gmnisrv web service.Alexandru-Sergiu Marton2020-10-27
| | | | | | | | | | | * 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>
* doc: Document the postgresql-config-file.Christopher Baines2020-10-25
| | | | * doc/guix.texi (PostgreSQL): Document the postgresql-config-file record.
* doc: Add "Getting Substitutes from Other Servers" section.Ludovic Courtès2020-10-25
| | | | | | | | * 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.
* services: guix: Make /etc/guix/acl really declarative by default.Ludovic Courtès2020-10-25
| | | | | | | | | | | | 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.
* git: Require Guile-Git 0.3.0 or later.Ludovic Courtès2020-10-22
| | | | | | | | | | | | | | | * 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.
* doc: Move documentation of singularity-service-type.Ricardo Wurmus2020-10-21
| | | | | | | Fixes <https://bugs.gnu.org/44126>. * doc/guix.texi: Move documentation of singularity-service-type from "Auditd Service" heading to "Docker Service" heading.
* doc: Capitalize "Hurd" in 'operating-system' reference.Ludovic Courtès2020-10-21
| | | | * doc/guix.texi (operating-system Reference): Capitalize "Hurd".
* doc: Add an entry for the 'keyboard-layout' procedure.Ludovic Courtès2020-10-21
| | | | | * doc/guix.texi (Keyboard Layout): Add @deffn entry for 'keyboard-layout'.
* doc: Fix typo in 'avahi-service-type' description.Ludovic Courtès2020-10-21
| | | | | * doc/guix.texi (Networking Services): Change "zero-configuration" to "avahi-configuration".
* doc: Fix typo in 'git-fetch' description.Ludovic Courtès2020-10-21
| | | | | * doc/guix.texi (origin Reference): Replace "git-download" with "git-fetch" in one sentence.
* services: databases: Don't specify a default postgresql version.Christopher Baines2020-10-20
| | | | | | | | | | | | | | | | | | | | 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.
* services: databases: Deprecate the postgresql-service procedure.Christopher Baines2020-10-20
| | | | | | | | | 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).
* doc: Add subheadings in to the Databases section.Christopher Baines2020-10-20
| | | | | | | To make it clearer where the relevant documentation for a particular service starts and ends. * doc/guix.texi (Database Services): Add subheadings.
* guix build: Move package transformation options behind '--help-transform'.Ludovic Courtès2020-10-20
| | | | | | | | | | | | | | | | | 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'.
* guix build: Add '--with-debug-info'.Ludovic Courtès2020-10-20
| | | | | | | | | | | | | | | * guix/scripts/build.scm (transform-package-with-debug-info): New procedure. (%transformations): Add 'with-debug-info'. (%transformation-options, show-transformation-options-help): Add '--with-debug-info'. * tests/scripts-build.scm ("options->transformation, with-debug-info"): New test. * doc/guix.texi (Package Transformation Options): Document '--with-debug-info'. (Installing Debugging Files): Introduce sections. Remove bit about eventual "opt-out" since this is not happening. Document '--with-debug-info' under "Rebuilding with Debugging Info".
* doc: Replace @example with @lisp in "Build Phases".Ludovic Courtès2020-10-20
| | | | * doc/guix.texi (Build Phases): Use @lisp for second example.
* doc: More uses of @lisp instead of @example.Ludovic Courtès2020-10-20
| | | | | | * doc/guix.texi (G-Expressions): Use @lisp for 'let-system' example. * doc/contributing.texi (Synopses and Descriptions): Use @lisp for second example.
* doc: Fix misuses of @var in "Defining Packages".Ludovic Courtès2020-10-20
| | | | | * doc/guix.texi (Defining Packages): Use @code instead of @var where appropriate.
* doc: Add "Build Phases" section.Ludovic Courtès2020-10-20
| | | | | | | | | | * doc/guix.texi (Build Phases): New section. (Build Systems): Remove 'modify-phases' example and add cross-reference to "Build Phases". (Build Utilities)[Build Phases]: Simplify intro and link to "Build Phases". (G-Expressions): Add index entries for "code staging" and add cross-reference to "Build Phases".
* doc: Document 'url-fetch', 'git-fetch', and 'git-reference'.Ludovic Courtès2020-10-20
| | | | | | * doc/guix.texi (origin Reference): Rewrite initial paragraph. Properly document 'method' and its protocol. Document 'url-fetch', 'git-fetch', and 'git-reference' separately.
* services: Add LXQt desktop service.Reza Alizadeh Majd2020-10-20
| | | | | | | | | * gnu/services/desktop.scm (lxqt-desktop-service-type): New variable. (<lxqt-desktop-configuration>): New record type. (lxqt-desktop-configuration?): New procedure. * doc/guix.texi (Desktop Services): Document this. Co-authored-by: Oleg Pykhalov <go.wigust@gmail.com>
* doc: Fix typo.Aniket Patil2020-10-17
| | | | | | * doc/guix.texi (Invoking guix import): Fix typo. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Fixes for Texinfo metainfo.Miguel Ángel Arruga Vivas2020-10-17
| | | | | | | | * doc/guix.texi (guix-pack)[GUIX_EXECUTION_ENGINE]: Use @env instead of @code. (zram-device-service-type): Use @code instead of @var for constant or symbolic values. (rshiny-service-type): Use @env instead of @code for R_LIBS_USER.
* doc: Fix minor typos.Miguel Ángel Arruga Vivas2020-10-17
| | | | | | | | | | | | | | * doc/guix.texi (cargo-build-system): Fix install phase description. (julia-build-system): Fix typo and add information from check. (pulseaudio-configuration): Remove duplicated words. (knot-acl-configuration)[id]: Fix typo. (mpd-output)[extra-options]: Likewise. (libvirt-configuration) [listen-tls?]: Add missing subject. [listen-tcp?]: Add missing subject and period. [tls-port, tcp-port, log-filters]: Add missing period. (hurd-vm-configuration)[netoptions]: Fix typo in example. (ganeti-watcher-service-type): Fix typo. (grub-theme)[gfxmode]: Remove see before @pxref.
* doc: Improve "Build Utilities".Ludovic Courtès2020-10-15
| | | | | * doc/guix.texi (Build Utilities): Fix typos. Provide the correct syntax for 'substitute*'. Add a 'modify-phases' example.
* doc: Add "Build Utilities" section.Ludovic Courtès2020-10-15
| | | | | | | * doc/guix.texi (Build Utilities): New section. (Defining Packages): Refer to it. (Build Systems): Likewise. * doc/guix-cookbook.texi (Extended example): Likewise.
* doc: Fix typo.Mathieu Othacehe2020-10-15
| | | | * doc/guix.texi (Guix Build Coordinator): Fix typo.
* services: nginx: Add lua module.Oleg Pykhalov2020-10-14
| | | | | | | | * gnu/services/web.scm (<nginx-configuration>) [lua-package-path, lua-package-cpath]: New record types. * gnu/services/web.scm (default-nginx-config): Use them. * doc/guix.texi (Web Services): Document this. * doc/guix-cookbook.texi (System Configuration): Document this.
* doc: Mention "i586-gnu" as supported and experimental.Ludovic Courtès2020-10-14
| | | | * doc/guix.texi (GNU Distribution): Mention "i586-gnu".
* doc: Avoid orphan node.Ludovic Courtès2020-10-14
| | | | | | | | | | Commit 4b5a6fbc9b754c0ca70d033dd99f17c4f028733a turned "Transparent Emulation with QEMU" into a node, but that was an orphan node, with no up/next/previous links. * doc/guix.texi (Virtualization Services): Capitalize subsection title. (Transparent Emulation with QEMU): Remove "@node" and add "@anchor". (Daemon Offload Setup): Adjust cross-reference accordingly.