aboutsummaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* services: cuirass: Remove use-substitutes? configuration option.Ahmad Draidi3 days
| | | | | | | | | | | | | 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>
* services: cuirass: Add new configuration options.Ahmad Draidi3 days
| | | | | | | | | | * 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>
* services: cuirass: Use separate extra options for cuirass web process.Ahmad Draidi3 days
| | | | | | | | | | | | | | | 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>
* git authenticate: Install pre-push and post-checkout hooks.Ludovic Courtès6 days
| | | | | | | | * 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
* git authenticate: Record introduction and keyring in ‘.git/config’.Ludovic Courtès6 days
| | | | | | | | | | | | | | * 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
* linux-initrd: Further strip the static Guile.Ludovic Courtès8 days
| | | | | | | | | | | | | | ‘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
* services: Add gvfs-service-type.宋文武9 days
| | | | | | | | | | * 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
* doc: contributing: Move localstatedir instructions.Florian Pelz11 days
| | | | | | | * doc/contributing.texi (Requirements): Move localstatedir ... (Building from Git): ... here. Change-Id: I860bb7a9e6aea12881469c667496364248293c31
* doc: contributing: Suggest building from Git.Florian Pelz11 days
| | | | | | | * doc/contributing.texi (Requirements): Explain the purpose of this section. Refer regular contributors to Building from Git. Change-Id: I731af4ac8e78b053b96a3b683528964223ab740b
* doc: Fix mentions of 'nss-certs'.Fabio Natali2024-04-23
| | | | | | | | | | | | | * 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>
* doc: Fix typo.Matthew Trzcinski2024-04-22
| | | | | | * doc/guix.texi (Installing Guix in a VM): Change indefinite article. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de>
* doc: Correct the "guix shell --container" example.Rostislav Svoboda2024-04-20
| | | | | | | | * 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>
* doc: Update gnome-desktop-configuration.Liliana Marie Prikler2024-04-20
| | | | | * doc/guix.texi (gnome-desktop-configuration): Fill in missing fields. [gnome]: Talk about the deprecation.
* doc: Fix cross-references.Matthew Trzcinski2024-04-19
| | | | | | | | | * 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
* Revert "maint: Generate 'doc/version.texi' reproducibly."Janneke Nieuwenhuizen2024-04-19
| | | | | | | | Using `build-aux/mdate-from-git.scm' makes this no longer necessary. This reverts commit e73ea7bd64f64709c71f89dfb111cf3e8ada3771. Change-Id: I29d1e36b13d255e5a65b7348e7ae4f2b2c24a518
* Revert "maint: Generate 'doc/version-LANG.texi' reproducibly."Janneke Nieuwenhuizen2024-04-19
| | | | | | | | Using `build-aux/mdate-from-git.scm' makes this no longer necessary. This reverts commit 0e4ead187d83a958ca0deb54857c04967e84d68b. Change-Id: I9177828f90fa7f7e256bc72fdff35a2fab355780
* system: Remove nss-certs from OS templates, adjust doc.Maxim Cournoyer2024-04-18
| | | | | | | | | | | | | | | | | | | | | | | | | 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
* doc: Expound on ‘guix-home-service-type’.Ludovic Courtès2024-04-17
| | | | | | | | | * 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
* services: Add the Guix Home service.Richard Sent2024-04-17
| | | | | | | | | | | | | | | 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>
* guix: Add xtensa-ath9k-elf platform.Jean-Pierre De Jesus DIAZ2024-04-17
| | | | | | | | | * 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>
* doc: Add documentation for x86_64-linux-gnux32.Jean-Pierre De Jesus DIAZ2024-04-17
| | | | | | | * doc/guix.texi: Add documentation for x86_64-linux-gnux32. Change-Id: I408d57ae5ae3e9b1449633b82c41aba0d40ded06 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* maint: Ensure generated file reproducibility for dist.Janneke Nieuwenhuizen2024-04-14
| | | | | | | | | | | | * doc/local.mk (doc-clean): New target. (DIST_CONFIGURE_FLAGS): New variable. (auto-clean): Use them in new target. * Makefile.am (dist-doc-pot-update): Use it in new target. (dist): Change to depend on it to clean possibly stale files, instead of doc-pot-update directly. Add a toplevel check to ensure that Autotools cache is up to date. Change-Id: I2ff2d88db9fe1e708ab65e33e1f3d7ecee882cb4
* maint: Reset CreationDate metadata on generated PDFs.Janneke Nieuwenhuizen2024-04-14
| | | | | | * doc/local.mk (.dot.pdf): Create PDF in UTC0 and reset CreationDate metadata. Change-Id: I3873ecdeec781c30874d53d032406cbe23922a25
* maint: Avoid PNG and PDF generation to fail silently.Janneke Nieuwenhuizen2024-04-14
| | | | | | | | * doc/local.mk (.dot.png): Split single shell command into separate recipe lines, prefixed by $(AM_V_at). (.dot.pdf): Likewise. Change-Id: I41fb856bb73f947abd91361ed203132e939f3897
* maint: Avoid EPS generation to fail silently, ensure reproducibility.Janneke Nieuwenhuizen2024-04-14
| | | | | | | | | | | | Currently, Graphviz' dot does not insert a %%CreationDate. ImageMagick's convert on PNG->EPS does insert a %%CreationDate but it respects SOURCE_DATE_EPOCH. * doc/local.mk (.png.eps): Split single shell command into separate recipe lines, prefixed by $(AM_V_at). (.dot.png): Likewise. Check that generated EPS file has no %%CreationDate. Change-Id: I5a03485c19c72f0c46411815c51290e52a8e5399
* maint: Generate 'doc/version-LANG.texi' reproducibly.Janneke Nieuwenhuizen2024-04-14
| | | | | | | | | * doc/local.mk ($(srcdir)/doc/stamp-vti): Change rule into... (version.texi-from-git): ...this new function. Call it with vti,guix.texi,; and for all MANUAL_LANGUAGES with $(i),po/doc/guix-manual.$(lang).po, -$(lang.po). Change-Id: Ia8df618178066cad320eecea0299337224e23a73
* maint: Help help2man generate reproducible man-pages.Janneke Nieuwenhuizen2024-04-14
| | | | | | * doc/local.mk (SOURCE_DATE_EPOCH): New exported variable. Change-Id: I6636693695d5502657f1475d93d31949e0b0b39d
* maint: Generate 'doc/version.texi' reproducibly.Timothy Sample2024-04-14
| | | | | | | | | * doc/local.mk ($(srcdir)/doc/stamp-vti): New rule (overriding one provided by Automake). Co-authored-by: Janneke Nieuwenhuizen <janneke@gnu.org> Change-Id: If44965e9a3ecfb45865c58ee7a558951be8d15ae
* doc: Use "dejavu sans" instead of "Helvetica" or "sans" in dot images.Janneke Nieuwenhuizen2024-04-14
| | | | | | | | | | | | | | | | | | 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
* doc: Standardize IRC stylization.Matthew Trzcinski2024-04-14
| | | | | | | * doc/guix.texi (After System Installation): Make references to Libera.Chat consistent. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de>
* doc: Fix grammar and markup.Matthew Trzcinski2024-04-12
| | | | | | | | | | 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
* gexp: Add #:guile parameter to ‘gexp->file’ and ‘scheme-file’.Ludovic Courtès2024-04-08
| | | | | | | | | | | | | | | | | | | | | | | | | | 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
* doc: Restore some of the old installation instructions.Florian Pelz2024-04-07
| | | | | | | | | | | | 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
* doc: Move "Running the Test Suite" after "Building from Git".Matthew Trzcinski2024-04-06
| | | | | | | | * 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>
* doc: Move "Requirements" before "Building from Git"Matthew Trzcinski2024-04-06
| | | | | | | | * 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>
* doc: Fix Texinfo menus.Maxim Cournoyer2024-04-06
| | | | | | | 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
* doc: Simplify installation instructionsMatthew Trzcinski2024-04-06
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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>
* gnu: guix: Define ‘guix-for-channels’ and document its use.Ludovic Courtès2024-04-05
| | | | | | | | | * 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
* build-system/channel: Add support for additional channels.Ludovic Courtès2024-04-05
| | | | | | | | | | | | | 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
* guix-install.sh: Add ‘--uninstall’ flag.Ludovic Courtès2024-04-05
| | | | | | | | | | | | | | | | | * 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
* doc: Explain to run bootstrap after Automake errors.Florian Pelz2024-04-05
| | | | | | | | | | 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
* Switch order of the default substitute servers.Christopher Baines2024-04-03
| | | | | | | | | | | | | | | | | | | | | | | | | | | 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>
* maint: Fix help2man for guix subcommands with `make V=2'.Janneke Nieuwenhuizen2024-04-03
| | | | | | | * doc/local.mk ($(srcdir)/%D%/guix-%.1): Use AM_V_HELP2MAN and cater for make's `@' silencing at the start of the command. Change-Id: Id80c48f0d7697167fea64700a7fe140003732d28
* nls: Update translations.Florian Pelz2024-04-01
| | | | | | | | | | | | | * po/guix/ar.po: New file. * po/guix/LINGUAS: Add 'ar'. * po/doc/guix-cookbook.pt_BR.po: New file. * po/doc/local.mk: Add 'pt_BR' cookbook. * doc/local.mk: Add 'pt_BR' cookbook. * doc/htmlxref.cnf: Update URLs for cookbook. * doc/build.scm (%cookbook-languages): Add 'ko', 'pt_BR'. * doc/guix-cookbook.texi (Top): Mention 'ko', 'pt_BR' cookbook. Change-Id: Id1846ca100263b3fc1fa2ed52654c670270ee809
* doc: cookbook: Fix typo.Maxim Cournoyer2024-03-31
| | | | | | * doc/guix-cookbook.texi (Network bridge for QEMU): Fix typo. Change-Id: I32f88bd85157a6b2cee9f68840f9e77101596518
* Merge branch 'gnome-team'Liliana Marie Prikler2024-03-30
|\
| * Merge remote-tracking branch 'savannah/master' into gnome-teamChristopher Baines2024-03-20
| |\ | | | | | | | | | Change-Id: Iec8e15b79c6fde516294c2bfcaf8ee3575b1f745
| * \ Merge remote-tracking branch 'savannah/master' into gnome-teamChristopher Baines2024-03-16
| |\ \ | | | | | | | | | | | | Change-Id: I775274c2693536e2efa36c9abca4c54c5c458e26
| * \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-03-10
| |\ \ \
| * \ \ \ Merge branch 'master' into gnome-teamLiliana Marie Prikler2024-03-02
| |\ \ \ \
generated by cgit v1.2.3 (git 2.25.4) at 2024-05-07 20:44:24 +0000