summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* doc: Tweak .texi to avoid po4a-translate infinite loop.Ludovic Courtès2020-09-08
| | | | | * doc/guix.texi (Requirements): Keep @uref on one line as splitting it would lead po4a-translate to enter an infinite loop.
* Remove (guix json) and require Guile-JSON 4.3.0+.Ludovic Courtès2020-09-08
| | | | | | | | | | | | | | This is a followup to 4071879c86d059ee087c8986915ea72b8c742b72. * guix/json.scm: Remove. * Makefile.am (MODULES): Adjust accordingly. * m4/guix.m4 (GUIX_CHECK_GUILE_JSON): Check for 'define-json-mapping'. * doc/guix.texi (Requirements): Require Guile-JSON 4.3.0+. * guix/ci.scm, guix/cve.scm, guix/import/cpan.scm, guix/import/crate.scm, guix/swh.scm: Remove (guix json) import. * guix/import/gem.scm, guix/import/pypi.scm: Likewise, and import (json). * guix/self.scm (specification->package): Switch to GUILE-JSON-4. * guix/git-download.scm (git-fetch): Likewise.
* doc: Document 'file-system-label' and 'uuid'.Ludovic Courtès2020-09-04
| | | | * doc/guix.texi (File Systems): Document 'file-system-label' and 'uuid'.
* doc: Syntax highlighting now handles @var within @lisp.Ludovic Courtès2020-09-04
| | | | | * doc/build.scm (syntax-highlighted-html)[build](concatenate-pieces): Handle @var{name}.
* doc: Balance parens in R Shiny example.Ludovic Courtès2020-09-04
| | | | | * doc/guix.texi (Miscellaneous Services): Balance parens in R Shiny example.
* doc: Add "Getting Started" section.Ludovic Courtès2020-09-03
| | | | | | | * doc/guix.texi (Getting Started): New node. (Binary Installation): Refer to it and to "Application Setup". (After System Installation): Refer to "Getting Started". (Features): Add introductory sentence.
* services: childhurd: Support installing secrets from the host.Jan (janneke) Nieuwenhuizen2020-09-01
| | | | | | | * gnu/services/virtualization.scm (%hurd-vm-operating-system): Add secret-service. (hurd-vm-shepherd-service): Use it to install secrets. * doc/guix.texi (The Hurd in a Virtual Machine): Document it.
* gexp: computed-file: Prevent mistakenly overriding default option values.Maxim Cournoyer2020-09-01
| | | | | | | | | | | | | In order to do so, default to an empty options list, and expose options whose default values are sensitive directly as keyword arguments. * guix/gexp.scm (computed-file): Extract the LOCAL-BUILD? parameter from the OPTIONS parameter to make it a stand-alone keyword argument. Introduce an OPTIONS* binding which is obtained by combining the LOCAL-BUILD? keyword and its value with OPTIONS. * doc/guix.texi (G-Expressions): Adjust doc. Suggested-by: Ludovic Courtès <ludo@gnu.org>
* guix: system: Add `--label' option.Julien Lepiller2020-08-31
| | | | | | | | | * guix/scripts/system.scm (%options): Add `--label'. (system-derivation-for-action): Take a #:label key to set volume ID. (perform-action): Take a #:label key. (%default-options): Add default label value. (process-action): Pass label value from command-line to perform-action. * gnu/system/image.scm (image-with-label): New procedure.
* doc: Document the 'description' and 'default-value' of <service-type>.Ludovic Courtès2020-08-28
| | | | | * doc/guix.texi (Service Reference): Document the 'description' and 'default-value' fields of <service-type>.
* doc: Improve the instructions regarding `guix git authenticate`.Joshua Branson2020-08-27
| | | | | | | * doc/contributing.texi (Building from Git): Instruct the user to fetch the 'keyring' branch. Fix a typo. Signed-off-by: Leo Famulari <leo@famulari.name>
* offload: Modify the build-machine record to accept multiple systems.Maxim Cournoyer2020-08-25
| | | | | | | | | | | | | * guix/scripts/offload.scm (<build-machine>)[systems]: New field. [system]: Accessor changed to %build-machine-system. Default to #f. * guix/scripts/offload.scm (build-machine-system): Wrap %build-machine-system with a deprecation warning. (build-machine-systems): Access the new systems field or fallback to use build-machine-system, for backward compatibility. (machine-matches?): Adjust. * tests/offload.scm: Add tests... * Makefile.am (SCM_TESTS): ...and register them. * doc/guix.texi (Daemon Offload Setup): Update doc.
* doc: Fix typo.Tobias Geerinckx-Rice2020-08-25
| | | | * doc/guix.texi (Virtualization Services): Fix typo.
* services: unattended-upgrade: Add 'operating-system-file' field.Ludovic Courtès2020-08-24
| | | | | | | * gnu/services/admin.scm (<unattended-upgrade-configuration>)[operating-system-file]: New field. (unattended-upgrade-mcron-jobs): Honor it. * doc/guix.texi (Unattended Upgrades): Document it.
* Use "guile-zlib" and "guile-lzlib" instead of (guix config).Mathieu Othacehe2020-08-24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Makefile.am (MODULES): Remove guix/zlib.scm and guix/lzlib.scm, (SCM_TESTS): remove tests/zlib.scm, tests/lzlib.scm. * build-aux/build-self.scm (make-config.scm): Remove unused %libz variable. * configure.ac: Remove LIBZ and LIBLZ variables and check instead for Guile-zlib and Guile-lzlib. * doc/guix.texi ("Requirements"): Remove zlib requirement and add Guile-zlib and Guile-lzlib instead. * gnu/packages/package-management.scm (guix)[native-inputs]: Add "guile-zlib" and "guile-lzlib", [inputs]: remove "zlib" and "lzlib", [propagated-inputs]: ditto, [arguments]: add "guile-zlib" and "guile-lzlib" to Guile load path. * guix/config.scm.in (%libz, %liblz): Remove them. * guix/lzlib.scm: Remove it. * guix/man-db.scm: Use (zlib) instead of (guix zlib). * guix/profiles.scm (manual-database): Do not stub (guix config) in imported modules list, instead add "guile-zlib" to the extension list. * guix/scripts/publish.scm: Use (zlib) instead of (guix zlib) and (lzlib) instead of (guix lzlib), (string->compression-type, effective-compression): do not check for zlib and lzlib availability. * guix/scripts/substitute.scm (%compression-methods): Do not check for lzlib availability. * guix/self.scm (specification->package): Add "guile-zlib" and "guile-lzlib" and remove "zlib" and "lzlib", (compiled-guix): remove "zlib" and "lzlib" arguments and add guile-zlib and guile-lzlib to the dependencies, also do not pass "zlib" and "lzlib" to "make-config.scm" procedure, (make-config.scm): remove "zlib" and "lzlib" arguments as well as %libz and %liblz variables. * guix/utils.scm (lzip-port): Use (lzlib) instead of (guix lzlib) and do not check for lzlib availability. * guix/zlib.scm: Remove it. * m4/guix.m4 (GUIX_LIBZ_LIBDIR, GUIX_LIBLZ_FILE_NAME): Remove them. * tests/lzlib.scm: Use (zlib) instead of (guix zlib) and (lzlib) instead of (guix lzlib), and do not check for zlib and lzlib availability. * tests/publish.scm: Ditto. * tests/substitute.scm: Do not check for lzlib availability. * tests/utils.scm: Ditto. * tests/zlib.scm: Remove it.
* doc: cookbook: Add chapter about Guix environment.Oleg Pykhalov2020-08-23
| | | | * doc/guix-cookbook.texi (Environment management): New chapter.
* doc: Fix a typo in the AutoSSH service documentation.Maxim Cournoyer2020-08-17
| | | | * doc/guix.texi (Networking Services)[autossh-configuration]: Fix typo.
* services: docker: Add 'enable-iptables?' argument.Alexey Abramov2020-08-16
| | | | | | | | * gnu/services/docker.scm (docker-configuration): Define the argument. * gnu/services/docker.scm (docker-shepherd-service): Use it. * doc/guix.texi (Docker Service): Document it. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
* doc: Fix a typo.Tobias Geerinckx-Rice2020-08-10
| | | | | | * doc/guix.texi (operating-system Reference): Fix a typo & sigh. Reported by Jakub Kądziołka <kuba@kadziolka.net>.
* doc: Shrink width of deeply-indented code sample.Tobias Geerinckx-Rice2020-08-09
| | | | | | | This follows up on commit 4cafdce2102e3ebc7b3a6152464a62a454b6be45. * doc/guix.texi (operating-system Reference): Shorten comments to fit everything on an 80-character punch card.
* doc: Explain how to select system package outputs.Tobias Geerinckx-Rice2020-08-09
| | | | | * doc/guix.texi (operating-system Reference): Document that PACKAGES may contain traces of tuples and give an example.
* doc: Fix typo.Tobias Geerinckx-Rice2020-08-09
| | | | * doc/guix.texi (operating-system Reference): Add missing ‘of’.
* doc: Document 'mount-may-fail?' field.Ludovic Courtès2020-08-03
| | | | | | This is a followup to 7c27bd115b14afd142da7684cc349369965f9eab. * doc/guix.texi (File Systems): Document 'mount-may-fail?'.
* services: Add zram-device-service.Efraim Flashner2020-08-02
| | | | | | | * gnu/services/linux.scm (<zram-device-configuration>): New record. (zram-device-service-type): New variable. * doc/guix.texi (Linux Services): Document it. * tests/services/linux.scm (zram-swap-device-test): New tests.
* doc: Explain how to use psql with peer authentication.Pierre Neidhardt2020-08-01
| | | | | | * doc/guix.texi (Database Services): Add example of shell commands to use psql as system user. Also add troubleshooting tip when service fails to start because of incompatible cluster.
* doc: Extend tlp-service-type example.Tobias Geerinckx-Rice2020-07-29
| | | | | | | * doc/guix.texi (Power Management Services): Demonstrate tlp-configuration usage. Suggested by rovanion on #guix.
* doc: Warn against using the .scm extension for the channel news file.Pierre Neidhardt2020-07-28
| | | | | * doc/guix.texi (Writing Channel News): Explain the issue with using the .scm extension and possible workarounds; fix the example to use the .txt extension instead.
* services: auditd: Provide default configuration directory.Robin Green2020-07-27
| | | | | | | | | | | | | | * gnu/services/auditd.scm (auditd.conf) (%default-auditd-configuration-directory): New variables. (<auditd-configuration>): Switch to 'define-record-type*'. [configuration-directory]: New field. (auditd-shepherd-service): Honor 'configuration-directory'. Pass #:pid-file. (auditd-service-type)[description]: Tweak. [default-value]: Provide 'configuration-directory'. * doc/guix.texi (Miscellaneous Services): Update docs to reflect changes. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: Add 'unattended-upgrade-service-type'.Ludovic Courtès2020-07-27
| | | | | | | | | | | * gnu/services/admin.scm (<unattended-upgrade-configuration>): New record type. (%unattended-upgrade-log-file): New variable. (unattended-upgrade-mcron-jobs, unattended-upgrade-log-rotations): New procedures. (unattended-upgrade-service-type): New variable. * doc/guix.texi (Service Reference): Add 'provenance-service-type' anchor. (Unattended Upgrades): New section.
* machine: ssh: Check for potential system downgrades.Ludovic Courtès2020-07-27
| | | | | | | | | | | | | | | This is a followup to 8e31736b0a60919cc1bfc5dc22c395b09243484a. * guix/scripts/system/reconfigure.scm (check-forward-update): Add #:current-channels. Use it instead of OLD. * gnu/services.scm (sexp->system-provenance): New procedure. (system-provenance): Use it. * gnu/machine/ssh.scm (<machine-ssh-configuration>)[allow-downgrades?]: New field. (machine-check-forward-update): New procedure. (check-deployment-sanity)[assertions]: Call it. * doc/guix.texi (Invoking guix deploy): Document 'allow-downgrades?' field.
* services: nix: Add extra-options.Oleg Pykhalov2020-07-25
| | | | | | | * gnu/services/nix.scm (<nix-configuration>)[extra-options]: New field. (nix-shepherd-service): Add this. (nix-activation): Add new line to the end of /etc/nix/nix.conf file. * doc/guix.texi (Miscellaneous Services)[Nix service]: Document this.
* doc: Mention the channel keyring branch.Ludovic Courtès2020-07-24
| | | | | | | Reported by Pierre Neidhardt <mail@ambrevar.xyz>. * doc/guix.texi (Channels): Mention the keyring branch and the 'keyring-reference' bit in '.guix-channel'.
* doc: Use an existing commit in channel example.Ludovic Courtès2020-07-24
| | | | | | | Suggested by zimoun <zimon.toutoune@gmail.com>. * doc/guix.texi (Channels): Use the commit for 'v1.0.0' instead of a non-existing commit in example.
* guix system: 'reconfigure' disallows downgrades by default.Ludovic Courtès2020-07-23
| | | | | | | | | | | | | | | | This is similar to what 9744cc7b4636fafb772c94adb8f05961b5b39f16 did for 'guix pull'. * guix/scripts/system/reconfigure.scm (ensure-forward-reconfigure) (warn-about-backward-reconfigure, channel-relations) (check-forward-update): New procedures. * guix/scripts/system.scm (perform-action): Add #:validate-reconfigure. Call 'check-forward-update' when ACTION is 'reconfigure. (%options, show-help): Add "--allow-downgrades". (%default-options): Add 'validate-reconfigure' key. (process-action): Pass #:validate-reconfigure to 'perform-action'. * doc/guix.texi (Invoking guix system): Document 'guix system describe' more prominently, and document '--allow-downgrades'.
* doc: Tweak mcron example.Ludovic Courtès2020-07-23
| | | | | * doc/guix.texi (Scheduled Job Execution): In example, move '%min-level' definition after 'use-modules'.
* doc: Recommend running 'guix git authenticate' when cloning the repo.Ludovic Courtès2020-07-23
| | | | | * doc/contributing.texi (Building from Git): Adjust instruction and recommend 'guix git authenticate'.
* services: nix: Fix sandbox.Oleg Pykhalov2020-07-22
| | | | | | | | | | | * gnu/tests/package-management.scm: New file. * gnu/local.mk: Add this. * gnu/services/nix.scm (<nix-configuration>): New record. (nix-activation): Generate Nix config file which fixes sandbox. (nix-service-type): Add default value. (nix-shepherd-service): Allow provide Nix package. * doc/guix.texi (Miscellaneous Services)[Nix service]<nix-configuration>: Document record.
* doc: Mention the 'savannah' updater.Ludovic Courtès2020-07-21
| | | | * doc/guix.texi (Invoking guix refresh): Mention 'savannah' updater.
* ssh: Speed up RPCs by using #:nodelay.Lars-Dominik Braun2020-07-20
| | | | | | | | | | Partly fixes <https://bugs.gnu.org/41702>. * guix/ssh.scm (open-ssh-session): Enable #:nodelay. * m4/guix.m4 (GUIX_CHECK_GUILE_SSH): Add feature check for this new parameter. * doc/guix.texi (Requirements): Adjust. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Fix Ganeti blog post URL.Marius Bakke2020-07-19
| | | | * doc/guix.texi (Virtualization Services): Adjust Ganeti blog post URL.
* services: ganeti: Use TLS on the remote API by default.Marius Bakke2020-07-19
| | | | | | * gnu/services/ganeti.scm (<ganeti-rapi-configuration>): Set SSL? to #t. * gnu/tests/ganeti.scm (%ganeti-os): Set SSL? to #f. * doc/guix.texi (Virtualization Services): Adjust accordingly.
* build-system/maven: Make default-maven-plugins a procedure.Christopher Baines2020-07-17
| | | | | | | | | This allows compiling the module without the (gnu packages maven) module being available. * guix/build-system/maven.scm (%default-maven-plugins): Rename to default-maven-plugins, and convert to a procedure. * doc/guix.texi (maven-build-system): Update.
* guix: Add maven-build-system.Julien Lepiller2020-07-17
| | | | | | | * guix/build-system/maven.scm: New file. * guix/build/maven-build-system.scm: New file. * Makefile.am (MODULES): Add them. * doc/guix.texi (Build Systems): Document the maven build system.
* doc: Small fixups for the Ganeti documentation.Marius Bakke2020-07-17
| | | | | * doc/guix.texi (Virtualization Services): Fix various inaccuracies and add markup the procedure parameters.
* services: Add ganeti.Marius Bakke2020-07-16
| | | | | * gnu/services/ganeti.scm, gnu/tests/ganeti.scm: New files. * doc/guix.texi (Virtualization Services): Document the Ganeti services.
* Add 'guix git authenticate'.Ludovic Courtès2020-07-11
| | | | | | | | | | | | * guix/scripts/git.scm, guix/scripts/git/authenticate.scm, tests/guix-git-authenticate.sh: New files. * Makefile.am (MODULES): Add the *.scm files. (SH_TESTS): Add 'tests/guix-git-authenticate.sh'. * doc/guix.texi (Channels)[Specifying Channel Authorizations]: Mention 'guix git authenticate'. (Invoking guix git authenticate): New node. * po/guix/POTFILES.in: Add 'guix/scripts/git.scm' and 'guix/scripts/git/authenticate.scm'.
* doc: Fix typo.Tobias Geerinckx-Rice2020-07-09
| | | | * doc/contributing.texi (The Perfect Setup): Fix spelling & placement of ‘additionally’.
* doc: cookbook: Fix ‘file system’ spelling.Tobias Geerinckx-Rice2020-07-09
| | | | | * doc/guix-cookbook.texi (Getting help, Customizing the Kernel): Fix ‘file system’ spelling.
* doc: Fix texinfo identifiers in Version Control Services.Arun Isaac2020-07-06
| | | | | * doc/guix.texi (Version Control Services): Use @code, @command, @file, @indicateurl, @samp texinfo identifiers correctly.
* doc: Fix minor typo in X Window.Arun Isaac2020-07-05
| | | | * doc/guix.texi (X Window): Replace "not" with "no".