summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)Author
2021-01-06doc: Link to "Keyboard Layout" in "operating-system Reference"Morgan Smith
* doc/guix.texi (operating-system Reference): Link to the "Keyboard Layout" node. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2021-01-04guix system: Add '--graph-backend'.Ludovic Courtès
* guix/scripts/system.scm (lookup-backend): New procedure. (export-extension-graph, export-shepherd-graph): Add #:backend parameter and honor it. (show-help, %options): Add "--graph-backend". (%default-options): Add 'graph-backend'. (process-action): Pass #:backend to 'export-extension-graph' and 'export-shepherd-graph'. * doc/guix.texi (Invoking guix system): Document '--graph-backend'.
2021-01-03doc: Running Guix Before It Is Installed: mention ./bootstrapRovanion Luckey
* doc/contributing.texi (Running Guix Before It Is Installed): Instruct user to run ./bootstrap before ./configure. Signed-off-by: Jakub Kądziołka <kuba@kadziolka.net>
2020-12-27services: Add radicale-service-type.Jonathan Brielmaier
* gnu/services/mail.scm (radicale-configuration) (radicale-configuration?): New procedures. (%default-radicale-config-file) (radicale-service-type): New variables. * doc/guix.texi: Document it.
2020-12-27transformations: Add '--with-patch'.Ludovic Courtès
Suggested by Philippe Swartvagher <philippe.swartvagher@inria.fr>. * guix/transformations.scm (transform-package-patches): New procedure. (%transformations): Add it as 'with-patch'. (%transformation-options, show-transformation-options-help/detailed): Add '--with-patch'. * tests/transformations.scm ("options->transformation, with-patch"): New test. * doc/guix.texi (Package Transformation Options): Document it.
2020-12-23ssh: Use 'guix repl' instead of 'guile'.Ludovic Courtès
This simplifies setup of build machines: no need to install Guile in addition to Guix, no need to set 'GUILE_LOAD_PATH' & co., leading to fewer failure modes. * guix/ssh.scm (remote-run): New procedure. (remote-daemon-channel): Use it instead of 'open-remote-pipe*'. (store-import-channel)[import]: Remove check for module availability. Add call to 'primitive-exit'. Use 'remote-run' instead of 'open-remote-pipe'. (store-export-channel)[export]: Remove check for module availability. Add calls to 'primitive-exit'. Use 'remote-run' instead of 'open-remote-pipe'. (handle-import/export-channel-error): Remove 'module-error' clause. (report-module-error): Remove. * guix/scripts/offload.scm (assert-node-has-guix): Replace call to 'report-module-error' by 'leave'. * doc/guix.texi (Daemon Offload Setup): Remove mention of Guile.
2020-12-23doc: cookbook: Fix "fiction-less" typo.Pierre Neidhardt
* doc/guix-cookbook.texi (Guix Profiles in Practice): Change "friction-less" to "frictionless".
2020-12-22import/cran: Add input style "specification".Ricardo Wurmus
* guix/import/cran.scm (%input-style): New parameter. (format-inputs): Use it. * guix/scripts/import/cran.scm (guix-import-cran): Set the %input-style parameter. (%options): Add "--style" option. * doc/guix.texi (Invoking guix import): Document it.
2020-12-17doc: Emacs Packages: Fix typos.Nicolas Goaziou
* doc/contributing.texi (Emacs Packages): Fix typo. Also remove spurious white space, and unnecessary quote.
2020-12-17doc: Add Emacs packaging guidelines.Maxim Cournoyer
* doc/contributing.texi (Emacs Packages): New subsection.
2020-12-14doc: Note different texlive-tiny & texline-union natures.Tobias Geerinckx-Rice
* doc/contributing.texi (Submitting Patches): Add ‘package’ and ‘procedure’. Inspired-by: Jorge P. de Morais Neto
2020-12-14doc: Link to "Pattern Matching" in Guile.Ludovic Courtès
* doc/contributing.texi (Data Types and Pattern Matching): Link to the "Pattern Matching" node of the Guile manual.
2020-12-09doc: Document 'advertise?' for 'guix-publish-configuration'.Ludovic Courtès
* doc/guix.texi (Base Services): Document the 'advertise?' field of 'guix-publish-configuration'.
2020-12-08guix: opam: Add coq support in the importer.Julien Lepiller
* guix/import/opam.scm (get-opam-repository): Add support for coq repositories. (ocaml-name->guix-name): Properly name coq package. * doc/guix.texi (Invoking guix import): Document it.
2020-12-08services: cuirass: Add queue-size option.Mathieu Othacehe
* gnu/services/cuirass.scm (<cuirass-configuration>): Add "queue-size" field. (cuirass-shepherd-service): Honor it. * doc/guix.texi (Continuous Integration): Document it.
2020-12-07doc: Document about xfce4-panel plugins.宋文武
* doc/guix.texi (Desktop Services): Document that xfce4-panel plugin packages should be added to the 'packages' field of OS.
2020-12-07doc: Fix incorrect GUIX_PROFILE value for 'guix pull'.Holger Peters
* doc/guix.texi (Getting Started): Fix invalid GUIX_PROFILE value. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-12-07service: Add shepherd discover action.Mathieu Othacehe
* gnu/services/base.scm (shepherd-discover-action): New procedure, (guix-shepherd-service)[<actions>]: add it, [<start>]: honor it. * doc/guix.texi (Invoking guix-daemon): Document it.
2020-12-07prometheus-node-exporter: Support extra options.Christopher Baines
There are plenty of options supported that the Guix configuration record doesn't help you with, so add this field to allow users to do their own thing. * gnu/services/monitoring.scm (<prometheus-node-exporter-configuration>): Add extra-options field. (prometheus-node-exporter-shepherd-service): Handle the extra options. * doc/guix.texi (Prometheus Node Exporter Service): Document this.
2020-12-07prometheus-node-exporter: Enable the textfile collector.Christopher Baines
* gnu/services/monitoring.scm (<prometheus-node-exporter-configuration>): Add textfile-directory. (prometheus-node-exporter-textfile-directory, prometheus-node-exporter-activation): New procedures. (prometheus-node-exporter-shepherd-service): Pass --collector.textfile.directoryto the service. (prometheus-node-exporter-service-type): Extend the activation service type. * doc/guix.texi (Prometheus Node Exporter Service): Document.
2020-12-07doc: Remove redundant node exporter configuration from the example.Christopher Baines
* doc/guix.texi (Prometheus Node Exporter Service): Simplify the example.
2020-12-07doc: Document Guix System F2FS root support.Hugo Thiessard
* doc/guix.texi (Keyboard Layout and Networking and Partitioning): Add F2FS to the footnote of Guix System's supported root file systems. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2020-12-06doc: Add note on the importance of bootstrapping.Ludovic Courtès
* doc/guix.texi (Bootstrapping): Remove distinction between "regular users" and "hackers". Explain the importance of the question.
2020-12-04doc: Mention Guile-Semver dependency.Ludovic Courtès
This is a followup to 269c1db41bd82f93c7ae5c62a4969a423e556183. * doc/guix.texi (Requirements): Mention Guile-Semver.
2020-12-03doc: Give references and examples for services-to-restart.Simon Josefsson
* doc/guix.texi (Unattended Upgrades): Give references and examples for services-to-restart. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-12-03doc: Correct spelling of 'discover?' .Maxime Devos
* doc/guix.texi (Base Services): Correct spelling of 'discover?'. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2020-12-03doc: Tweak wording of 'chicken-build-system' material.Ludovic Courtès
* doc/guix.texi (Build Systems): Fix spelling of "CHICKEN". Add xref to its web site. Tweak wording.
2020-12-03build-system: Add chicken-build-system.raingloom
* guix/build-system/chicken.scm: New file. * guix/build/chicken-build-system.scm: New file. * Makefile.am: Add them. * doc/guix.texi: Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-11-29doc: Document that source derivation builds can be checked.Maxim Cournoyer
It is a common mistake to modify an <origin> record that computes to a fixed-output derivation, forgetting to update its hash field, only to find out that a previously built source gets used instead. While there doesn't seem to be an obvious solution to this problem, we can at least document the fact that sources can be checked the same as other builds. * doc/guix.texi (Additional Build Options): Document that source derivation builds can be verified using --check.
2020-11-29processes: Add '--format' and the "normalized" format.John Soo
* guix/scripts/processes.scm (lock->recutils): New procedure. (daemon-session->recutils): Use it. (daemon-sessions->recutils, session-key->recutils) (session-scalars->normalized-record) (child-process->normalized-record) (daemon-sessions->normalized-record): New procedures. (session-rec-type, lock-rec-type, child-process-rec-type) (%available-formats): New variables. (list-formats): New procedure. (%options, show-help): Add '--format'. (%default-options): New variable. (guix-processes): Use 'parse-command-line' instead of 'args-fold*'. Honor the 'format' value in OPTIONS. * doc/guix.texi (Invoking guix processes): Document '--format'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-11-29processes: Put ChildProcess and ChildPID on separate lines.John Soo
* guix/scripts/processes.scm (daemon-session->recutils): Put child process information in separate fields. * doc/guix.texi (Invoking guix processes): Document change in output of 'guix processes'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-11-29doc: Document zabbix-agent hostname change.Oleg Pykhalov
This commit follows 8518a3692cbb9cd96d69c03e9de9ad6fdcfebbee. * doc/guix.texi (Monitoring Services)[zabbix-agent]: Set hostname to empty string.
2020-11-29Use substitute servers on the local network.Mathieu Othacehe
* guix/scripts/discover.scm: New file. * Makefile.am (MODULES): Add it. * nix/nix-daemon/guix-daemon.cc (options): Add "discover" option, (parse-opt): parse it, (main): start "guix discover" process when the option is set. * guix/scripts/substitute.scm (%local-substitute-urls): New variable, (substitute-urls): add it. * gnu/services/base.scm (<guix-configuration>): Add "discover?" field, (guix-shepherd-service): honor it. * doc/guix.texi (Invoking guix-daemon): Document "discover" option, (Base Services): ditto.
2020-11-29publish: Add advertising support.Mathieu Othacehe
* guix/scripts/publish.scm (%options): Add "--advertise" option. (show-help): Document it. (service-name): New procedure, (publish-service-type): new variable. (run-publish-server): Add "advertise?" and "port" parameters. Use them to publish the server using Avahi. (guix-publish): Pass the "advertise?" option to "run-publish-server". * gnu/services/base.scm (<guix-publish-configuration>): Add "advertise?" field. (guix-publish-shepherd-service): Honor it.
2020-11-29Add Avahi support.Mathieu Othacehe
* guix/avahi.scm: New file. * Makefile.am (MODULES): Add it. * configure.ac: Add Guile-Avahi dependency. * doc/guix.texi (Requirements): Document it. * gnu/packages/package-management.scm (guix)[native-inputs]: Add "guile-avahi", [propagated-inputs]: ditto. * guix/self.scm (specification->package): Add guile-avahi. (compiled-guix): Ditto.
2020-11-28doc: Fix another typo.Tobias Geerinckx-Rice
* doc/guix.texi (Database Services): Remove a duplicate ‘on’ from the memcached section.
2020-11-28Merge branch 'staging'Marius Bakke
2020-11-28doc: Fix typo.Marius Bakke
* doc/guix.texi (Database Services): Replace comma with full stop for Memcached documentation.
2020-11-28services: MySQL: Upgrade database schemas automatically.Marius Bakke
* gnu/services/databases.scm (<mysql-configuration>): Add AUTO-UPGRADE? field. (mysql-upgrade-wrapper, mysql-upgrade-shepherd-service, mysql-shepherd-services): New variables. (mysql-service-type): Use MYSQL-SHEPHERD-SERVICES instead of MYSQL-SHEPHERD-SERVICE. * doc/guix.texi (Database Services): Document the AUTO-UPGRADE? field of MYSQL-SERVICE-TYPE. * gnu/tests/databases.scm (run-mysql-test): Test that mysql_upgrade has run.
2020-11-28services: MySQL: Make the socket configurable.Marius Bakke
* gnu/services/databases.scm (<mysql-configuration>): Add SOCKET field. (mysql-configuration-file): Adjust accordingly. * doc/guix.texi (Database Services): Likewise.
2020-11-28services: MySQL: Bind to localhost only by default.Marius Bakke
* gnu/services/databases.scm (<mysql-configuration>): Add BIND-ADDRESS field. (mysql-configuration-file): Adjust accordingly. * doc/guix.texi (Database Services): Document it.
2020-11-28services: MySQL: Deprecate 'mysql-service'.Marius Bakke
* gnu/services/databases.scm (mysql-service): Define in terms of DEFINE-DEPRECATED. * gnu/tests/databases.scm (%mysql-os): Adjust accordingly. * doc/guix.texi (Database Services): Adjust the MariaDB/MySQL section to document MYSQL-SERVICE-TYPE instead of MYSQL-SERVICE. While at it, document the EXTRA-CONTENT field.
2020-11-28doc: Update mcron example.Ludovic Courtès
This is a followup to 0468455e7d279c89ea3ad1b51935efb2b785ec47, which added mcron to %BASE-SERVICES. * doc/guix.texi (Scheduled Job Execution): Use 'simple-service'.
2020-11-28doc: Remove lzlib from the requirements.Ludovic Courtès
This is a followup to 4c0c65acfade63ce0549115d19db4b639c1e9992. * doc/guix.texi (Requirements): Remove lzlib.
2020-11-26Merge branch 'master' into stagingMarius Bakke
2020-11-26doc: Fix typo.Tobias Geerinckx-Rice
* doc/guix.texi (Version Control Services): Fix ‘trough’ typo. Reported by guixy on #guix.
2020-11-26Merge branch 'master' into stagingMarius Bakke
2020-11-26doc: Tweak LVM-related info.Ludovic Courtès
* doc/guix.texi (Limitations): Remove LVM support. (Mapped Devices): Add link the to LVM web site. Tweak wording.
2020-11-26mapped-devices: Add 'lvm-device-mapping'.Mikhail Tsykalov
* gnu/system/mapped-devices.scm (lvm-device-mapping, open-lvm-device, close-lvm-device): New variables. * gnu/tests/install.scm (%lvm-separate-home-os, %lvm-separate-home-os-source, %lvm-separate-home-installation-script, %test-lvm-separate-home-os): New variables. * gnu/system/linux-initrd.scm (raw-initrd): Add (srfi srfi-1) to initrd expression. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-11-26mapped-devices: Allow target to be list of strings.Mikhail Tsykalov
* gnu/system/mapped-devices.scm (<mapped-device>): Rename constructor to %mapped-device. [target]: Remove field. [targets]: New field. Adjust users. (mapped-device-compatibility-helper, mapped-device): New macros. (mapped-device-target): New deprecated procedure. Signed-off-by: Ludovic Courtès <ludo@gnu.org>