summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* gnu: services: Add wesnothd service.Arun Isaac2018-02-091-1/+34
| | | | | | * gnu/services/games.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Game Services): Document the service.
* etc: Add SELinux policy for the daemon.Ricardo Wurmus2018-02-071-1/+89
| | | | | | | * etc/guix-daemon.cil.in: New file. * Makefile.am (dist_selinux_policy_DATA): Define it. * configure.ac: Handle --with-selinux-policy-dir. * doc/guix.texi (SELinux Support): New section.
* doc: Document the 'upstream-name' property.Ludovic Courtès2018-02-051-0/+13
| | | | | | Reported by Hartmut Goebel <h.goebel@crazy-compilers.com>. * doc/guix.texi (Invoking guix refresh): Document 'upstream-name'.
* doc: guix-publish-configuration-ttl is in seconds.Tobias Geerinckx-Rice2018-02-041-3/+3
| | | | | * doc/guix.texi (Base Services): Document that guix-publish-configuration-ttl takes its value in seconds.
* etc: Add installation script.Ricardo Wurmus2018-01-301-0/+5
| | | | | | | | * etc/guix-install.sh: New file. * Makefile.am (EXTRA_DIST): Add it. * doc/guix.texi (Binary Installation): Mention it. Co-authored-by: sharlatan <sharlatanus@gmail.com>
* doc: Unconfuse file systems and partitions.Tobias Geerinckx-Rice2018-01-291-10/+10
| | | | | | | | | | Partitions can have their own labels and UUIDs (e.g. under GPT) that are unrelated to those of the contained file system. Confusing the two ends poorly. * doc/guix.scm (File Systems, Proceeding with the Installation) (Using the Configuration System, Initial RAM Disk): Substitute `file system' for `partition' when talking about labels and UUIDs.
* doc, gnu: Fix spelling of screen-things.Tobias Geerinckx-Rice2018-01-291-1/+1
| | | | | | * doc/guix.texi (X Window): Write 'screen locker' and 'screen saver' in prose. * gnu/services/xorg.scm (screen-locker-service): Likewise.
* doc: Fix SCREEN-LOCKER-SERVICE description.Tobias Geerinckx-Rice2018-01-291-1/+1
| | | | | * doc/guix.texi (X Window): Correct the documentation for the SCREEN-LOCKER-SERVICE procedure.
* doc: Replace a stale reference to a code snippet.Tobias Geerinckx-Rice2018-01-291-1/+1
| | | | | | | | The text refers to a snippet which has since been removed, but a suitable replacement is near. Use it. * doc/guix.texi (Using the Configuration System): Substitute bind for tcpdump.
* doc: Mention escpr in CUPS configuration example.Diego Nicola Barbato2018-01-281-4/+4
| | | | | | | | | Suggested by Danny Milosavljevic <dannym@scratchpost.org>. * doc/guix.texi (Printing Services): Mention how to add support for Epson printers to CUPS via escpr in the configuration example. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Improve ‘fix-runpath’ description.Tobias Geerinckx-Rice2018-01-211-7/+7
| | | | | * doc/guix.texi (Build Systems): Re-write ‘fix-runpath’ documentation entirely. Just fixing the typos didn't do much.
* services: Missing services are automatically instantiated.Ludovic Courtès2018-01-211-5/+2
| | | | | | | | | | | | | | | | | | | | | | | 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.
* build: Declare “doc/guix.texi“ dependencies.Mathieu Lirzin2018-01-201-3/+5
| | | | | | | | | | 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>
* gnu: Consistently Write ‘file system(s)’.Tobias Geerinckx-Rice2018-01-191-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | 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.
* doc: Suggest running guix-daemon with 'sudo -E'.Ludovic Courtès2018-01-171-2/+5
| | | | | | | Suggested by Martin H. <maze@strahlungsfrei.de>. * doc/contributing.texi (Running Guix Before It Is Installed): Suggest 'sudo -E'.
* docs: Fix typo in qemu-binfmt example.Danny Milosavljevic2018-01-171-1/+1
| | | | * doc/guix.texi (Virtualization Services): Document 'guix-support?' properly.
* gnu: services: web: Add service for httpd.Christopher Baines2018-01-171-2/+156
| | | | | | | | | | | | | * 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.
* doc: Fix typo.Ludovic Courtès2018-01-161-1/+1
| | | | | | Reported by Nicolas Goaziou. * doc/guix.texi (Invoking guix archive): Fix typo.
* doc: Deprecate 'bitlbee-service' procedure.Ludovic Courtès2018-01-151-12/+34
| | | | | | * gnu/services/messaging.scm (bitlbee-service): Mark as deprecated. * doc/guix.texi (Messaging Services): Document 'bitlbee-service-type' and 'bitlbee-configuration'. Remove 'bitlbee-service'.
* services: bitlbee: Move to (gnu services messaging).Ludovic Courtès2018-01-151-15/+19
| | | | | | | | | * 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.
* doc: Connect "guix archive", "guix pack", and co.Ludovic Courtès2018-01-151-1/+13
| | | | | | * doc/guix.texi (Invoking guix pack): Add xrefs to "guix publish", "guix copy", and "guix archive". (Invoking guix archive): Add xref to "guix pack".
* doc: Correct documentation of NGINX-LOCATION-CONFIGURATION.Andreas Enge2018-01-141-3/+4
| | | | | * doc/guix.texi (Web Services): The body of an NGINX-LOCATION-CONFIGURATION is a list of strings and not a string.
* services: qemu-binfmt: Extend guix-daemon with extra chroot directories.Ludovic Courtès2018-01-111-1/+45
| | | | | | | | | | | | 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'.
* services: Add qemu-binfmt.Ludovic Courtès2018-01-111-1/+58
| | | | | | | | | | | | | | | | | | | * 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
* doc: Fix typo in 'guix environment' example.Ludovic Courtès2018-01-111-1/+1
| | | | * doc/guix.texi (Invoking guix environment): Add missing @ in example.
* gnu: services: Add darkstat service.宋文武2018-01-081-0/+42
| | | | | | * gnu/services/monitoring.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Monitoring Services): Document it.
* services: guix: Add 'log-compression' option.Ludovic Courtès2018-01-081-0/+4
| | | | | | | | * 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'.
* publish: Publish build logs.Ludovic Courtès2018-01-071-0/+17
| | | | | | | | * 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.
* doc: Mark zlib as mandatory, libbz2 as optional.Ludovic Courtès2018-01-071-3/+3
| | | | | | * doc/guix.texi (Requirements): Move zlib to mandatory and libbz2 to optional. * README: Ditto.
* daemon: Add gzip log compression.Ludovic Courtès2018-01-071-4/+5
| | | | | | | | | | | | | | | | | | | | * 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.
* doc: Describe Wayland status.Rutger Helling2018-01-061-1/+9
| | | | | * doc/guix.texi (Desktop Services): Add a paragraph about the current status of Wayland in Guix.
* doc: Fix typo.Mark H Weaver2017-12-301-1/+1
| | | | * doc/guix.texi (Desktop Services): "orMATE" --> "or MATE".
* gnu: services: Add MATE desktop service.ng02017-12-301-7/+19
| | | | | | | | | | * 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>
* services: networking: Add a dependency override mechanism to ↵Marius Bakke2017-12-291-1/+4
| | | | | | | | | | <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.
* doc: Fix typo.Tobias Geerinckx-Rice2017-12-261-1/+1
| | | | * doc/guix.texi (Application Setup): Transpose words.
* gnu, doc: Use HTTPS for cran.r-project.org home pages.Tobias Geerinckx-Rice2017-12-241-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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.
* services: messaging: Use HTTPS for prosody.im URLs.Tobias Geerinckx-Rice2017-12-241-24/+24
| | | | | | * gnu/services/messaging.scm (prosody-configuration): Use HTTPS whenever referring to prosody.im URLs in documentation. * doc/guix.texi (Messaging Services): Likewise.
* doc: Properly escape brackets.Tobias Geerinckx-Rice2017-12-231-2/+2
| | | | | | This fixes a build failure reported by Catonano <catonano@gmail.com>. * doc/guix.texi (Mail Services): Escape ‘{’ and ‘}’ everywhere.
* gnu: dovecot: Update to 2.3.0.Tobias Geerinckx-Rice2017-12-231-21/+8
| | | | | | | | | | | * 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.
* doc: Add "/guix" after LOCALSTATEDIR.Ludovic Courtès2017-12-231-2/+2
| | | | | | | | 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.
* guix build: Support '--with-source=PACKAGE@VERSION=URI'.Ludovic Courtès2017-12-231-5/+11
| | | | | | | | | | | | | * 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.
* services: urandom-seed: Deprecate the 'urandom-seed-service' procedure.Ludovic Courtès2017-12-221-2/+2
| | | | | | | | | | * 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'.
* doc: Document fixed-output derivations.Ludovic Courtès2017-12-221-0/+8
| | | | | * doc/guix.texi (Derivations): Add paragraph on fixed-output derivations.
* services: urandom-seed: Try using a HWRNG to seed the Linux CRNG at boot.Leo Famulari2017-12-191-1/+3
| | | | | | * 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.
* doc: Clarify treatment of the root account.Ludovic Courtès2017-12-181-0/+3
| | | | | * doc/guix.texi (operating-system Reference): Clarify the situation of UID 0.
* services: nginx: Allow to add raw content to the server blocks.Clément Lassieur2017-12-181-0/+3
| | | | | | * 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.
* services: nginx: Replace 'http-port' and 'https-port' with 'listen'.Clément Lassieur2017-12-181-11/+9
| | | | | | | | | | | * 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.
* doc: Fix typo.Martin Castillo2017-12-181-1/+0
| | | | | | * doc/guix.texi: remove double occurence of generations. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* guix: offload: Add "status" sub-command.Ricardo Wurmus2017-12-161-0/+9
| | | | | | * 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.
* etc: Add snippets.Ricardo Wurmus2017-12-151-0/+28
| | | | | | | | | | | | * 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.