summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)Author
2018-01-21doc: Improve ‘fix-runpath’ description.Tobias Geerinckx-Rice
* doc/guix.texi (Build Systems): Re-write ‘fix-runpath’ documentation entirely. Just fixing the typos didn't do much.
2018-01-21services: Missing services are automatically instantiated.Ludovic Courtès
This simplifies OS configuration: users no longer need to be aware of what a given service depends on. See the discussion at <https://lists.gnu.org/archive/html/guix-devel/2018-01/msg00114.html>. * gnu/services.scm (missing-target-error): New procedure. (service-back-edges): Use it. (instantiate-missing-services): New procedure. * gnu/system.scm (operating-system-services): Call 'instantiate-missing-services'. * tests/services.scm ("instantiate-missing-services") ("instantiate-missing-services, no default value"): New tests. * gnu/services/version-control.scm (cgit-service-type)[extensions]: Add FCGIWRAP-SERVICE-TYPE. * gnu/tests/version-control.scm (%cgit-os): Remove NGINX-SERVICE-TYPE and FCGIWRAP-SERVICE-TYPE instances. * doc/guix.texi (Log Rotation): Remove 'mcron-service-type' in example. (Miscellaneous Services): Remove 'nginx-service-type' and 'fcgiwrap-service-type' in Cgit example.
2018-01-20build: Declare “doc/guix.texi“ dependencies.Mathieu Lirzin
Fixes <https://bugs.gnu.org/29727>. * doc/local.mk (%C%_guix_TEXINFOS): New variable containing files included by “doc/guix.texi”. (EXTRA_DIST): Remove ‘.texi’ files. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2018-01-19gnu: Consistently Write ‘file system(s)’.Tobias Geerinckx-Rice
It is the GNU way. * doc/guix.texi (Build Systems, DNS Services): Write ‘file system(s)’. * gnu/build/vm.scm (create-ext-file-system, create-fat-file-system): Likewise. * gnu/packages/backup.scm (dirvish, rsnapshot)[description]: Likewise. * gnu/packages/check.scm (python-testpath)[description]: Likewise. * gnu/packages/disk.scm (pydf)[description]: Likewise. * gnu/packages/file-systems.scm (disorderfs)[synopsis, description]: Likewise. (glusterfs)[description]: Likewise. * gnu/packages/haskell.scm (ghc-directory, ghc-system-fileio-bootstrap) (ghc-system-fileio)[synopsis]: Likewise. (ghc-fsnotify)[description]: Likewise. * gnu/packages/linux.scm (proot)[description]: Likewise. (jmtpfs)[synopsis, description]: Likewise. * gnu/packages/mate.scm (caja, caja-extensions)[description]: Likewise. * gnu/packages/storage.scm (ceph)[description]: Likewise. * gnu/packages/sync.scm (lsyncd)[description]: Likewise. * gnu/packages/syncthing.scm (syncthing)[synopsis]: Likewise. (go-github-com-zillode-notify)[description]: Likewise. * gnu/services/nfs.scm (pipefs-service-type): Likewise. * guix/scripts/system.scm (perform-action): Likewise.
2018-01-17doc: Suggest running guix-daemon with 'sudo -E'.Ludovic Courtès
Suggested by Martin H. <maze@strahlungsfrei.de>. * doc/contributing.texi (Running Guix Before It Is Installed): Suggest 'sudo -E'.
2018-01-17docs: Fix typo in qemu-binfmt example.Danny Milosavljevic
* doc/guix.texi (Virtualization Services): Document 'guix-support?' properly.
2018-01-17gnu: services: web: Add service for httpd.Christopher Baines
* gnu/services/web.scm (<httpd-module>, <httpd-config-file>, <httpd-virtualhost> <httpd-configuration>): New record types. (%default-httpd-modules, %httpd-accounts, httpd-service-type): New variables. (httpd-shepherd-services, httpd-activation, httpd-process-extensions): New procedures. * gnu/tests/web.scm (run-httpd-test): New procedure. (%httpd-os, %tests-httpd): New variables. * doc/guix.texi (Web Services): Document the Apache HTTP Server.
2018-01-16doc: Fix typo.Ludovic Courtès
Reported by Nicolas Goaziou. * doc/guix.texi (Invoking guix archive): Fix typo.
2018-01-15doc: Deprecate 'bitlbee-service' procedure.Ludovic Courtès
* gnu/services/messaging.scm (bitlbee-service): Mark as deprecated. * doc/guix.texi (Messaging Services): Document 'bitlbee-service-type' and 'bitlbee-configuration'. Remove 'bitlbee-service'.
2018-01-15services: bitlbee: Move to (gnu services messaging).Ludovic Courtès
* gnu/services/networking.scm (<bitlbee-configuration>) (bitlbee-shepherd-service, %bitlbee-accounts, %bitlbee-activation) (bitlbee-service-type, bitlbee-service): Move to... * gnu/services/messaging.scm: ... here. * doc/guix.texi (Networking Services): Move 'bitlbee-service' doc to... (Messaging Services): ... here.
2018-01-15doc: Connect "guix archive", "guix pack", and co.Ludovic Courtès
* doc/guix.texi (Invoking guix pack): Add xrefs to "guix publish", "guix copy", and "guix archive". (Invoking guix archive): Add xref to "guix pack".
2018-01-14doc: Correct documentation of NGINX-LOCATION-CONFIGURATION.Andreas Enge
* doc/guix.texi (Web Services): The body of an NGINX-LOCATION-CONFIGURATION is a list of strings and not a string.
2018-01-11services: qemu-binfmt: Extend guix-daemon with extra chroot directories.Ludovic Courtès
Fixes <https://bugs.gnu.org/20239>. * gnu/services/virtualization.scm (<qemu-binfmt-configuration>)[guix-support?]: New field. (qemu-binfmt-guix-chroot): New procedure. (qemu-binfmt-service-type)[extensions]: Add GUIX-SERVICE-TYPE. * doc/guix.texi (Virtualization Services): Document 'guix-support?'. (Additional Build Options): Mention binfmt_misc and offloading under '--system'.
2018-01-11services: Add qemu-binfmt.Ludovic Courtès
* gnu/services/virtualization.scm (<qemu-platform>): New record type. (bv): New macro. (%i386, %i486, %alpha, %arm, %armeb, %sparc, %sparc32plus) (%ppc, %ppc64, %ppc64le, %m68k, %mips, %mipsel, %mipsn32el) (%mips64, %mips64el, %sh4, %sh4eb, %s390x, %aarch64, %hppa) (%qemu-platforms): New variables. (lookup-qemu-platforms): New procedure. (<qemu-binfmt-configuration>): New record type. (qemu-platform->binfmt): New procedures. (%binfmt-mount-point, %binfmt-register-file, %binfmt-file-system) (qemu-binfmt-service-type): New variables. (qemu-binfmt-shepherd-services): New procedures. * doc/guix.texi (Virtualization Services): Add "Transparent Emulation with QEMU" heading. binfmt fixlet
2018-01-11doc: Fix typo in 'guix environment' example.Ludovic Courtès
* doc/guix.texi (Invoking guix environment): Add missing @ in example.
2018-01-08gnu: services: Add darkstat service.宋文武
* gnu/services/monitoring.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Monitoring Services): Document it.
2018-01-08services: guix: Add 'log-compression' option.Ludovic Courtès
* gnu/services/base.scm (<guix-configuration>)[log-compression]: New field. (guix-shepherd-service): Use 'match-record' instead of 'match'. Honor 'log-compression'. * doc/guix.texi (Base Services): Document 'log-compression'.
2018-01-07publish: Publish build logs.Ludovic Courtès
* guix/scripts/publish.scm (render-log-file): New procedure. (make-request-handler): Add "log" case. * tests/publish.scm ("/log/NAME") ("/log/NAME not found"): New tests. * doc/guix.texi (Invoking guix publish): Document /log URLs.
2018-01-07doc: Mark zlib as mandatory, libbz2 as optional.Ludovic Courtès
* doc/guix.texi (Requirements): Move zlib to mandatory and libbz2 to optional. * README: Ditto.
2018-01-07daemon: Add gzip log compression.Ludovic Courtès
* nix/nix-daemon/guix-daemon.cc (GUIX_OPT_LOG_COMPRESSION): New macro. (options): Mark "disable-log-compression" as hidden and add "log-compression". (parse_opt): Handle GUIX_OPT_LOG_COMPRESSION. * nix/libstore/build.cc (DerivationGoal): Add 'gzLogFile'. (openLogFile): Initialize it when 'logCompression' is COMPRESSION_GZIP. (closeLogFile, handleChildOutput): Honor 'gzLogFile'. * nix/libstore/globals.hh (Settings)[compressLog]: Remove. [logCompression]: New field. (CompressionType): New enum. * nix/libstore/globals.cc (Settings::Settings): Initialize it. (update): Remove '_get' call for 'compressLog'. * nix/local.mk (guix_daemon_LDADD, guix_register_LDADD): Add -lz. * guix/store.scm (log-file): Handle '.gz' log files. * tests/guix-daemon.sh: Add test with '--log-compression=gzip'. * doc/guix.texi (Invoking guix-daemon): Adjust accordingly. * config-daemon.ac: Check for libz and zlib.h.
2018-01-06doc: Describe Wayland status.Rutger Helling
* doc/guix.texi (Desktop Services): Add a paragraph about the current status of Wayland in Guix.
2017-12-30doc: Fix typo.Mark H Weaver
* doc/guix.texi (Desktop Services): "orMATE" --> "or MATE".
2017-12-30gnu: services: Add MATE desktop service.ng0
* gnu/services/desktop.scm (<mate-desktop-configuration>, mate-desktop-service-type): New variable. (mate-desktop-service): New public variable. * doc/guix.texi (Desktop Services): Document the service. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2017-12-29services: networking: Add a dependency override mechanism to ↵Marius Bakke
<static-networking>. * gnu/services/networking.scm (<static-networking>)[requirement]: New field. (static-networking-shepherd-service): Don't override requirement for loopback. (static-networking-service): Expose 'requirement' parameter. Default to UDEV. * gnu/services/base.scm (%base-services): Add (requirement '()) for loopback service. * doc/guix.texi (Networking Services): Document it.
2017-12-26doc: Fix typo.Tobias Geerinckx-Rice
* doc/guix.texi (Application Setup): Transpose words.
2017-12-24gnu, doc: Use HTTPS for cran.r-project.org home pages.Tobias Geerinckx-Rice
* gnu/packages/bioinformatics.scm (r-sparql, r-acsnminer, r-gkmsvm) (r-maldiquant, r-gprofiler)[home-page]: Use HTTPS. * gnu/packages/cran.scm (r-colorspace, r-auc, r-calibrate, r-shape) (r-compare, r-proxy, r-sp, r-rmtstat, r-lmtest, r-inline, r-bbmle) (r-lpsolve, r-energy, r-suppdists, r-ksamples, r-cvst, r-drr, r-prodlim) (r-ddalpha, r-rcpproll, r-ipred, r-psych, r-truncnorm, r-rsolnp, r-laeken) (r-vcd, r-ica, r-scatterplot3d)[home-page]: Likewise. * gnu/packages/machine-learning.scm (r-adaptivesparsity, r-kernlab) [home-page]: Likewise. * gnu/packages/maths.scm (r-quadprog, r-pracma)[home-page]: Likewise. * gnu/packages/statistics.scm (r-boot, r-cluster, r-codetools, r-foreign) (r-kernsmooth, r-nlme, r-mgcv, r-rpart, r-dichromat, r-estimability) (r-pheatmap, r-labeling, r-magrittr, r-munsell, r-rcolorbrewer, r-sendmailr) (r-gdtools, r-acepack, r-formula, r-locfit, r-chron, r-coda, r-backports) (r-brew, r-commonmark, r-rstudioapi, r-plotrix, r-gridbase, r-bitops) (r-catools, r-xnomial, r-lambda-r, r-whoreadsthis, r-futile-options) (r-futile-logger, r-segmented, r-snow, r-iterators, r-foreach, r-doparallel) (r-domc, r-irlba, r-registry, r-e1071, r-bigmemory-sri, r-r-methodss3) (r-tidyselect, r-base64, r-runit, r-sfsmisc, r-gtools, r-gdata, r-gplots) (r-ztable, r-vipor, r-sourcetools, r-statmod, r-compquadform, r-mixtools) (r-fastica, r-diptest, r-modeltools, r-flexmix, r-deoptimr, r-pcapp) (r-rrcov, r-fit-models, r-robust, r-trimcluster, r-fpc, r-fnn) (r-modelmetrics, r-nloptr, r-lme4, r-tclust, r-lubridate)[home-page]: Likewise. * gnu/packages/web.scm (r-htmltools, r-hwriter, r-rjson, r-rook)[home-page]: Likewise. * doc/guix.texi (Invoking guix import, Invoking guix refresh): Likewise.
2017-12-24services: messaging: Use HTTPS for prosody.im URLs.Tobias Geerinckx-Rice
* gnu/services/messaging.scm (prosody-configuration): Use HTTPS whenever referring to prosody.im URLs in documentation. * doc/guix.texi (Messaging Services): Likewise.
2017-12-23doc: Properly escape brackets.Tobias Geerinckx-Rice
This fixes a build failure reported by Catonano <catonano@gmail.com>. * doc/guix.texi (Mail Services): Escape ‘{’ and ‘}’ everywhere.
2017-12-23gnu: dovecot: Update to 2.3.0.Tobias Geerinckx-Rice
* gnu/packages/mail.scm (dovecot): Update to 2.3.0. * gnu/services/mail.scm (dovecot-configuration)[director-doveadm-port] [ssl-parameters-regenerate]: Delete fields. [ssl-protocols]: Rename to... [ssl-min-protocol]: ...this. [mail-log-prefix, mdbox-rotate-size, ssl-cipher-list, imap-logout-format]: Update default values. * doc/guix.texi (Mail Services): Reflect the above changes to the service.
2017-12-23doc: Add "/guix" after LOCALSTATEDIR.Ludovic Courtès
Fixes <https://bugs.gnu.org/29813>. Reported by Martin Castillo <castilma@uni-bremen.de>. * doc/guix.texi (Invoking guix-daemon, Invoking guix package): Add missing "/guix" after LOCALSTATEDIR.
2017-12-23guix build: Support '--with-source=PACKAGE@VERSION=URI'.Ludovic Courtès
* guix/scripts/build.scm (numeric-extension?, tarball-base-name): New procedures, formerly in 'package-with-source'. (transform-package-source)[new-sources]: Look for '=' in URI. Each element of the list of now a (PKG VERSION SOURCE) tuple. Pass VERSION to 'package-with-source'. (package-with-source): Add 'version' parameter and honor it. * tests/scripts-build.scm ("options->transformation, with-source, PKG=URI") ("options->transformation, with-source, PKG@VER=URI"): New tests. * doc/guix.texi (Package Transformation Options): Document the new forms.
2017-12-22services: urandom-seed: Deprecate the 'urandom-seed-service' procedure.Ludovic Courtès
* gnu/services/base.scm (urandom-seed-service-type)[default-value]: New field. (urandom-seed-service): Mark as deprecated. (%base-services): Use URANDOM-SEED-SERVICE-TYPE directly. * gnu/services/base.scm (%base-services): * doc/guix.texi (Base Services): Document 'urandom-seed-service-type' instead of 'urandom-seed-service'.
2017-12-22doc: Document fixed-output derivations.Ludovic Courtès
* doc/guix.texi (Derivations): Add paragraph on fixed-output derivations.
2017-12-19services: urandom-seed: Try using a HWRNG to seed the Linux CRNG at boot.Leo Famulari
* gnu/services/base.scm (urandom-seed-shepherd-service): Try to read from '/dev/hwrng' at boot, as a supplement to any saved random seed. * doc/guix.texi (Base Services): Document the new feature.
2017-12-18doc: Clarify treatment of the root account.Ludovic Courtès
* doc/guix.texi (operating-system Reference): Clarify the situation of UID 0.
2017-12-18services: nginx: Allow to add raw content to the server blocks.Clément Lassieur
* doc/guix.texi (Web Services): Document 'raw-content'. * gnu/services/web.scm (<nginx-server-configuration>)[raw-content]: New field. (emit-nginx-server-config): Add it.
2017-12-18services: nginx: Replace 'http-port' and 'https-port' with 'listen'.Clément Lassieur
* doc/guix.texi (Web Services, Version Control Services): Update accordingly. * gnu/services/certbot.scm (certbot-nginx-server-configurations): Likewise. * gnu/services/version-control.scm (%cgit-configuration-nginx): Likewise. * gnu/services/web.scm (<nginx-server-configuration>, emit-nginx-server-config): Likewise. * gnu/tests/version-control.scm (%cgit-configuration-nginx, %git-nginx-configuration): Likewise. * gnu/tests/web.scm (%nginx-servers, %php-fpm-nginx-server-blocks): Likewise.
2017-12-18doc: Fix typo.Martin Castillo
* doc/guix.texi: remove double occurence of generations. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2017-12-16guix: offload: Add "status" sub-command.Ricardo Wurmus
* guix/scripts/offload.scm (check-machine-status): New procedure. (guix-offload): Call it when the argument is "status". * doc/guix.texi (Daemon Offload Setup): Document it.
2017-12-15etc: Add snippets.Ricardo Wurmus
* etc/snippets/scheme-mode/guix-cvs-reference, etc/snippets/scheme-mode/guix-git-reference, etc/snippets/scheme-mode/guix-hg-reference, etc/snippets/scheme-mode/guix-origin, etc/snippets/scheme-mode/guix-package, etc/snippets/scheme-mode/guix-svn-reference, etc/snippets/text-mode/guix-commit-message-add-package, etc/snippets/text-mode/guix-commit-message-update-package: New files. * doc/contributing.texi (The Perfect Setup): Document snippets.
2017-12-15scripts: system: Add --expression option.Mathieu Othacehe
* guix/scripts/system.scm (show-help): Add expression option. (%options): Ditto. (guix-system): Allow commands taking a file as an argument to use an expression instead. (process-action): Read operating-system from expression or file. * doc/guix.texi (Invoking guix system): Introduce the expression option.
2017-12-15doc: Fix typo.Oleg Pykhalov
* doc/guix.texi (DNS Services): Fix knot-configuration.
2017-12-12doc: Fix typo.Tobias Geerinckx-Rice
* doc/guix.texi: Add missing ‘@*’ to copyright headers.
2017-12-12gnu: services: Add php-fpm.nee
* gnu/services/web.scm (<php-fpm-configuration>, <php-fpm-process-manager-configuration>): New record types. (php-fpm-configuration?, php-fpm-process-manager-configuration?, php-fpm-service-type, nginx-php-location): New procedures. * doc/guix.texi (Web-Services): Document php-fpm service. * gnu/tests/web.scm: Add php-fpm system test. Signed-off-by: Christopher Baines <mail@cbaines.net>
2017-12-11services: web: Add support for configuring the nginx server names hash.Christopher Baines
The nginx service can fail to start if the server names hash bucket size is too small, which can happen on some systems, and when using QEMU, depending on the CPU. * gnu/services/web.scm (<nginx-configuration>): Add server-names-hash-bucket-size and server-names-hash-bucket-max-size. (default-nginx-config): Add support for the new hash bucket size parameters. (nginx-service, nginx-activation): Pass the new hash bucket size parameters through to the default-nginx-config procedure. * doc/guix.texi (Web Services): Document the new hash bucket size parameters.
2017-12-11services: web: Remove default certificate and key files for nginx.Christopher Baines
If nginx is configured with a ssl-certificate file, and ssl-certificate-key, it will fail to start unless these exist. To avoid this happening, change the default to #f. * gnu/services/web.scm (<nginx-server-configuration>) [ssl-certificate,ssl-certificate-key]: Set the defaults to #f. * gnu/tests/web.scm (%nginx-servers): Remove redundant nginx-server-configuration fields. * doc/guix.texi (Web Services): Update examples and documentation.
2017-12-08doc: Fix typo.Tobias Geerinckx-Rice
* doc/guix.texi (Package Management): Fix typo.
2017-12-07doc: Update metacpan.org API endpoint.Tobias Geerinckx-Rice
* doc/guix.texi (Invoking guix import): Match the URI actually used by the updater.
2017-12-06gnu, doc, tests: Use ‘bootloader-configuration’ everywhere.Tobias Geerinckx-Rice
* doc/guix.texi (Proceeding with the Installation): Replace the old-style ‘grub-configuration’ with the newer ‘bootloader-configuration’ syntax. * gnu/system/examples/vm-image.tmpl: Likewise. * gnu/system/install.scm (installation-os): Likewise. * gnu/tests.scm (%simple-os): Likewise. * gnu/tests/install.scm (%minimal-os, %minimal-os-on-vda, %separate-home-os) (%separate-store-os, %raid-root-os, %encrypted-root-os, %btrfs-root-os): Likewise. * gnu/tests/nfs.scm (%base-os): Likewise. * tests/guix-system.scm (OS_BASE, make_user_config): Likewise. * tests/system.scm (%os, %os-with-mapped-device): Likewise.
2017-12-04doc: Mention berlin.guixsd.org.Ludovic Courtès
* doc/guix.texi (Substitute Server Authorization): Add note about berlin.guixsd.org. Nitpick.