summaryrefslogtreecommitdiff
path: root/doc/guix.texi
Commit message (Expand)AuthorAgeFilesLines
* doc: Update NixOS wiki url to the official wiki.•••nixos.wiki was created by a community member a long time ago. It turned out to be very useful to the community, it became an official service last month hosted on the NixOS.org domain name. To ease the long term maintainance among other things. See more details at https://github.com/NixOS/foundation/issues/113 * doc/guix.texi (Nix service): Change nixos.wiki to wiki.nixos.org. Change-Id: Ia95074fbfad494e8ceb5c2cdb3faab23f3604882 Signed-off-by: Christopher Baines <mail@cbaines.net> Picnoir2024-05-121-1/+1
* services: cuirass: Remove use-substitutes? configuration option.•••As of Cuirass commit 9a1452ee021c9f773424961cfeef47ca0b7c5c5a, this option seems to be unused and kept for back compatibility there. * gnu/services/cuirass.scm (<cuirass-configuration>): Remove use-substitutes? field. (cuirass-shepherd-service): Remove the option. * doc/guix.texi (Continuous Integration): Remove option documentation. Change-Id: I933550ce76eecdf918b07891aa8212fd30a7c87e Signed-off-by: Ludovic Courtès <ludo@gnu.org> Ahmad Draidi2024-05-041-4/+0
* services: cuirass: Add new configuration options.•••* gnu/services/cuirass.scm (<cuirass-configuration>): Add ttl and threads fields. (cuirass-shepherd-service): Handle the new options. * doc/guix.texi (Continuous Integration): Document them. Change-Id: I4387fbd7bf6766f4a54801f35c7ed82ce4eb9645 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Ahmad Draidi2024-05-041-0/+6
* services: cuirass: Use separate extra options for cuirass web process.•••Currently, "extra-options" is passed to both "cuirass register" and "cuirass web" processes. This makes it impractical since the extra parameters have to be intended for and supported by both processes. * gnu/services/cuirass.scm (<cuirass-configuration>): Add a web-extra-options field. (cuirass-shepherd-service): Replace extra-options with web-extra-options for cuirass web. * doc/guix.texi (Continuous Integration): Document the changes. Change-Id: Iba79c559ea8267aaf8f25248f3d18ed7b352cb60 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Ahmad Draidi2024-05-041-1/+4
* git authenticate: Install pre-push and post-checkout hooks.•••* guix/scripts/git/authenticate.scm (install-hooks): New procedure. (guix-git-authenticate): Use it. * doc/guix.texi (Invoking guix git authenticate): Document it. Change-Id: I4464a33193186e85b476a12740e54412bd58429c Ludovic Courtès2024-05-011-0/+5
* git authenticate: Record introduction and keyring in ‘.git/config’.•••* guix/scripts/git/authenticate.scm (%default-options): Remove ‘keyring-reference’. (config-value, configured-introduction, configured-keyring-reference) (configured?, record-configuration, current-branch): New procedures. (guix-git-authenticate)[missing-arguments]: New procedure. Use ‘configured-introduction’ when zero arguments are given. Use ‘configured-keyring-reference’ when ‘-k’ is not passed. Add call to ‘record-configuration’. * doc/guix.texi (Invoking guix git authenticate): Document it. Change-Id: I66e111a83f50407b52da71662629947f83a78bbc Ludovic Courtès2024-05-011-2/+26
* linux-initrd: Further strip the static Guile.•••‘guile-static-initrd’ weighs in at 46 MiB, compared to 54 MiB for ‘guile-static-stripped’ (15% reduction). * gnu/packages/make-bootstrap.scm (make-guile-static-stripped): Add ‘directories-to-remove’ parameter and honor it. (%guile-static-initrd): New variable. * gnu/system/linux-initrd.scm (expression->initrd): Default to ‘%guile-static-initrd’. * doc/guix.texi (Initial RAM Disk): Adjust accordingly. Change-Id: I2baf06fed7a3698433e7c83b1d7726054a8c746e Ludovic Courtès2024-04-291-1/+1
* services: Add gvfs-service-type.•••* gnu/services/desktop.scm (gvfs-service-type): New variable. (gvfs-configuration, make-gvfs-configuration, gvfs-configuration?, gvfs-package): New procedures. (<gvfs-configuration>): New record. * doc/guix.texi (Desktop Services): Document it. Change-Id: I584819500e2ce7d2b14e57dac238a96e9888e75e 宋文武2024-04-291-0/+19
* doc: Fix mentions of 'nss-certs'.•••* doc/guix.texi (Using the Configuration System): Fix mention of 'nss-certs' after the package has been added to '%default-packages' (see '65e8472a4b6fc6f66871ba0dad518b7d4c63595e'). * doc/guix.texi (Web Services): Fix mention of 'nss-certs' after the package has been added to '%default-packages' (see '65e8472a4b6fc6f66871ba0dad518b7d4c63595e'). Change-Id: Iecdecb8deb440cdea224f3e9e7ce54e89dd575a2 Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Fabio Natali2024-04-231-5/+4
* doc: Fix typo.•••* doc/guix.texi (Installing Guix in a VM): Change indefinite article. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Matthew Trzcinski2024-04-221-1/+1
* doc: Correct the "guix shell --container" example.•••* doc/guix.texi (Invoking @command{guix shell}): Add missing parameters to preserve and expose $XAUTHORITY. Adjust corresponding textual description. Change-Id: Ib99c81c107ff9784708ae807ec9b3ab93ad75603 Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com> Rostislav Svoboda2024-04-201-3/+9
* doc: Update gnome-desktop-configuration.•••* doc/guix.texi (gnome-desktop-configuration): Fill in missing fields. [gnome]: Talk about the deprecation. Liliana Marie Prikler2024-04-201-2/+34
* doc: Fix cross-references.•••* doc/guix.texi (Setting Up the Daemon): Use @xref to start sentence. (Build Systems): Capitalize "python" and start parenthesized reference with @pxref. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Change-Id: I3504d8668d137029f5f76f025108b7023d9b4182 Matthew Trzcinski2024-04-191-3/+3
* system: Remove nss-certs from OS templates, adjust doc.•••This is a follow-up to commit 86afaadb51 ("system: Add 'nss-certs' to %base-packages-networking.") * doc/guix-cookbook.texi (Running Guix on a Linode Server): Remove nss-certs from operating system's packages field. (Running Guix on a Kimsufi Server): Likewise. * doc/guix.texi (Using the Configuration System): Likewise. (X.509 Certificates): Adjust to mention nss-certs *is* part of %base-packages. * gnu/installer/services.scm (%system-services): Remove recommendation to install nss-certs. * gnu/system/examples/bare-bones.tmpl (host-name): Remove obsolete comments. * gnu/system/examples/desktop.tmpl (packages): Remove nss-certs. * gnu/system/examples/lightweight-desktop.tmpl (packages): Likewise. * gnu/system/examples/plasma.tmpl (packages): Likewise. * gnu/system/examples/raspberry-pi-64-nfs-root.tmpl (packages): Likewise. * gnu/system/examples/raspberry-pi-64.tmpl (packages): Likewise. * gnu/system/examples/vm-image.tmpl (packages): Likewise. * gnu/system/images/orangepi-r1-plus-lts-rk3328.scm (packages): Likewise. * gnu/system/images/pine64.scm (packages): Likewise. * gnu/system/install.scm (installation-os) [packages]: Likewise. Change-Id: If09123a69b987178bcb0aab61c4570c14fc1286f Maxim Cournoyer2024-04-181-2/+2
* doc: Expound on ‘guix-home-service-type’.•••* doc/guix.texi (Guix Home Service): Reword intro. Tweak example to be closer to reality. (Declaring the Home Environment): Link to ‘guix-home-service-type’. (Invoking guix home): Likewise. Change-Id: I0355a6da9b9a28818eb0738854381671a6a1f652 Ludovic Courtès2024-04-171-13/+27
* services: Add the Guix Home service.•••This patch adds a Guix Home service, which allows for configuring/deploying an operating-system declaration with an associated home-environment. * gnu/services/guix.scm: Add guix-home-service and guix-home-shepherd-service * gnu/home/services/shepherd.scm: Don't attempt to launch user shepherd when the system shepherd runs guix-home-<user> * doc/guix.texi: Add documentation for guix-home-service * gnu/tests/guix.scm: Add a test to verify guix-home-service-type is able to activate a home environment Change-Id: Ifbcc0878d934aa4abe34bb2123b5081fb432aa8e Signed-off-by: Ludovic Courtès <ludo@gnu.org> Richard Sent2024-04-171-0/+32
* guix: Add xtensa-ath9k-elf platform.•••* Makefile.am (MODULES): Add guix/platforms/xtensa.scm. * guix/platforms/xtensa.scm (xtensa-ath9k-elf): New variable. * doc/guix.texi: Add xtensa-ath9k-elf documentation. Change-Id: I51eef245142ed58613340c16d4bf7266e6bf6adb Signed-off-by: Ludovic Courtès <ludo@gnu.org> Jean-Pierre De Jesus DIAZ2024-04-171-0/+6
* doc: Add documentation for x86_64-linux-gnux32.•••* doc/guix.texi: Add documentation for x86_64-linux-gnux32. Change-Id: I408d57ae5ae3e9b1449633b82c41aba0d40ded06 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Jean-Pierre De Jesus DIAZ2024-04-171-0/+6
* doc: Use "dejavu sans" instead of "Helvetica" or "sans" in dot images.•••Font-dejavu is (now) an input of fontconfig. Specifying "dejavu sans" makes generated images reproducible even when other fonts are installed (notably font-google-noto). * doc/images/bootstrap-graph.dot, doc/images/bootstrap-packages.dot, doc/images/coreutils-bag-graph.dot, doc/images/coreutils-graph.dot, doc/images/gcc-core-mesboot0-graph.dot, doc/images/service-graph.dot, doc/images/shepherd-graph.dot: Use fontname = "dejavu sans". * doc/guix.texi (Full-Source Bootstrap): Update gcc-core-mesboot0.dot recipe accordingly. Change-Id: If21d7d39d45c66de5bceafb7b825a057d540ee50 Janneke Nieuwenhuizen2024-04-141-1/+6
* doc: Standardize IRC stylization.•••* doc/guix.texi (After System Installation): Make references to Libera.Chat consistent. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Matthew Trzcinski2024-04-141-1/+1
* doc: Fix grammar and markup.•••doc/guix.texi (Setting Up the Daemon): Remove comma and extra words. doc/guix.texi (Mail Services): Add definite article to setting. Use @samp markup on setting. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Change-Id: I5b3ef115ec718454db4fc046ea5f77ba9fe50a37 Matthew Trzcinski2024-04-121-4/+4
* gexp: Add #:guile parameter to ‘gexp->file’ and ‘scheme-file’.•••This brings ‘gexp->file’ in line with its documentation and mirrors what’s done for ‘gexp->script’ and ‘program-file’. Fixes <https://issues.guix.gnu.org/69401>. * guix/gexp.scm (gexp->file): Add #:guile, as was already documented. (<scheme-file>)[guile]: New field. (scheme-file): Add #:guile. (scheme-file-compiler): Honor ‘guile’ field. * tests/gexp.scm ("gexp->file") ("gexp->file + file-append", "gexp->file + #:splice?") ("gexp->file, cross-compilation") ("gexp->file, cross-compilation with default target") Add #:guile to ‘gexp->file’ calls. ("gexp-modules deletes duplicates") ("gexp->derivation & with-imported-module & computed module") ("gexp->derivation & with-extensions", "scheme-file"): Likewise for ‘scheme-file’ calls. Change-Id: I47536063d5e411e561ec321e535267e92dd06044 Reported-by: Efraim Flashner <efraim@flashner.co.il> Change-Id: I58d653c7fbe65c665bafcbd332ac9b264ddeab64 Ludovic Courtès2024-04-081-2/+3
* doc: Restore some of the old installation instructions.•••Follow-up to 227e0469dbfec7e47b57d824dcf45a04ac4026c9. * doc/guix.texi (Binary Installation): Revert wording for installing the Debian package. Restore how to reproduce the binary tarball. Restore how to uninstall. (copying): Add copyright notice for Matthew Trzcinski. Change-Id: Ib74199e39bd7a50ac58045f2bc47f61fc04eacb9 Florian Pelz2024-04-071-1/+33
* doc: Move "Running the Test Suite" after "Building from Git".•••* doc/contributing.texi (doc/guix.texi): Move "Running the Test Suite" after "Building from Git". Link: <https://lists.gnu.org/archive/html/guix-devel/2024-03/msg00023.html> Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Matthew Trzcinski2024-04-061-98/+0
* doc: Move "Requirements" before "Building from Git"•••* doc/contributing.texi (doc/guix.texi): Move "Requirements" before "Building from Git". Link: <https://lists.gnu.org/archive/html/guix-devel/2024-03/msg00023.html> Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Matthew Trzcinski2024-04-061-99/+0
* doc: Fix Texinfo menus.•••There should be two spaces between the node name and its description. Found via 'M-x texinfo-all-menus-update' in Emacs. Change-Id: I2b17180746f8d97ea5f927b8a504419c087dd5f5 Maxim Cournoyer2024-04-061-2/+2
* doc: Simplify installation instructions•••* doc/guix.texi (Installation): - Move the definition of "foreign distro" out of quotation - Repeat overwrite warning - Remove superfluous commentary * doc/guix.texi (Binary Installation): - Clarify that installing on a foreign distro has two methods: using packaged binaries and building from source - Add cross reference to "Building from Git" - Move the foreign distro installation instructions out of quotation - Move directions for 'guix-install.sh' after instructions to use distribution-specific package managers - Specify "distributions" as "GNU/Linux distributions" - Add GnuPG as a requirement for 'guix-install.sh' - Add comma after "Likewise" - Remove redundant instructions to use 'guix-install.sh' - Split the requirements between system requirements for binary installations, GNU/Linux or GNU/Hurd, and requirements for running 'guix-install.sh' - Clarify that 'guix-install.sh' guides users through the steps - Summarize the steps 'guix-install.sh' follows rather than try to detail them - Make explicit that the 'guix-install.sh' default is to download substitutes - Emphasize that the substitute authorization code is an example and may need modification Link: <https://lists.gnu.org/archive/html/guix-devel/2024-03/msg00023.html> Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Matthew Trzcinski2024-04-061-245/+51
* gnu: guix: Define ‘guix-for-channels’ and document its use.•••* gnu/packages/package-management.scm (guix-for-channels): New procedure. * doc/guix.texi (Customizing the System-Wide Guix): New section. (Base Services): Add cross-reference. Change-Id: Ied51c3bf9bf08dfc629bb3f0a152eb20b869a636 Ludovic Courtès2024-04-051-1/+61
* build-system/channel: Add support for additional channels.•••Until now, ‘channel-build-system’ would assume a single channel, the ‘guix’ channel. This change lets users specify additional channels using the #:channels parameter. * guix/build-system/channel.scm (build-channels): Add #:channels and honor it. (channel-build-system): In ‘lower’, add #:channels and honor it. * doc/guix.texi (Build Systems): Document it. Change-Id: I36c1d19cbeee02a4d1144de089b78df0390774a0 Ludovic Courtès2024-04-051-1/+4
* guix-install.sh: Add ‘--uninstall’ flag.•••* etc/guix-install.sh (REQUIRE): Add groupdel and userdel. (chk_term): Handle ‘WAR’. (sys_delete_store, sys_delete_build_user, sys_delete_guix_daemon) (sys_delete_init_profile, sys_delete_user_profiles): New functions. (main): Rename to… (main_install): … this. (main_uninstall): New function. (main): Dispatch between these two. * doc/guix.texi (Installation): Refer to “Binary Installation” instead of repeating it. (Binary Installation): Document uninstallation. Co-authored-by: Ludovic Courtès <ludo@gnu.org> Change-Id: I55b7c10823773bced2e268273e8ce828cb3bd98d Ludovic Courtès2024-04-051-4/+19
* doc: Explain to run bootstrap after Automake errors.•••Fixes <https://issues.guix.gnu.org/70140>. Suggested by Rostislav Svoboda <rostislav.svoboda@gmail.com>. * doc/contributing.texi (Building from Git): Explain. * doc/guix.texi: Update copyright year. Change-Id: I0cedc60f9ece3ec78df60df54ffeacff545bfc63 Florian Pelz2024-04-051-1/+1
* Switch order of the default substitute servers.•••The aim here is to improve the user experience. There's anecdotal evidence that the network performance for bordeaux is better compared to ci at least for some users, and I don't know of any issues with rate limiting or access restriction for bordeaux compared to ci. It also has IPv6 support. Additionally, bordeaux generally had more substitutes than ci, particularly for aarch64-linux and armhf-linux. This change will offer a very slight speedup for those substitutes that only bordeaux has. Bordeaux has been a default substitute server for nearly 3 years now and I think this change is overdue. I'm also hopeful that we'll be able to build on the testing regarding mirrors for bordeaux, and that'll allow potentially improving the hosting setup (through providing more redundancy) and further improving substitute fetching for users who currently have issues with substitute access. * config-daemon.ac: Switch substitute urls order. * doc/guix.texi: Ditto. * etc/guix-install.sh: Ditto. * gnu/installer/newt/network.scm (wait-service-online): Ditto. * guix/store.scm (%default-substitute-urls): Ditto. Change-Id: I4f6d93ae1fc8b03d80b47b18b5749a51f1fde17b Signed-off-by: Christopher Baines <mail@cbaines.net> Christopher Baines2024-04-031-2/+2
* Merge branch 'gnome-team'Liliana Marie Prikler2024-03-301-11/+46
|\
| * Merge remote-tracking branch 'savannah/master' into gnome-team•••Change-Id: Iec8e15b79c6fde516294c2bfcaf8ee3575b1f745 Christopher Baines2024-03-201-5/+14
| |\
| * \ Merge remote-tracking branch 'savannah/master' into gnome-team•••Change-Id: I775274c2693536e2efa36c9abca4c54c5c458e26 Christopher Baines2024-03-161-8/+8
| |\ \
| * \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-03-101-97/+362
| |\ \ \
| * \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-03-021-2/+17
| |\ \ \ \
| * \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-02-251-13/+74
| |\ \ \ \ \
| * \ \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-02-131-1/+138
| |\ \ \ \ \ \
| * \ \ \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-02-031-59/+510
| |\ \ \ \ \ \ \
| * \ \ \ \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-01-141-43/+86
| |\ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-01-071-4/+7
| |\ \ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-01-011-60/+127
| |\ \ \ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2023-12-201-5/+196
| |\ \ \ \ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ \ \ \ Merge branch 'master' into HEAD•••Change-Id: I3f5d121162d98ef2ae61a62c4da3b0fd19d864e8 Liliana Marie Prikler2023-12-031-12/+133
| |\ \ \ \ \ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ \ \ \ \ Merge branch 'master' into gnome-team•••Change-Id: I62da840b7600f2d3d8541e666d09e2f2a1b7d8c4 Liliana Marie Prikler2023-11-191-0/+76
| |\ \ \ \ \ \ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ \ \ \ \ \ Merge branch 'master' into gnome-team•••Change-Id: I88d3789460d1a89917451d80405d89a2824006ac Liliana Marie Prikler2023-11-041-128/+127
| |\ \ \ \ \ \ \ \ \ \ \ \ \ \
| * \ \ \ \ \ \ \ \ \ \ \ \ \ \ Merge branch 'master' into gnome-team•••Change-Id: Ib6f55bebef2fb235fa59fd5442102a3e0ace3191 Liliana Marie Prikler2023-10-231-15/+189
| |\ \ \ \ \ \ \ \ \ \ \ \ \ \ \
| * | | | | | | | | | | | | | | | gnu: udev-service-type: accept hardware description file extensions.•••The udev-configuration record now has a hardware field. The contents of the /etc/udev directory now includes hwdb.bin, which is computed when the system is instanciated (prior to system activation). The hardware description files used to generate hwdb.bin are not installed in /etc, because they are not required at run-time. The documentation has been reworked so as to explain why creating udev rules or hardware needs helper functions for configuration or extension. * gnu/services/base.scm (udev-hardware): New function. (file->udev-hardware): New function. (udev-hardware-service): New function. (udev-etc): Add hwdb.d and hwdb.bin. (module): Export udev-hardware, file->udev-hardware, and udev-hardware-service. (<udev-configuration>): Add the native-udev field. (udev-service-type) [extend]: Populate the hardware field. * doc/guix.texi (Base Services)[udev-service-type]: Explain configuration and extension values. * doc/guix.texi (Base Services)[udev-hardware]: Document it. [udev-hardware-service]: Same. * doc/guix.texi (Base Services)[udev-configuration]: Document the native-udev field. Vivien Kraus2023-10-101-11/+46
* | | | | | | | | | | | | | | | | doc: Cross-reference virtual build machines from ‘guix time-machine’.•••* doc/guix.texi (Invoking guix time-machine): Tweak the note about packages that may fail to build. Add cross-reference to virtual build machines. Change-Id: Ib2a4a28cdca0c8970d0f5327e39b4a21800ea2e1 Ludovic Courtès2024-03-301-4/+4