aboutsummaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Expand)Author
2024-12-06services: wireguard: Support lists of gexps for most fields....In order to support more flexibility in Wireguard configuration, ungexp the configuration fields directly instead of ungexp-splicing a sexp calculator. This allows for the fields to take arbitrary gexps instead of only strings which is particularly helpful for the Pre/Post Up/Down commands. * gnu/services/vpn.scm (wireguard-configuration-file): Ungexp configuration lists instead of ungexp-splicing the code surrounding them. * doc/guix.texi (VPN Services)[wireguard]: Document it. Change-Id: If074cbb78473b6fd34e0e4e990d2ed268001d6c7 Signed-off-by: Mathieu Othacehe <othacehe@gnu.org> Richard Sent
2024-12-06services: wireguard: Add the bootstrap-private-key? field....The syntax from using the private-key field is more convenient than writing a custom PreUp command (more formatting and preshared keys). Instead of trying to guess if private-key is/is not a file path, add an option to disable bootstrapping while still using private-key. * gnu/services/vpn.scm (<wireguard-configuration>): Add bootstrap-private-key?. (wireguard-activation): Check bootstrap-private-key? before bootstrapping. * doc/guix.texi (VPN Services)[wireguard]: Document it. Change-Id: I6ba71ad58b26743057a221a54a246369022f83a5 Signed-off-by: Mathieu Othacehe <othacehe@gnu.org> Richard Sent
2024-12-06services: wireguard: Make the private-key field optional....Users who retrieve the private-key via a PreUp field need to be able to disable the default retrieval mechanism. * gnu/services/vpn.scm (<wireguard-configuration>)[private-key]: Change comment. (wireguard-configuration-file): Conditionally serialize private-key. * gnu/services/vpn.scm (wireguard-activation): Do not create private-key if the field is #f. * doc/guix.texi (VPN Services)[wireguard-configuration]: Document it. Change-Id: Iac419809ae94eb76e97ff1f1749e2f4b3e65bb04 Signed-off-by: Mathieu Othacehe <othacehe@gnu.org> Richard Sent
2024-12-03doc: contributing: Remove --base=auto...* doc/contributing.texi(Sending a Patch Series): Remove --base=auto from examples Change-Id: Idd421f9d6b592d6a314edfaa66404dee4c1b2241 Ekaitz Zarraga
2024-12-03doc: Explain `git format-patch` revision format...* doc/contributing.texi(Sending a Patch Series): Add a note about `git format-patch` revision format and link to git documentation. Change-Id: Ie08f85dc19e3804165fb184664b74e85a804d7c4 Ekaitz Zarraga
2024-12-03gnu: bootstrap: Add support for x86_64-gnu, aka the 64bit Hurd....On commit: ec8a5ec15f898e864705e5a5c834532e3fa8d0a4 gnu: make-bootstrap: Update gcc-static to gcc-14, for the 64bit Hurd. Run: ./pre-inst-env guix build --target=x86_64-gnu bootstrap-tarballs Producing: /gnu/store/w1n7bdpn88plcc49h7n0jriaj41sgwx8-bootstrap-tarballs-0/ With guix hash -r: 15cb1xh7s2hhp8s0d81bjnw1759w9sh7ckc9n5jq2f3rqw6z76by * gnu/packages/bootstrap.scm (%bootstrap-executables): Add entries for x86_64-gnu. (%bootstrap-guile-hash, %bootstrap-coreutils&co, %bootstrap-binutils, %bootstrap-glibc, %bootstrap-gcc): Add entry for x86_64-gnu. * guix/packages.scm (%supported-systems, %hurd-systems): Add x86_64-gnu. (%cuirass-supported-systems): Remove x86_64-gnu. * guix/utils.scm (target-64bit?): Add x86_64-gnu. * m4/guix.m4: Add x86_64-gnu as a supported system. * doc/guix.texi (GNU Distribution): Add x86_64-gnu. Change-Id: I828159aedb3f66caba98e935083cc3682429f219 Janneke Nieuwenhuizen
2024-12-03system: Add "installer" sub-command....* guix/scripts/system/installer.scm: New file. * Makefile.am (MODULES)[ENABLE_INSTALLER]: Register it. (MODULES_NOT_COMPILED)[!ENABLE_INSTALLER]: Likewise. * guix/scripts/system.scm (show-help): Add help for "installer" sub-command. (actions): Register "installer". (guix-system): Invoke `guix-system-installer' sub-command. * doc/guix.texi (Invoking guix system): Document it. * gnu/installer.scm (run-installer): Remove "./pre-inst env". Change-Id: I5a05b941c060682c17d45d871df3cf34e3f8643a Janneke Nieuwenhuizen
2024-12-02packages: 'package-input-rewriting/spec' optionally replace hidden....Commit eee95b5a879b7096dffd533f24107cf8926b621e changed package rewriting to ignore hidden packages. This patch permits the previous use by adding an option to rewrite hidden packages. * guix/packages.scm (package-input-rewriting/spec)[rewrite]: When P is hidden, return it as-is unless #:replace-hidden? has been enabled. * tests/packages.scm ("package-input-rewriting/spec, replace hidden package"): New test. * doc/guix.texi (Defining Package Variants): Update. Change-Id: I0a7988cac70e0c6b88b0fe6e27c1036fa723e030 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Greg Hogan
2024-12-02pack: Add ‘--file=FILE’ with the same meaning as for ‘guix build’....* guix/scripts/pack.scm (%options): add --file=FILE, but no shorthand (that’s already taken for format). * doc/guix.texi (Invoking guix pack): Document it. Change-Id: I87797fccdf218ead3b7f471a84034e8a8d566245 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Arne Babenhauserheide
2024-12-01guix build: Add ‘--dependents’....* guix/scripts/build.scm (show-help, %options): Add ‘--dependents’. (dependents): New procedure. (options->things-to-build): Add ‘store’ parameter; honor ‘dependents’ option. [for-type]: Handle ‘dependents’ type. (options->derivations): Update call to ‘options->things-to-build’. * tests/guix-build.sh: Add test. * doc/guix.texi (Additional Build Options): Document ‘--dependents’. (Invoking guix refresh): Cross-reference it. * doc/contributing.texi (Submitting Patches): Mention it. Change-Id: I00b6d5831e1f1d35dc8b84a82605391d5a8f417c Ludovic Courtès
2024-12-01guix build: Add ‘--development’ option....* guix/scripts/build.scm (show-help, %options): Add ‘-D’. (options->things-to-build): Change ‘append-map’ to a loop. Honor ‘-D’. * tests/guix-build.sh: Add test. * doc/guix.texi (Additional Build Options): Document it. Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Change-Id: I99227aadfe861e43c001a4872292bd687b37f5d4 Ludovic Courtès
2024-11-29doc: Fix typos....* doc/guix.texi (origin Reference): Add missing ‘the’. (Mail Services): Fix spelling. Change-Id: I1ef06207b782a514d26a8f42a3d78de44b3d3f2a Florian Pelz
2024-11-29doc: Add "Contributing to Guix's infrastructure"....Use the "Call for contribution to the Guix infrastructure" by Ludovic Courtès to create a section in the documentation that describes how to contribute to the infrastructure. https://lists.gnu.org/archive/html/guix-devel/2024-05/msg00183.html * doc/contributing.texi (Contributing to Guix's infrastructure): New section. Change-Id: I3f3a99ad884110cc8323789e8c14bec1f7327e97 Ekaitz Zarraga
2024-11-24doc: Refer to up-to-date version of ‘gcc-toolchain’ in example....* doc/guix.texi (Writing Manifests): Write that for ‘gcc-toolchain’ we have GCC version 14 today. Change-Id: I9bfbe4a6d36b0dae16cafec86ce58ef50e64e50d Florian Pelz
2024-11-24doc: Fix typos....* doc/contributing.texi (Commit Access): Use @xref when beginning a sentence. * doc/guix.texi (package Reference): Likewise. (Invoking guix gc): Add missing words. (Invoking guix pack): Likewise. (Specifying Channel Authorizations): Move period after closing parenthesis. (origin Reference)[git-fetch, git-fetch/lfs]: Add missing optional argument. [svn-reference]: Add missing ‘the’. Change-Id: I8a5e475e928200299117e55274847319eeda8bdb Florian Pelz
2024-11-23pack: Add support for AppImage pack format....* guix/scripts/pack.scm (self-contained-appimage): New procedure. (%formats, show-formats): Add it. (guix-pack): Honor it. * doc/guix.texi: Document AppImage pack. * tests/pack.scm ("appimage", "appimage + localstatedir"): New tests. Co-authored-by: Noé Lopez <noelopez@free.fr> Change-Id: I33ebfec623cff1cfcd6f029d2d3054c23ab1949a Signed-off-by: Ludovic Courtès <ludo@gnu.org> Sebastian Dümcke
2024-11-23import: cpan: Support recursive imports....* guix/import/cpan.scm (cpan-module->sexp): Return two values. (cpan->guix-package): Add #:version. Return two values. (cpan-recursive-import): New procedure. * guix/scripts/import/cpan.scm (show-help, %options): Add ‘-r’. (guix-import-cpan): Adjust accordingly. Change-Id: Id167c7ddd079f4e04650ce7cc1692a9de36cd8fe Signed-off-by: Ludovic Courtès <ludo@gnu.org> zero@fedora
2024-11-23gnu: Add powertop-service-type....* gnu/services/pm.scm (powertop-shepherd-service) (powertop-service-type, powertop-configuration): New variables. * doc/guix.texi (Power Management Services): Document powertop-service-type. Change-Id: I1c5ef855526458ad54f62ca6e755da82acce1c4a Signed-off-by: Ludovic Courtès <ludo@gnu.org> Ian Eure
2024-11-20services: nginx-upstream-configuration: Allow file-like objects...* gnu/services/web.scm (emit-nginx-upstream-config): Support file-like objects. * doc/guix.texi (Web Services)[nginx-upstream-configuration]: Document it. Change-Id: I49996e358174dc77b31e3c91b908a6a72f3eb705 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Tomas Volf
2024-11-19doc: Explain ‘--’ syntax of ‘guix shell’ before giving examples....This paragraph is present in the ‘guix environment’ docs. I presume it clarifies ‘guix shell’ for newcomers as well. * doc/guix.texi (Invoking guix shell): Take over an introductory paragraph from ‘guix environment’ and use it for ‘guix shell’. Change-Id: I06280516ad3436260114b074c5f325e6984e9c76 Florian Pelz
2024-11-16gnu: postgresql-configuration: Unset default postgresql....* gnu/services/databases.scm (postgresql-configuration)[postgresql]: Unset default. (postgresql-service-type): Remove default-value. (postgresql-service): Revert default to postgresql-10 (rationale: We can remove this service at the same time than postgresql-10, in something like 6 months to a year). * doc/guix.texi: Remove postgresql default reference in documentation. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Nicolas Graves via Guix-patches via
2024-11-12doc: Fix `copy-recursively' arguments....The `select?' keyword is part of the description instead of immediately following `keep-permissions?' in the arguments list for `copy-recursively'. This adds a missing '@' to fix that. * doc/guix.texi (Build Utilities): Fix `copy-recursively' arguments. Change-Id: If6802490a6afebc884b039d84f1fe4f9202a1151 Signed-off-by: Ludovic Courtès <ludo@gnu.org> aurtzy
2024-11-12doc: Adjust stale reference to quote instead of gexp....* doc/guix.texi (Build Phases): Mention hash-tilde, not apostrophe. Change-Id: I8dca74da46d35692be122fb3e8e3ab40dd70606e Ludovic Courtès
2024-11-09build/go: Replace symlinks with a copy of the file....* guix/build/go-build-system.scm (fix-embed-files): New procedure. (%standard-phases): Add 'fix-embed-files after 'unpack. * guix/build-system/go.scm (#:embed-files): New key parameter. * doc/guix.texi: (go-build-system): Document a new key. Co-authored-by: Sharlatan Hellseher <sharlatanus@gmail.com> Change-Id: I27bc46fa1a3f4675ff73b6cba4ef5c3d177c22b1 Efraim Flashner
2024-11-09build-system/go: Allow providing additional test flags....By allowing the use of test flags, we can more precisely skip failing tests (for go version >=1.20), disable the vetting stage or select a subset of tests (e.g. if an upstream flag is provided to skip tests which require a network connection). At the moment, the only way around these test failures is to remove the test file completely or patch the code ourselves. * guix/build-system/go.scm (go-build): Add test-flags variable. (go-cross-build): Add test-flags variable. * guix/build/go-build-system.scm (check): Pass the additional test flags to the invoke call. * doc/guix.texi (go-build-system): Document <#:test-flags> parameter. Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com> Change-Id: I4015870fbbc15503cb405fe9ef6032953a5ff17f Troy Figiel
2024-11-05doc: Explicitly mention --localstatedir and --sysconfdir configure flags....Prior to this commit, the terms localstatedir and sysconfdir were used without being defined earlier in this section. This commit clarifies that they are configure flags. * doc/contributing.texi (Building from Git): Explicitly mention --localstatedir and --sysconfdir configure flags. Change-Id: I3e6edbbc1f2a342196e732e14257dbdf9a3f4303 Arun Isaac
2024-11-03services: guix: Add access control to daemon socket....* gnu/services/base.scm (guix-configuration-socket-directory-{permissions,group,user}): New fields. (guix-shepherd-service): Use them. * doc/guix.texi (Base Services): Document them. Change-Id: I8f4c2e20392ced47c09812e62903c87cc0f4a97a Signed-off-by: Ludovic Courtès <ludo@gnu.org> Reepca Russelstein
2024-11-03doc: Promote “Teams” section....Suggested by Simon Tournier <zimon.toutoune@gmail.com>. * doc/contributing.texi (Teams): Move from subsection of “Submitting Patches” to section of “Contributing”. Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Change-Id: Id21be29380fc981e74a5025b1467eebde8566726 Ludovic Courtès
2024-11-03doc: Add “Making Decisions” section....Suggested by Simon Tournier <zimon.toutoune@gmail.com>. * doc/contributing.texi (Making Decisions): New section, with paragraphs moved from… (Commit Access): … here. Cross-reference it. (Teams): Likewise. Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Change-Id: Ib276242e0ec7598a1b60dacdde8647bd3d3b85d3 Ludovic Courtès
2024-11-01services: anonip: Add 'debug?' configuration field....* gnu/services/web.scm (<anonip-configuration>) [debug?]: New field. (anonip-shepherd-service): Honor it. * doc/guix.texi (Log Rotation) <anonip-configuration>: Document it. Change-Id: Iaf57b5992808374b069a55c34a9adfdfe52b046c Maxim Cournoyer
2024-11-01doc: Use @table @code for anonip-configuration doc....* doc/guix.texi (Log Rotation): Use @table @code for anonip-configuration doc. Change-Id: Ib6f8136715ecabc81d53dc13a14f4b111302c5c9 Maxim Cournoyer
2024-10-31doc: Fix typos....* doc/guix.texi (Sway window manager): Fix typo. * doc/guix-cookbook.texi (Top): Rename Portuguese cookbook. Change-Id: I61569aa882862871d9bf02fa1a97f3f3b902b494 Florian Pelz
2024-10-31doc: Fix markup....* doc/contributing.texi (Source Tree Structure, Submitting Patches, Translating Guix): Write @command instead of @code when invoking guix. (Submitting Patches): Write @code instead of @command for a field name. * doc/guix-cookbook.texi (A ``Hello World'' package): Use @xref at the beginning of a sentence. (Auto-Login to a Specific TTY): Remove a space before @pxref. (Basic setup with manifests): Write @ref instead of (@pxref) after ``see''. Change-Id: I1ced2ebc4062b3a80878a7e0eea8f7a3d4baf7da Florian Pelz
2024-10-28gnu: postgresql: Deprecate unsupported versions....Versions 10 and 11 are unsupported according to https://www.postgresql.org/support/versioning/ postgresql-10 also has a CVE. * doc/guix.texi: Change default value of postgresql-service-type's postgresql field. * gnu/packages/databases.scm (postresql-10, postgresql-11): Use define-deprecated/public to warn users. * gnu/services/databases.scm (postgresql-configuration): Change the default value of postgresql-configuration-postgresql. * gnu/tests/guix.scm (%guix-data-service-os): Change the default value of postgresql. Signed-off-by: Andreas Enge <andreas@enge.fr> Change-Id: Ie8744c8e1f246e9b45ff5e29d4e98214de3ca66a Nicolas Graves
2024-10-20doc: Do not use numeric values in readymedia extra-config....* doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Use string value "60" instead of numeric value 60 in extra-config. Change-Id: Iea05409bb2f36fc4d0caafa375f0307bfae64a08 Arun Isaac
2024-10-20doc: Fix typo in readymedia example configuration....* doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Change media-directoriess to media-directories. Change-Id: Iea05409bb2f36fc4d0caafa375f0307bfae64a08 Arun Isaac
2024-10-18gnu: services: Add readymedia service....* gnu/services/upnp.scm, gnu/tests/upnp.scm: New files. * gnu/local.mk (GNU_SYSTEM_MODULES): Add them. * doc/guix.texi (Miscellaneous Services): Document the service. Change-Id: I6a3c9db9e7504df308038343ed48e4409a323581 Signed-off-by: Arun Isaac <arunisaac@systemreboot.net> Fabio Natali
2024-10-16Add copyright lines....They are related to commit eb1515849efa3e0d3d838cb04ea87100084068a0. * doc/guix.texi: Add copyright message. * gnu/services/networking.scm: Add copyright message. Change-Id: Ica510fd6e80228f124f0c084403e1dea7c9baa1b Signed-off-by: Ludovic Courtès <ludo@gnu.org> Nigko Yerden
2024-10-14doc: Define the purpose, membership, and creation of teams....* doc/contributing.texi (Teams): Define the purpose of teams; provide example; clarify membership and team creation. (Reviewing the Work of Others): Link to “Teams”. Change-Id: I5d75f69bc4653eb9da9c1d1f920718238ea83b9d Ludovic Courtès
2024-10-14services: tor: Add support for pluggable transports....Pluggable transports are programs that disguise Tor traffic, which can be useful in case Tor is censored. Pluggable transports cannot be configured by #:config-file file exclusively because Tor process is run via 'least-authority-wrapper' and cannot have access to transport plugin, which is a separate executable (Bug#70302, Bug#70332). * doc/guix.texi (Networking Services): Document 'tor-transport-plugin' data type and 'transport-plugins' option for 'tor-configuration. * gnu/services/networking.scm: Export 'tor-configuration-transport-plugins', 'tor-transport-plugin', 'tor-transport-plugin?', 'tor-plugin-role', 'tor-plugin-protocol', and 'tor-plugin-program'. (<tor-configuration>): Add 'transport-plugins' field. (<tor-transport-plugin>): New variable. (tor-configuration->torrc): Add content to 'torrc' computed-file. (tor-shepherd-service): Add file-system-mapping(s). Change-Id: I1b0319358778c7aee650bc843e021a6803a1cf3a Signed-off-by: Ludovic Courtès <ludo@gnu.org> Nigko Yerden
2024-10-14image: Add support for btrfs....* gnu/build/image.scm (make-btrfs-image): New variable. * gnu/system/image.scm (system-disk-image): Support btrfs. Change-Id: I80a5b52ec478ce5927d6208e324cbb70282c647a Signed-off-by: Ludovic Courtès <ludo@gnu.org> Roman Scherer
2024-10-14image: Use file system options in make-vfat-image....* gnu/build/image.scm (make-vfat-image): Use file system options. Change-Id: I791aadd2803d1ef96fc79cf8910a74a0083d2b6e Signed-off-by: Ludovic Courtès <ludo@gnu.org> Roman Scherer
2024-10-14services: configuration: Document multiple configurations per field....* gnu/services/configuration.scm (generate-documentation): Filter for all configurations associated with each field-name. * doc/guix.texi (Complex Configurations): Describe use case for multiple field-names. Change-Id: I6d1e7b8858231aa05fda884b31a9bd0a48f07293 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Herman Rimm
2024-10-14doc: Document home-shepherd-configuration-daemonize?...* gnu/home/services/shepherd.scm: Export home-shepherd-configuration-daemonize?. * doc/guix.texi (home-shepherd-configuration): Add entry for daemonize? field. Change-Id: Ifd1518c89fe8d5869d5e6469823dafd8457f24f1 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Dariqq
2024-10-14home: home-shepherd-configuration: Add silent? field....* gnu/home/services/shepherd.scm (home-shepherd-configuration): Add silent? field. (launch-shepherd-gexp): Conditionally invoke shepherd with --silent. * doc/guix.texi (home-shepherd-configuration): Document it. Change-Id: I1ce7a92c2777ebded39fe293b0bdcbd03562b4fc Signed-off-by: Ludovic Courtès <ludo@gnu.org> Dariqq
2024-10-14doc: Refer to ‘iso-codes’, not ‘iso-codes/pinned’....This effectively reverts 8e5c8303a414719c19a597247674be87fd500d45, which was unnecessary in this case and would break when evaluating ‘doc/build.scm’ against a previous Guix revision where ‘iso-codes/pinned’ is unbound. * doc/build.scm (localization-helper-module): Use ‘iso-codes’ rather than ‘iso-codes/pinned’. Change-Id: I95497fa474fb5ce89c7d2fe9bf0925a0cd438763 Ludovic Courtès
2024-10-14doc: Fix typos....* doc/guix.texi (Sound Services, Web Services, Miscellaneous Services, Invoking guix system, Sway window manager): Fix typos. Change-Id: I28c09ecb6034e4aae43ca6006b46fdb186832edd Florian Pelz
2024-10-12doc: Add “Deprecation Policy” section....* doc/contributing.texi (Deprecation Policy): New node. (Commit Access): Link to ‘package-removal-policy’. Change-Id: I5d095559920a3d9b791b5d919aab4e2f2a0c2dee Ludovic Courtès
2024-10-12home: services: Add 'home-sway-service-type'....* gnu/home/services/sway.scm: New file. (home-sway-service-type): New variable. (sway-configuration->file): New procedure. (sway-configuration): New configuration record. (sway-bar): New configuration record. (sway-output): New configuration record. (sway-input): New configuration record. (point): New configuration record. (sway-color): New configuration record. (sway-border-color): New configuration record. (sway-mode): New configuration record. (flatmap): New procedure. * gnu/local.mk: Add gnu/home/services/sway.scm. * doc/guix.texi (Sway window manager): New node to document the above changes. Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Change-Id: I880261570c5afdb795f2ce18bac2b9a5c898677f Arnaud Daby-Seesaram
2024-10-08doc: Update documentation for wayland? option of gdm-configuration....This is a follow-up to commit 06d01c610e ("services: gdm: Enable wayland by default."), which forgot updating the associated documentation. Change-Id: I3ea0402680e3e0f588db057988eb00af44ab4ae6 Maxim Cournoyer