summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)Author
2020-04-13doc: Emit hyperlinks in HTML output for @lisp snippets.Ludovic Courtès
This makes it easier to jump to the definition of a procedure or variable when looking at a code snippet. There can be false-positive because scoping rules are ignored, for example, but it should be a good approximation. * doc/build.scm (syntax-highlighted-html)[build](highlights->sxml*): Add 'anchors' parameter. Add clause for ('symbol text). (syntax-highlight): Add 'anchors' parameter. Wrap body in named let and use it in recursive calls. Pass ANCHORS to 'highlights->sxml*'. (underscore-decode, anchor-id->key, collect-anchors, html?): New procedures. (process-file): Add 'anchors' parameter. and honor it. Rewrite mono-node and multi-node HTML files separately.
2020-04-08doc: Mention HTTP/HTTPS proxy in the system installation instructions.Ludovic Courtès
* doc/guix.texi (Keyboard Layout and Networking and Partitioning): Mention 'herd set-http-proxy guix-daemon'.
2020-04-07services: guix: Add 'set-http-proxy' action.Ludovic Courtès
Fixes <https://bugs.gnu.org/25569>. Reported by Divan Santana <divan@santanas.co.za>. * gnu/services/base.scm (shepherd-set-http-proxy-action): New procedure. (guix-shepherd-service): Add 'actions' field. Change 'start' to a lambda; check the value of the "http_proxy" environment variable and add "http_proxy" and "https_proxy" to #:environment-variables as a function of that. * gnu/tests/base.scm (run-basic-test)["guix-daemon set-http-proxy action", "guix-daemon set-http-proxy action, clear"]: New tests. * doc/guix.texi (Base Services): Document it.
2020-04-06services: Add 'rottlog-service-type' to '%base-services'.Ludovic Courtès
* gnu/services/base.scm (%base-services): Add an instance of ROTTLOG-SERVICE-TYPE. * doc/guix.texi (Log Rotation): Mention that it's part of %BASE-SERVICES and change example.
2020-04-06doc: Make 'fc-cache -rv' instructions more prominent.Ludovic Courtès
* doc/guix.texi (Application Setup): Move the "fc-cache" instructions next to the Fontconfig paragraph and make the command more visible.
2020-04-06gnu: mumi: Update to 0.0.0-12.bb2fe92.Ricardo Wurmus
* gnu/packages/mail.scm (mumi): Update to 0.0.0-12.bb2fe92. [inputs]: Add guile-gcrypt, guile-redis, guile-webutils, mailutils. * gnu/services/web.scm (<mumi-configuration>): New record type. (mumi-configuration, mumi-configuration?, mumi-configuration-mumi, mumi-configuration-mailer?, mumi-configuration-sender, mumi-configuration-smtp): New procedures. (mumi-shepherd-services): Accept configuration; adjust start commands; add Shepherd service for mumi mailer. (mumi-service-type): Pass default configuration. * doc/guix.texi (Web Services): Update documentation.
2020-04-06system: Allow for comma-separated keyboard layouts.Ludovic Courtès
Reported by Florian Pelz <pelzflorian@pelzflorian.de>. * gnu/bootloader/grub.scm (keyboard-layout-file): Replace commas with hyphens in the first argument to 'computed-file'. * gnu/system/keyboard.scm (keyboard-layout->console-keymap): Likewise. * doc/guix.texi (Keyboard Layout): Add example.
2020-04-05gnu: Add kernel-module-loader-service.Brice Waegeneire
* doc/guix.texi (Linux Services): Add a new subsection and document the new service and its configuration. * gnu/services/linux.scm (kernel-module-loader-service-type): New type. (kernel-module-loader-shepherd-service): New procedure. * gnu/tests/linux-modules.scm (module-loader-program): Procedure removed. (modules-loaded?-program): New procedure. (run-loadable-kernel-modules-test): 'module-loader-program' procedure replaced by the new one. [os]: Use 'kernel-module-loader-service'. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2020-03-30gnu: Add sbcl-stumpwm-ttf-fonts.Oleg Pykhalov
* gnu/packages/wm.scm (sbcl-stumpwm-ttf-fonts): New variable. * doc/guix-cookbook.texi (Customizing a Window Manager): Document SBCL-STUMPWM-TTF-FONTS installation and configuration.
2020-03-27services/nfs: Replace nfs-version with nfs-versions.Ricardo Wurmus
Instead of accepting a string for just one protocol version accept a list of supported versions. * gnu/services/nfs.scm (<nfs-configuration>)[nfs-version]: Remove field and replace... [nfs-versions]: ...with this new field. (nfs-shepherd-services): Pass as many "--nfs-version" options as there are supported versions. * doc/guix.texi (Network File System): Document nfs-versions.
2020-03-24doc: Document that a working environment for building Guix requires "--pure".Danny Milosavljevic
* doc/guix.texi (Invoking guix environment): Document that a working environment for building Guix requires "--pure".
2020-03-24doc: Fix typo in example.Naga Malleswari
* doc/guix.texi (Base Services)[file->udev-rule]: Correct misspelt "user-account". Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2020-03-24doc: Fix typo.Naga Malleswari
* doc/guix.texi (Invoking guix time-machine): Fix typo. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2020-03-23doc: Fix typo in example.Brice Waegeneire
* doc/guix.texi (Invoking guix deploy): Fix example to use '%user' variable defined above. Signed-off-by: Mathieu Othacehe <m.othacehe@gmail.com>
2020-03-23doc: Add console-font-service-type to Base Services.John Soo
* doc/guix.texi (Base Services): Add console-font-service-type. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2020-03-22system: Add kernel-loadable-modules to operating-system.Danny Milosavljevic
* gnu/system.scm (<operating-system>): Add kernel-loadable-modules. (operating-system-directory-base-entries): Use it. * doc/guix.texi (operating-system Reference): Document KERNEL-LOADABLE-MODULES. * gnu/build/linux-modules.scm (depmod): New procedure. (make-linux-module-directory): New procedure. Export it. * guix/profiles.scm (linux-module-database): New procedure. Export it. * gnu/tests/linux-modules.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * gnu/packages/linux.scm (make-linux-libre*)[arguments]<#:phases>[install]: Disable depmod. Remove "build" and "source" symlinks. [native-inputs]: Remove kmod.
2020-03-19doc: Update to reflect the current installation prefix of Emacs packages.Maxim Cournoyer
* doc/guix.texi (Application Setup)[Emacs Packages]: No longer mention the guix.d Elisp installation prefix. Do not treat the user profile specially, as it is not special anymore. (Build Systems): Document the correct Elisp installation prefix.
2020-03-18doc: Correctly state the size of the glibc-locales package.Leo Famulari
* doc/guix.texi (Application Setup): Give the correct size.
2020-03-18doc: Follow-up commit to f6b950319c.Maxim Cournoyer
* doc/guix.texi (Invoking guix deploy): Fix typo in example. Reported-by: Ludovic Courtès <ludo@gnu.org>
2020-03-17gnu: system: Export %sudoers-specification.Maxim Cournoyer
Exporting this variable allows reusing the default value of the `sudoers-file' field when configuring it. * gnu/system.scm (gnu): Export %sudoers-specification. * doc/guix.texi (Invoking guix deploy): Document an example, to use with 'guix deploy'.
2020-03-17doc: Fix typo in prosody configuration.Efraim Flashner
* doc/guix.texi (Messaging Services)[Prosody Service]: Switch 'cons' to 'cons*' in example prosody-service-type.
2020-03-16services: nginx: Fix broken default configuration.Tobias Geerinckx-Rice
* gnu/services/web.scm (nginx-configuration): Emit an empty events{} block by default. * doc/guix.texi (Web Services): Document it.
2020-03-15services/web: nginx-configuration: Add support for global directives.Ricardo Wurmus
* gnu/services/web.scm (<nginx-configuration>)[global-directives]: Add field. (emit-global-directive): New procedure. (default-nginx-config): Use it. * doc/guix.texi (Web Services): Document it.
2020-03-13doc: Update guidance about Python 2 package variants.Leo Famulari
* doc/contributing.texi (Python Modules): Don't recommend adding Python-2 package variants by default.
2020-03-13weather: Exit with non-zero when coverage is below 100%.Ludovic Courtès
* guix/scripts/weather.scm (report-server-coverage): Return the coverage ratio. (guix-weather): Exit if and only if each server's coverage is 1.
2020-03-12weather: Allow for multiple '--manifest' options.Ludovic Courtès
* guix/scripts/weather.scm (guix-weather)[package-list]: Account for all the 'manifest entries in OPTS. * doc/guix.texi (Invoking guix weather): Document it.
2020-03-12weather: Add '--display-missing'.Ludovic Courtès
* guix/scripts/weather.scm (report-server-coverage): Add #:display-missing? and honor it. (show-help, %options): Add "--display-missing". (guix-weather): Pass #:display-missing? to 'report-server-coverage'. * doc/guix.texi (Invoking guix weather): Document it.
2020-03-12gexp: Add 'with-parameters'.Ludovic Courtès
* guix/gexp.scm (<parameterized>): New record type. (with-parameters): New macro. (compile-parameterized): New gexp compiler. * tests/gexp.scm ("with-parameters for %current-system") ("with-parameters for %current-target-system") ("with-parameters + file-append"): New tests. * doc/guix.texi (G-Expressions): Document it.
2020-03-12doc: Fix description for "guix package -A".Danny Milosavljevic
* doc/guix.texi (Invoking guix package): Fix description for "guix package -A".
2020-03-10doc: Use HTTPS for external links.Vitaliy Shatrov
* doc/contributing.texi (14.1 Building from Git, 14.3 The Perfect Setup, 14.4.1 Software Freedom, 14.4.4 Synopses and Descriptions, 14.5.4 Formatting Code): Use HTTPS for @uref{}s and @url{}s that support it. * doc/fdl-1.3.texi (Appendix A GNU Free Documentation License): Use HTTPS for @uref{}s and @url{}s that support it. * doc/guix.texi (6.3 Build Systems, 8.8.4 Networking Services, 8.8.8 Sound Services, 8.8.16 Web Services, 8.11 Name Service Switch, 12.2 Preparing to Use the Bootstrap Binaries); Use HTTPS for @uref{}s and @url{}s that support it. Signed-off-by: Marius Bakke <mbakke@fastmail.com>
2020-03-09doc: Use an https link for Contributor Covenant.Jakub Kądziołka
* doc/contributing.texi: Switch to https for the link to contributor-covenant.org Reported-By: guix-vits on IRC
2020-03-08services: cuirass: Allow passing extra command line options.Christopher Baines
This is so that the options supported by the service configuration don't have to always be changed. Generally though all options should be explicitly supported and documented, so this is mostly to facilitate experimentation. * gnu/services/cuirass.scm (<cuirass-configuration>): Add an extra-options field. (cuirass-shepherd-service): Pass the extra options to the shepherd servvices. * doc/guix.texi (Continuous Integration): Document it.
2020-03-08services: guix-data-service: Allow passing extra options.Christopher Baines
This is so that the options supported by the service configuration don't have to always be changed. Generally though all options should be explicitly supported and documented, so this is mostly to facilitate experimentation. * gnu/services/guix.scm (<guix-data-service-configuration>): Add extra-options and extra-process-jobs-options to the record type. (guix-data-service-shepherd-services): Handle these new configuration record fields. * doc/guix.texi (Guix Data Service): Document these new options.
2020-03-08services: certbot: Add server option.Jack Hill
* gnu/services/certbot.scm (certbot-configuration): Add server option. (certbot-command): Use server option. (certbot-actication): Use server option. (certbot-nginx-server-configurations): Use server option. * doc/guix.texi (Certificate Services): Document server option. Co-authored-by: Tobias Geerinckx-Rice <me@tobias.gr> Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-03-01doc: Fix some typos.Eric Bavier
* doc/guix.texi: Various typo fixes.
2020-02-22etc: Add copyright.Oleg Pykhalov
* etc/copyright.el: New file. * doc/contributing.texi (The Perfect Setup): Document this.
2020-02-22build: Depend on guile-ssh 0.12.0Lars-Dominik Braun
This is a followup to 35f35111678e6622301b414f3d464acb71e106bb. * m4/guix.m4 (GUIX_CHECK_GUILE_SSH): Check for userauth-gssapi! * doc/guix.texi: Document version requirement Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-02-21doc: Fix copy-build-system specification.Pierre Neidhardt
* doc/guix.texi (Build Systems): Files must match one or more filters, not exactly one.
2020-02-21doc: Fix indentation.Tobias Geerinckx-Rice
This follows up on commit e90e64049ce160d28d1e8b3014badcc2b214627c, which broke ‘guix pull’. * doc/guix.texi (Build Systems): Un-indent.
2020-02-21doc: Fix typos.Nicolas Goaziou
* doc/guix.texi (Build Systems): Add missing hash to "#:exclude", and a comma after "e.g.". Use @file and @var appropriately.
2020-02-21build-system: Add copy-build-system.Pierre Neidhardt
* guix/build-system/copy.scm: New file. * guix/build/copy-build-system.scm: New file. * Makefile.am (MODULES): Add them. * doc/guix.texi (Build Systems): Document 'copy-build-system'.
2020-02-20doc: Use two spaces after full stops.Nicolas Goaziou
* doc/guix.texi (The Store): Use two spaces after full stops.
2020-02-20ssh: Add Kerberos-support to ssh:// daemon URLsLars-Dominik Braun
* guix/ssh.scm (open-ssh-session): Fall back to GSSAPI if public key authentication does not work Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-02-19gnu: services: Add openvpn options.Julien Lepiller
* gnu/services/vpn.scm (openvpn-client-configuration) (openvpn-server-configuration): Add fast-io? and auth-user-pass options.
2020-02-18doc: Document packaging guidelines for Rust crates.Efraim Flashner
* doc/contributing.texi (Rust Crates): New section.
2020-02-17doc: Add German Cookbook translation.Florian Pelz
* doc/local.mk (info_TEXINFOS): Add guix-cookbook.de.texi. (TRANSLATED_INFO): Add guix-cookbook.de.texi. * po/doc/guix-cookbook.de.po: New file. * po/doc/local.mk (DOC_COOKBOOK_PO_FILES): Add guix-cookbook.de.po.
2020-02-16doc: Fix typo.Efraim Flashner
* doc/guix.texi (X Window)[sddm-service-type]: SSDM -> SDDM typo fix. [sddm-configuration]: Also list 'maya' theme. * gnu/services/sddm.scm (sddm-service): Fix typo in doc string. (sddm-configuration): Also list 'maya' theme.
2020-02-14doc: Use @itemx as needed.Ludovic Courtès
This is a followup to 459e0967705945bf6b5861598202aefef27451cd. * doc/guix.texi (Invoking guix environment): Use @itemx for '--share'.
2020-02-14doc: Clarify documentation of guix environment --expose vs. --shareDamien Cassou
The documentation for --expose and --share parameters are so similar that the reader has to read both descriptions in parallel to find the difference. * doc/guix.texi (Invoking guix environment)[--expose, --share]: Merge the two descriptions into one. Signed-off-by: Jakub Kądziołka <kuba@kadziolka.net>
2020-02-14doc: Clarify how sudo and guix interact when updatingJakub Kądziołka
* doc/guix.texi (After System Installation): Explicitly explain the mechanics of how sudo differs from a login shell. Some recent discussions on IRC suggest that the existing wording wasn't entirely clear.