summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Expand)Author
2017-12-24services: messaging: Use HTTPS for prosody.im URLs....* gnu/services/messaging.scm (prosody-configuration): Use HTTPS whenever referring to prosody.im URLs in documentation. * doc/guix.texi (Messaging Services): Likewise. Tobias Geerinckx-Rice
2017-12-23doc: Properly escape brackets....This fixes a build failure reported by Catonano <catonano@gmail.com>. * doc/guix.texi (Mail Services): Escape ‘{’ and ‘}’ everywhere. Tobias Geerinckx-Rice
2017-12-23gnu: dovecot: Update to 2.3.0....* 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. Tobias Geerinckx-Rice
2017-12-23doc: Add "/guix" after LOCALSTATEDIR....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. Ludovic Courtès
2017-12-23guix build: Support '--with-source=PACKAGE@VERSION=URI'....* 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. Ludovic Courtès
2017-12-22services: urandom-seed: Deprecate the 'urandom-seed-service' procedure....* 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'. Ludovic Courtès
2017-12-22doc: Document fixed-output derivations....* doc/guix.texi (Derivations): Add paragraph on fixed-output derivations. Ludovic Courtès
2017-12-19services: urandom-seed: Try using a HWRNG to seed the Linux CRNG at boot....* 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. Leo Famulari
2017-12-18doc: Clarify treatment of the root account....* doc/guix.texi (operating-system Reference): Clarify the situation of UID 0. Ludovic Courtès
2017-12-18services: nginx: Allow to add raw content to the server blocks....* 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. Clément Lassieur
2017-12-18services: nginx: Replace 'http-port' and 'https-port' with 'listen'....* 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. Clément Lassieur
2017-12-18doc: Fix typo....* doc/guix.texi: remove double occurence of generations. Signed-off-by: Ludovic Courtès <ludo@gnu.org> Martin Castillo
2017-12-16guix: offload: Add "status" sub-command....* 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. Ricardo Wurmus
2017-12-15etc: Add snippets....* 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. Ricardo Wurmus
2017-12-15scripts: system: Add --expression option....* 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. Mathieu Othacehe
2017-12-15doc: Fix typo....* doc/guix.texi (DNS Services): Fix knot-configuration. Oleg Pykhalov
2017-12-12doc: Fix typo....* doc/guix.texi: Add missing ‘@*’ to copyright headers. Tobias Geerinckx-Rice
2017-12-12gnu: services: Add php-fpm....* 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> nee
2017-12-11services: web: Add support for configuring the nginx server names hash....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. Christopher Baines
2017-12-11services: web: Remove default certificate and key files for nginx....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. Christopher Baines
2017-12-08doc: Fix typo....* doc/guix.texi (Package Management): Fix typo. Tobias Geerinckx-Rice
2017-12-07doc: Update metacpan.org API endpoint....* doc/guix.texi (Invoking guix import): Match the URI actually used by the updater. Tobias Geerinckx-Rice
2017-12-06gnu, doc, tests: Use ‘bootloader-configuration’ everywhere....* 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. Tobias Geerinckx-Rice
2017-12-04doc: Mention berlin.guixsd.org....* doc/guix.texi (Substitute Server Authorization): Add note about berlin.guixsd.org. Nitpick. Ludovic Courtès
2017-12-04maint: Add the '.iso' extension to installation images....* Makefile.am (release): Add the '.iso' suffix to image files. * doc/guix.texi (USB Stick and DVD Installation): Adjust accordingly. Ludovic Courtès
2017-12-04doc: Merge "USB Stick Installation" and "DVD Installation"....* doc/guix.texi (USB Stick Installation): Rename to... (USB Stick and DVD Installation): ... this. Merge contents with... (DVD Installation): ... this node. Remove. Ludovic Courtès
2017-12-03doc: Link to work on bootstrapping....* doc/guix.texi (Reducing the Set of Bootstrap Binaries): New section. Ludovic Courtès
2017-11-30doc: Update the example VCS snapshot package definition....In commit ee17a9e06e636400e3354796a42ac445dbcc8f96, the helpers git-version and git-file-name removed the need to build version and file name strings manually for packages that use VCS snapshots. doc/guix.texi (Version Numbers): Use git-version and git-file-name. Kei Kebreau
2017-11-30build-system: Add scons-build-system....* guix/build-system/scons.scm: New file. * guix/build/scons-build-system.scm: New file. * Makefile.am (MODULES): Register them. * doc/guix.texi (Build Systems): Add scons-build-system. Arun Isaac
2017-11-30doc: Give the absolute file name of 'hydra.gnu.org.pub' in snippets....* doc/guix.texi (Substitute Server Authorization): Give the absolute file name of 'hydra.gnu.org.pub' in the snippet. Ludovic Courtès
2017-11-29gexp: 'compiled-modules' disables deprecation warnings by default....This avoids repeated deprecation messages, particularly while running 'guix system build' or similar. * guix/gexp.scm (gexp->derivation): Add #:deprecation-warnings. Pass it to 'compiled-modules'. (compiled-modules): Add #:deprecation-warnings and honor it. * doc/guix.texi (G-Expressions): Update 'gexp->derivation' documentation. * guix/packages.scm (patch-and-repack): Pass #:deprecation-warnings #t. Ludovic Courtès
2017-11-28services: Add Git HTTP(S) service support....* doc/guix.texi (Version Control Services): Add documentation on the HTTP backend for git. * gnu/services/version-control.scm (<git-http-configuration>): New data type. (git-http-nginx-location-configuration): New helper function. Signed-off-by: Ludovic Courtès <ludo@gnu.org> Andy Wingo
2017-11-28doc: Create "Version Control Services" section....* doc/guix.texi (Version Control Services): Move to its own node. Signed-off-by: Ludovic Courtès <ludo@gnu.org> Andy Wingo
2017-11-28services: Add certbot service....* gnu/services/certbot.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add new file. * doc/guix.texi (Certificate Services): New section. Signed-off-by: Ludovic Courtès <ludo@gnu.org> Andy Wingo
2017-11-28services: xorg: Remove WindowMaker as a default fallback....* gnu/services/xorg.scm (xinitrc)[builder](system-profile) (user-profile): New variables. (xsession-command, find-session): New procedures. When FALLBACK-SESSION is #f, find a valid session at run time. * doc/guix.texi (X Window): Adjust accordingly, and insist that one or more window managers must be installed. Ludovic Courtès
2017-11-28services: xorg: Document 'slim-configuration' and deprecate 'slim-service'....* gnu/services/xorg.scm (<slim-configuration>): Provide default values for all fields. (slim-service-type)[default-value]: New field. * doc/guix.texi (X Window): Remove 'slim-service' documentation. Document 'slim-service-type' and 'slim-configuration'. * gnu/services/desktop.scm (%desktop-services): Use 'slim-service-type'. Ludovic Courtès
2017-11-28services: xorg: Allow users to specify a list of modules....* gnu/services/xorg.scm (%default-xorg-fonts): New variable. (xorg-configuration-file): Add #:modules and #:fonts. Rewrite to return a 'computed-file' that honors MODULES and FONTS. (xorg-wrapper): Pass #:modules to 'xorg-configuration-file'. (xorg-start-command): Add #:fonts. Pass #:fonts and #:modules to 'xorg-configuration-file'. * doc/guix.texi (X Window): Adjust documentation of 'xorg-start-command' and 'xorg-configuration-file'. Ludovic Courtès
2017-11-28services: configuration: Show default values of list types....* doc/guix.texi (Messaging Services): Regenerate it. * gnu/services/configuration.scm (show-default?): Check VAL rather than DEFAULT. * gnu/services/messaging.scm (show-default?): Check VAL rather than DEFAULT. (prosody-configuration)[modules-enabled]: Remove default value from docstring. Clément Lassieur
2017-11-26services: prosody: Add support for disable-sasl-mechanisms....* doc/guix.texi (Messaging Services): Update accordingly. * gnu/services/messaging.scm (prosody-configuration)[disable-sasl-mechanisms]: New field. Clément Lassieur
2017-11-26services: prosody: Allow to add raw content to the config file....* doc/guix.texi (Messaging Services): Update accordingly. * gnu/services/messaging.scm (prosody-configuration)[raw-content]: New field. (raw-content?, serialize-raw-content): New procedures. Clément Lassieur
2017-11-26services: prosody: Add support for http-max-content-size....* doc/guix.texi (Messaging Services): Update accordingly. * gnu/services/messaging.scm (prosody-configuration)[http-max-content-size]: New field. Clément Lassieur
2017-11-26services: prosody: Add support for http-external-url....* doc/guix.texi (Messaging Services): Update accordingly. * gnu/services/messaging.scm (prosody-configuration)[http-external-url]: New field. Clément Lassieur
2017-11-26services: prosody: Adapt to Prosody 0.10.0....* doc/guix.texi (Messaging Services): Add "mam" as a module example. Document 'prosodyctl check'. Replace 'prosodyctl cert request' with 'prosodyctl cert import'. Regenerate it. * gnu/services/messaging.scm (serialize-module-list): Remove "posix" from the default modules list because it is now automatically loaded. (ssl-configuration)[key, certificate]: Remove them because they are now automatically located. Fix their docstrings. (%default-modules-enabled): Add "carbons" and "blocklist". (prosody-configuration)[certificates]: Set default directory from which certificates/keys will be automatically located. Clément Lassieur
2017-11-24doc: Fix typo....* doc/guix.texi (Bootloader Configuration): Fix ‘choosen’ typo. Tobias Geerinckx-Rice
2017-11-23doc: Update package count....* doc/guix.texi (Limitations): Update package count. Ludovic Courtès
2017-11-21doc: Split the "Substitutes" section into subsections....* doc/guix.texi (Substitutes): Move information into sections, and create one new subsection regarding substitution failure. (Top): In the detailed listing, add entries for the new subsections. (Official Substitute Server): Move info about hydra here. Add information that explains when substitutes are enabled by default. (Substitute Server Authorization): Move information about how to enable or disable substitutes here. (Substitute Authentication): Move information about how Guix authenticates substitutes here. (Proxy Settings): Move information about how to download substitutes via proxy here. (Substitution Failure): New section. Add information about how Guix handles substitution failure. Be extra clear about behavior concerning --fallback. (On Trusting Binaries): Move information about trusting binaries here. (Invoking guix-daemon): Remove an incorrect statement about when substitutes are enabled by default. (Common Build Options): Add cross-references for the --fallback option. Co-authored-by: George Clemmer <myglc2@gmail.com> Chris Marusich
2017-11-20Add semicolon in commands that set GUIX_PROFILE....Fixes <https://bugs.gnu.org/28223>. Reported by Rosebud Uplink <Uplink.Introversion@outlook.com>. * doc/guix.texi (Binary Installation): Add missing semicolon after 'GUIX_PROFILE=' line. (Invoking guix package): Likewise. * gnu/system.scm (operating-system-etc-service)[profile]: Likewise. * guix/build/profiles.scm (build-etc/profile): Likewise. Ludovic Courtès
2017-11-17doc: Write "file system" instead of "partition" as appopriate....* doc/guix.texi (Preparing for Installation): Write "file system" instead of "partition" as appopriate. Marco van Hulten
2017-11-13services: guix: Remove dependency on 'lsof'....This is a followup to b8f59cdc20e9d83ce63523ef917e95fcee07f134: 'list-runtime-roots' no longer depends on 'lsof'. * gnu/services/base.scm (<guix-configuration>)[lsof]: Remove. (guix-shepherd-service): Adjust accordingly. * doc/guix.texi (Base Services): Adjust accordingly. * gnu/system.scm (%base-packages): Remove LSOF. Ludovic Courtès
2017-11-12doc: Better explain GC roots....Fixes <https://bugs.gnu.org/24194>. Reported by J. Eppler <j.eppler@openmailbox.org>. * doc/guix.texi (Invoking guix-daemon): Add index entries for GC roots. Add xref to "Invoking guix gc". (Invoking guix gc): Add the string "GC roots"; mention /var/guix/gcroots. (Additional Build Options): Add index entries. Better explain --root. (Invoking guix environment): Add xref to "Invoking guix gc". Ludovic Courtès