summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2021-06-18doc: Clarify Git commit signing; fix typo.Ludovic Courtès
Suggested by Maxime Devos <maximedevos@telenet.be> and Julien Lepiller <julien@lepiller.eu>. * doc/contributing.texi (Commit Access): Clarify Git commit signing setup and fix typo.
2021-06-18doc: Explain more reasons for commit revocation.Ludovic Courtès
* doc/contributing.texi (Commit Revocation): Expound.
2021-06-18doc: Add "Addressing Issues" section.Ludovic Courtès
* doc/contributing.texi (Addressing Issues): New section. Co-authored-by: Christopher Baines <mail@cbaines.net>
2021-06-18doc: Structure the "Commit Access" section.Ludovic Courtès
* doc/contributing.texi (Commit Access): Add introduction and section heading. Separate OpenPGP setup from commit policy.
2021-06-18Start enabling substitutes from bordeaux.guix.gnu.org.Christopher Baines
In addition to substitutes from ci.guix.gnu.org. There are more changes that can be made in the future, but these changes seem like a good start. * config-daemon.ac (guix_substitute_urls): Add https://bordeaux.guix.gnu.org. * guix/scripts/substitute.scm (%default-substitute-urls): Add http://bordeaux.guix.gnu.org. * guix/store.scm (%default-substitute-urls): Add bordeaux.guix.gnu.org. * doc/guix.texi: Adjust accordingly. * doc/contributing.texi: Adjust accordingly.
2021-06-17doc: Update QEMU command line.Tobias Geerinckx-Rice
* doc/guix.texi (Invoking guix system): Substitute ‘-nic’ for the obsolete ‘-net’.
2021-06-13doc: Fix reference to the bind package variable name.Luis Felipe
* doc/guix.texi (Globally-Visible Packages): Change "bind" variable name to the actual variable name, "isc-bind". Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2021-06-13doc, gnu, guix: Fix typos.Paul A. Patience
* doc/guix.texi: Fix various typos and reword a sentence. * gnu/packages/cpp.scm (cpplint)[description]: Fix typo. * gnu/packages/dns.scm (ldns): Fix typo in comment. * gnu/packages/games.scm (yamagi-quake2): Fix typo in comment. * gnu/packages/qt.scm (python-pyqtwebengine): Fix typo in comment. * gnu/packages/rails.scm (ruby-autoprefixer-rails): Fix typo in comment. * gnu/packages/syndication.scm (quiterss)[description]: Fix typo. * gnu/packages/terminals.scm (kmscon): Fix typo in comment. * gnu/packages/xml.scm (perl-xml-sax-base)[description]: Fix typo. (python-elementpath)[description]: Fix typo. * guix/build/asdf-build-system.scm (output-translation): Fix typo in docstring. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-06-08doc: Update minimum Guile-Git version.Ludovic Courtès
* doc/guix.texi (Requirements): Update Guile-Git version.
2021-06-06doc: Add reference for ‘git-version’ and ‘hg-version’.Xinglu Chen
* doc/contributing.texi (Version Numbers): Document ‘git-version’ and ‘hg-version’. * doc/guix.texi (package Reference): Reference ‘Version Numbers’ section for version naming guidelines. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-06-06doc: Pluralize "package."Matthew James Kraai
* doc/contributing.texi (Submitting Patches): Pluralize "package." Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2021-06-04doc: Mention virtualization module and add missing closing parenthesis.Solene Rapenne
* doc/contributing.texi (Submitting Patches): Mention virtualization module and add missing closing parenthesis. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2021-06-04doc: Fix example iptables configuration.Eric Brown
* doc/guix.texi (Networking Services): Allow established and related incoming connections in example iptables configuration. Signed-off-by: Arun Isaac <arunisaac@systemreboot.net>
2021-06-03import: Add CHICKEN egg importer.Xinglu Chen
* guix/import/egg.scm: New file. * guix/scripts/import/egg.scm: New file. * tests/egg.scm: New file. * Makefile.am (MODULES, SCM_TESTS): Register them. * po/guix/POTFILES.in: Likewise. * guix/scripts/import.scm (importers): Add egg importer. * doc/guix.texi (Invoking guix import, Invoking guix refresh): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-06-01maint: Require Guile 3.0.Ludovic Courtès
* configure.ac: Require Guile 3.0. * doc/guix.texi (Requirements): Adjust accordingly. * gnu/packages/package-management.scm (guile2.2-guix): Remove. * guix/lint.scm (exception-with-kind-and-args?): Remove 'cond-expand'. * guix/scripts/deploy.scm (deploy-machine*): Likewise. * guix/store.scm (call-with-store): Likewise. * guix/swh.scm (http-get*, http-post*): Likewise. * guix/ui.scm (without-compiler-optimizations, guard*) (call-with-error-handling): Likewise.
2021-05-31tests: Fix loadable-kernel-modules-service tests.Brice Waegeneire
* gnu/tests/linux-modules.scm (run-loadable-kernel-modules-service-test): Actually load the modules with kernel-module-loader-service-type. Use a singleton service instead of defining a custom one. * doc/guix.texi (Service Reference): To give an example of linux-loadable-module-service-type use a singleton instead of defining a new service.
2021-05-30doc: Add a note about networking requirements for SSH access to VMs.Maxim Cournoyer
Fixes <https://issues.guix.gnu.org/48739>. It may seem silly, but when not realizing this firsthand, it can be quite surprising and thus not obvious to troubleshoot. Thanks to Eric Brown for their insightful comments on the tracker. * doc/guix.texi (Running Guix in a VM): Add a note that networking support must be available in the Guix System operating system declaration used for the VM.
2021-05-30doc: Fix typos.Tobias Geerinckx-Rice
* doc/contributing.texi (Translating Guix): Fix ‘runnig’ typo. Replace ‘target’ with ‘command’ to match the verb. Fix ‘refered’ and ‘formating’ too.
2021-05-29doc: lxqt-desktop-service: Update lxqt homepage url.Brendan Tildesley
* doc/guix.texi: Replace lxqt.github.io with lxqt-project.org. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-05-28doc: Spell out the implications of disabling substitutes.Ludovic Courtès
Suggested by elb on #guix. * doc/guix.texi (Binary Installation): Add note explaining the implications of disabling substitutes.
2021-05-25doc: Remove reference to mips64.Efraim Flashner
* doc/contributing.texi (Submitting Patches): Don't suggest building packages for mips64.
2021-05-23doc: Correct spellingFilip Lajszczak
* doc/contributing.tex (Submitting Patches): Correct spelling of "acknowledgement" Co-authored-by: Piotr Kaznowski <piotr@kazno.dev> Signed-off-by: Marius Bakke <marius@gnu.org>
2021-05-22doc: Add information about first patch.Filip Lajszczak
* doc/contributing.texi (Submitting Patches): Add information about first patch acnowledgement delay. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-05-20The #guix channel is hosted by Libera Chat.Tobias Geerinckx-Rice
* README (Contact): Update network name. * ROADMAP: Likewise. * doc/contributing.texi (Contributing): Likewise. * doc/guix.texi (After System Installation): Likewise.
2021-05-19doc: Fix references to the "geiser" package.Ludovic Courtès
Reported by munksgaard on #guix. * doc/guix.texi (Invoking guix pack): Replace "geiser" with "emacs-geiser" in examples. (Invoking guix refresh): Likewise.
2021-05-17services: Add a service for opendht.Maxim Cournoyer
* gnu/services/networking.scm (maybe-number?, maybe-string?): New procedures. (<opendht-configuration>): New configuration record. (%opendht-accounts): New variable. (opendht-configuration->command-line-arguments): New procedure. (opendht-shepherd-service, opendht-service-type): New variables. * doc/guix.texi (Networking Services): Document the new service.
2021-05-16publish: Add '--negative-ttl'.Ludovic Courtès
* guix/scripts/publish.scm (show-help, %options): Add '--negative-ttl'. (render-narinfo, render-narinfo/cached, make-request-handler): Add #:negative-ttl and honor it. (run-publish-server): Add #:narinfo-negative-ttl and honor it. (guix-publish): Honor '--negative-ttl'. * tests/publish.scm ("negative TTL", "no negative TTL"): New tests.
2021-05-13doc: Show how to enable Guile support for Geiser.Jelle Licht
* doc/contributing.texi (The Perfect Setup): Adjust "guix package -i" command line.
2021-05-12doc: Do not instruct to decompress the VM image.Maxim Cournoyer
Also replace the obsolete 'guix system vm-image' command mention by the 'guix system image'. * doc/guix.texi (Running Guix in a VM): Remove VM image decompression instruction. <guix system vm-image>: Replace by 'guix system image'.
2021-05-11Merge branch 'version-1.3.0'Maxim Cournoyer
2021-05-11gnu: Allow services to install kernel-loadable modules.raid5atemyhomework
* gnu/system.scm (operating-system-directory-base-entries): Remove code to handle generation of "kernel" for linux-libre kernels. (operating-system-default-essential-services): Instantiate linux-builder-service-type. (package-for-kernel): Move ... * gnu/services.scm: ... to here. (linux-builder-service-type): New variable. (linux-builder-configuration): New type. (linux-loadable-module-service-type): New variable. * gnu/tests/linux-modules.scm (run-loadable-kernel-modules-test): Move code to ... (run-loadable-kernel-modules-test-base): ... new procedure here. (run-loadable-kernel-modules-service-test): New procedure. (%test-loadable-kernel-modules-service-0): New variable. (%test-loadable-kernel-modules-service-1): New variable. (%test-loadable-kernel-modules-service-2): New variable. * doc/guix.texi: Document linux-loadable-module-service-type. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2021-05-06services: dovecot: Add ‘managesieve-sieve-capability’ option.Alexey Abramov
* gnu/services/mail.scm (protocol-configuration): Add a ‘managesieve-sieve-capability’ field. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2021-05-06services: dovecot: Add ‘managesieve-notify-capability’ option.Alexey Abramov
* gnu/services/mail.scm (protocol-configuration): Add a ‘managesieve-notify-capability’ field. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2021-05-06services: dovecot: Add ‘imap-metadata?’ protocol configuration option.Alexey Abramov
* gnu/services/mail.scm (protocol-configuration): Add an ‘imap-metadata?’ setting to enable IMAP METADATA support in the ‘imap’ protocol. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2021-05-06services: dovecot: Add ‘mail-attribute-dict’ configuration option.Alexey Abramov
* gnu/services/mail.scm (dovecot-configuration): Define a ‘mail-attribute-dict’ directive for IMAP METADATA storage. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2021-05-05gnu: rasdaemon: Fix Texinfo syntax of description.Ludovic Courtès
Regression introduced in 58805da44dac6b180245edd8a6419343f64d221c. * gnu/packages/linux.scm (rasdaemon)[description]: Avoid @acronym since Guile's Texinfo module doesn't currently support @comma{}. * doc/guix.texi (Linux Services): Use @comma{} within @acronym.
2021-05-05build: Do not compress the (already compressed) VM qcow2 images.Maxim Cournoyer
The qcow2 format supports compression, and the qcow2 type supported by 'guix system image' produces compressed qcow2 images. * Makefile.am (release): Do not re-compress the qcow2 VM images with xz. * doc/guix.texi (Running Guix in a VM): Adjust VM image URL.
2021-05-05Revert "doc: Update to cover for an additional OpenPGP signing key."Maxim Cournoyer
This reverts commit b9fb13b28437a254683273094f189396a6e1421d. Per discussions simply updating OPENPGP-SIGNING-KEY-ID and OPENPGP-SIGNING-KEY-URL will be enough.
2021-05-05doc: Update the OpenPGP key used to sign the release.Maxim Cournoyer
It was discussed on guix-devel that the manual only needs to have correct instructions for the latest release. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID): Update to my public OpenPGP key. (OPENPGP-SIGNING-KEY-URL): Adjust URL.
2021-05-05Revert "doc: Update to cover for an additional OpenPGP signing key."Maxim Cournoyer
This reverts commit b9fb13b28437a254683273094f189396a6e1421d. Per discussions simply updating OPENPGP-SIGNING-KEY-ID and OPENPGP-SIGNING-KEY-URL will be enough.
2021-05-04doc: Fix typo and use @acronym for RAS.Tobias Geerinckx-Rice
* doc/guix.texi (Linux Services): Fix typo and use @acronym for RAS.
2021-05-04doc: Fix typos.Tobias Geerinckx-Rice
* doc/contributing.texi (Translating Guix): Fix ‘developpers’ and ‘superseeded’ typos. Use @var mark-up where appropriate.
2021-05-03doc: Update to cover for an additional OpenPGP signing key.Maxim Cournoyer
The upcoming 1.3.0 release will be signed with my OpenPGP key; subsequent releases may also be. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID, OPENPGP-SIGNING-KEY-URL): Rename to... (OPENPGP-SIGNING-KEY-ID-1, OPENPGP-SIGNING-KEY-URL-1): ... these, respectively. (OPENPGP-SIGNING-KEY-ID-2, OPENPGP-SIGNING-KEY-URL-2): New variables. (Binary Installation): Adjust to cover for the new key. (USB Stick and DVD Installation): Likewise. (Invoking guix refresh): Adjust accordingly.
2021-05-03maint: Do not xz-compress ISO images.Ludovic Courtès
The xz-compressed image is 23% smaller than the original ISO image (with built-in zlib compression), but the extra decompression step is unconventional and often a hindrance for users. See discussion at <https://lists.gnu.org/archive/html/guix-devel/2021-04/msg00497.html>. * Makefile.am (release): Do not compress ISO images. * doc/guix.texi (USB Stick and DVD Installation): Remove ".xz" suffix from URL and file name. (Copying to a USB Stick, Burning on a DVD): Remove introductory words, @enumerate, and first item. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2021-05-03nls: Guard against the list of translated Texinfo files becoming stale.Julien Lepiller
This change is so that the list of translated Texinfo files remain in sync with the list of supported (translated) languages. * doc/local.mk (MANUAL_LANGUAGES, COOKBOOK_LANGUAGES): New variables. (lang_to_texinfos): New function. (TRANSLATED_INFO): Use it to construct the list of files. Modified-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2021-05-03doc: Update to cover for an additional OpenPGP signing key.Maxim Cournoyer
The upcoming 1.3.0 release will be signed with my OpenPGP key; subsequent releases may also be. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID, OPENPGP-SIGNING-KEY-URL): Rename to... (OPENPGP-SIGNING-KEY-ID-1, OPENPGP-SIGNING-KEY-URL-1): ... these, respectively. (OPENPGP-SIGNING-KEY-ID-2, OPENPGP-SIGNING-KEY-URL-2): New variables. (Binary Installation): Adjust to cover for the new key. (USB Stick and DVD Installation): Likewise. (Invoking guix refresh): Adjust accordingly.
2021-05-03doc: Update the URL of the system VM image.Maxim Cournoyer
This is a follow up to commit ebf5d77eab, which added the qcow2 file extension to the VM image file name. * doc/guix.texi (Running Guix in a VM): Update URL.
2021-04-27services: mysql: Add extra-environment as configuration option.methuselah-0
* gnu/services/databases.scm (mysql-configuration): Add extra-environment (mysql-service): Use #:log-file and #:environment-variables * doc/guix.texi: Document it. Signed-off-by: Leo Prikler <leo.prikler@student.tugraz.at>
2021-04-26doc: Remove extraneous spaces from the net-options default value snippet.Maxim Cournoyer
Adapting the snippet corresponding to the default value of the net-options field of the hurd-vm-configuration record shown in the manual would easily lead to a broken childhurd service, due to the presence of extraneous spaces in the option string. * doc/guix.texi (Virtualization Services)[hurd-vm-configuration] <net-options>: Use string-append to properly form the option string.
2021-04-26doc: Clarify the utility of the development branches.Leo Famulari
* doc/contributing.texi (Submitting Patches): Clarify the utility of the 'staging' and 'core-updates' branches.