summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2026-04-07doc: Fix documentation of the name service switch.Maxim Cournoyer
The previously referenced `nscd-service' procedure no longer exists. * doc/guix.texi (Name Service Switch): Adjust to refer to nscd-service-type and its nscd-configuration configuration record. Change-Id: Ib2b5ef69facf3489626782ad9dbd927a27c04084
2026-03-29doc: Add bcachefs to supported file systems footnote.Tobias Geerinckx-Rice
* doc/guix.texi (Keyboard Layout and Networking and Partitioning): Mention bcachefs as supported, provided you load the module. Change-Id: Iaadea6b2aabda2b803e1053b6d6195ad186d2e5c
2026-04-04services: Add gardenhostd-service-type.Noé Lopez
* gnu/services/desktop.scm (gardenhostd-service-type) (gardenhostd-configuration): New variables. * doc/guix.texi (Desktop Services): Document it. Change-Id: Ied926c34b620cc8032a0b121c7419644746e2ce9 Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2026-04-02doc: Version Control Services: Fix Fossil example.Nguyễn Gia Phong
In the Fossil service example, correct the field name for list-repositories? and set https? to #t. * doc/guix.texi (Version Control Services): Fix the example for fossil-service-type. Change-Id: Ib1c1ba57d8f438a51e8bb7b6e97c57785685e110 Reviewed-by: Noé Lopez <noelopez@free.fr>
2026-04-02services: cat-avatar-generator: Fix default cache directory.Evgeny Pisemsky
* gnu/services/web.scm (cat-avatar-generator-service): Append slash to default cache directory. * doc/guix.texi (PHP-FPM)<cat-avatar-generator-service>: Likewise. Mention requirements. Change-Id: Idd46deca135bf37133b46bee3ba535d9bedf9258 Merges: https://codeberg.org/guix/guix/pulls/5189 Reviewed-by: Yan Abu Arab <yanabuarab@gmail.com> Signed-off-by: Nguyễn Gia Phong <cnx@loang.net>
2026-03-29gnu: Add home-jellyfin-mpv-shim-service-type.Ian Eure
* gnu/home/services/media.scm (home-jellyfin-mpv-shim-service-type): New variable. * doc/guix.texi (Jellyfin Services): New section. * doc/guix.texi (Kodi Services): Add subheading. Change-Id: I037ab0602214fdaa1b032be51ff98ecf6b7ee16c
2026-03-29gnu: Add collectd-service-type.Ian Eure
* gnu/services/monitoring.scm: (collectd-plugin-generic, collectd-plugin-generic?, collectd-plugin-generic-load-plugin?, collectd-plugin-generic-name, collectd-plugin-generic-options, collectd-plugin-python, collectd-plugin-python?, collectd-plugin-python-load-plugin?, collectd-plugin-python-type-databases, collectd-plugin-python-type-packages, collectd-plugin-python-module-paths, collectd-plugin-python-log-traces?, collectd-plugin-python-log-interactive?, collectd-plugin-python-import, collectd-plugin-python-module, collectd-plugin?, %collectd-default-type-database, %collectd-pid-file, collectd-configuration, collectd-configuration?, collectd-configuration-collectd, collectd-configuration-base-directory, collectd-configuration-auto-load-plugin?, collectd-configuration-collect-internal-stats?, collectd-configuration-type-databases, collectd-configuration-interval, collectd-configuration-max-read-interval, collectd-configuration-timeout, collectd-configuration-read-threads, collectd-configuration-write-threads, collectd-configuration-write-queue-limit-high, collectd-configuration-write-queue-limit-low, collectd-configuration-host-name, collectd-configuration-fully-qualified-domain-name-lookup?, collectd-configuration-plugins, collectd-service-type): New variable. * doc/guix.texi (Monitoring Services): Document it. Change-Id: I18d581292979e85603e679b9441be3eeb1856949
2026-03-29services: web: Add sogogi service.Sören Tempel
* gnu/services/web.scm (sogogi-service-type): New services. (sogogi-serialize-section, sogogi-serialize-field) (sogogi-serialize-string, sogogi-serialize-list-of-strings) (sogogi-serialize-sogogi-user, sogogi-serialize-sogogi-location) (sogogi-serialize-list-of-sogogi-user): New procedures. (sogogi-user, sogogi-location) (sogogi-configuration): New record types. (sogogi-account-service): New variable. (sogogi-config-file, sogogi-shepherd-service): New procedures. * gnu/tests/web.scm (%test-sogogi): Add tests for the service. * doc/guix.texi (Web Services): Document it. Change-Id: I5cc6dd84d6c7c8d5d13b685853b19c5d433ed7e5
2026-03-28doc: Document home-activation-service-type extension.Noé Lopez
* doc/guix.texi (Essential Home Services): Document home-activation-service-type extension. Merges: https://codeberg.org/guix/guix/pulls/7531 Change-Id: I2f27db86b138ab03ebca866b4a8be51c367b375c Reviewed-by: jgart <jgart@dismail.de> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-03-25doc: Link to gexp research paper.Ludovic Courtès
* doc/guix.texi (G-Expressions): Add reference to the 2017 GPCE paper. Change-Id: I47f9357ee2715640e8ceb1f5d286d98bf6c55abc Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #7288
2026-03-25doc: Add ‘with-imported-modules’ caveat.Ludovic Courtès
* doc/guix.texi (G-Expressions): Document caveat under ‘with-imported-modules’. Change-Id: I9ee5452c7d776647961b282a0e6cefece165b00b Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-21gnu: home: services: Add home-git-annex-assistant-service-typeYarl Baudig
* gnu/home/services/git-annex-assistant.scm: New file. * gnu/local/mk (GNU_SYSTEM_MODULES): Register it. * doc/guix.texi (Miscellaneous Services): Document it. Change-Id: I9ca75210dfe7f6d2d81b9eb8919d6eb34c7bb002 Signed-off-by: Ian Eure <ian@retrospec.tv>
2026-03-20records: Let thunked fields refer to their inherited value.Ludovic Courtès
* guix/records.scm (make-syntactic-constructor)[field-index]: New procedure. [wrap-field-value]: Add optional argument ‘parent’. When it is true, bind F to the inherited field value. [field-bindings/inheritance]: New procedure. Use it. * tests/records.scm ("define-record-type* & thunked & no inherited value") ("define-record-type* & thunked & inherited value") ("define-record-type* & thunked & inherited value & this-record"): New tests. * doc/guix.texi (Defining Package Variants): Update ‘modify-inputs’ example to refer to ‘inputs’. (Writing Manifests): Likewise. * doc/guix-cookbook.texi (Package Variants): Likewise for ‘substitute-keyword-arguments’. Fixes: https://issues.guix.gnu.org/50335 Change-Id: If4e18155ce203637ff9e116ee8098f8997bfebe2
2026-03-19services: dbus: Add rtkit service.陈功
* gnu/services/dbus.scm (rtkit-service-type): New variable. (rtkit-configuration): New record. Change-Id: I5078cb5032824c7799e7d26962911bbc67527562 Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2026-03-18doc: Fix %childhurd-os example and memory-size documentation.Hugo Buddelmeijer
* doc/guix.texi (Virtualization Services): Fix %childhurd-os example and memory-size documentation. Change-Id: I5537eda4d0181e88229d836db522775494fc3d69 Signed-off-by: Maxim Cournoyer <maxim@guixotic.coop>
2026-03-14doc: Reintroduce mention of ‘bug-reference-mode’.Ludovic Courtès
* doc/contributing.texi (Emacs): Add @unnumberedsubsubsec commands. Add “Referencing Bug Reports” section. Change-Id: I21d7ecc022c00fc4d4cecf2273b1d46d8e770195 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6614
2026-03-14doc: Document Emacs-Guix for development.Ludovic Courtès
* doc/contributing.texi (Emacs): Document Emacs-Guix. Change-Id: I921f77425706709e49094ee96b28e29e29ad6878 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-14doc: Add references to “The Perfect Setup”.Ludovic Courtès
* doc/guix.texi (Defining Packages, Using the Configuration System): Add cross reference to “The Perfect Setup”. * doc/guix-cookbook.texi (A Scheme Crash Course): Likewise. Change-Id: If62960ffc01aadf9143b3816f4702f30b8052b90 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-14doc: Move “Guile Studio” and “Vim and NeoVim” under “The Perfect ↵Ludovic Courtès
Setup”. * doc/contributing.texi (The Perfect Setup): Add introduction. Move former body to … (Emacs): … this. (Alternative Setups): Remove. (Guile Studio, Vim and NeoVim): Move under “The Perfect Setup”. Change judgmental sentence. Change-Id: I149d418ac17a2283ad3452213b7425be4a8893f4 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-14doc: Remove “Viewing Bugs within Emacs”.Ludovic Courtès
This is a followup to d499253d47cca2694944c5fd1f4b582e5206890a and related commits. * doc/contributing.texi (Viewing Bugs within Emacs): Remove. (Debbugs User Interfaces): Refer to the ‘debbugs-ug’ manual. Change-Id: Idddff940302efe5689c8b459e0b141acaae74395 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-14doc, gnu: Update URL of several packages formerly at notabug.org.Ludovic Courtès
The URL change for these 5 packages was announced at <https://lists.gnu.org/archive/html/guile-user/2026-03/msg00000.html>. * doc/contributing.texi (Requirements): Update URLs. * gnu/packages/gnupg.scm (guile-gcrypt)[home-page]: Update. * gnu/packages/guile.scm (guile-sqlite3)[home-page]: Update. (guile-zlib)[source]: Update URL and hash. [home-page]: Update. (guile-lzlib)[home-page]: Update. (guile-zstd)[home-page]: Update. * m4/guix.m4 (GUIX_CHECK_GUILE_SQLITE3): Update commit URL. Merges guix/guix!7069 Change-Id: Ic587d3e2dcd931a44c007d9cdcd0b20e771be33b Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-03-11doc: Version Control Services: Generalize introduction.Nguyễn Gia Phong
* doc/guix.texi (Version Control Services): Update description to not be Git-exclusive. Update instroduction to mention Fossil in addition to Git. Add anchor points to navigate to individual services from the introduction. Change-Id: I3af870a80fcf249bed97b0d29370f71ff00a9e73 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #4354
2026-03-11services: Add fossil-service-type.Nguyễn Gia Phong
* gnu/services/version-control.scm (fossil-service-type, fossil-configuration): New public variables. * gnu/tests/version-control.scm (%test-fossil): Add system tests. * doc/guix.texi (Version Control Services): Add Fossil documentation. Change-Id: I84e09fe8c11e161ed7c4bdba42b0ae38ef4c2096 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-11services: Add and use shepherd-signal-action.Yelninei
* gnu/services/shepherd.scm (shepherd-signal-action): New procedure. * gnu/services/audio.scm (mpd-shepherd-service): Use it for actions. * gnu/services/base.scm (syslog-shepherd-service): * gnu/services/base.scm (dnsmasq-shepherd-service): * gnu/services/file-sharing.scm (transmission-daemon-shepherd-service): * gnu/services/monitoring.scm (vnstat-shepherd-service): * gnu/services/mail.scm (rspamd-shepherd-service): * doc/guix.texi (shepherd-signal-action): Document it. Change-Id: Ief5e00c7d430ec4aa28c3ef11d0ef9897793b45f Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6097
2026-03-10services: Generalize alsa-configuration.Liliana Marie Prikler
* gnu/packages/sound.scm (alsa-pcm-configuration, alsa-ctl-configuration): New configuration records. (serialize-alsa-pcm-configuration, serialize-alsa-ctl-configuration): New variables. (<alsa-configuration>): Remove alsa-plugins and pulseaudio?. Add default-pcm and default-ctl. Rename extra-options to options. (alsa-config-file): Adjust accordingly. (alsa-servcice-type): Add compose and extend. (<pulseaudio-configuration>): Add alsa-lib. (pulseaudio-alsa-configuration): New procedure. (pulseaudio-service-type): Extend alsa-servcice-type.
2026-03-09gnu: Add soju-service-type.Giacomo Leidi
* gnu/services/messaging.scm (%default-soju-shepherd-requirement): New variable. (soju-ssl-certificate): New configuration record. (soju-database): New configuration record. (soju-configuration): New configuration record. (serialize-soju-configuration,soju-activation,soju-accounts, soju-shepherd-services): New procedures. (soju-service-type): New service. (serialize-ngircd-configuration): Reformat. (pounce-configuration): Reformat. * doc/guix.texi: Document the new soju service. * gnu/tests/messaging.scm: Test the new soju service. Change-Id: I6223ecac1aaaab76bd75461851ffe4cec0678118
2026-03-08doc: Remove mention of python-toolchain.Sharlatan Hellseher
* doc/contributing.texi (Python Moduels): Drop mention of python-toolchain. * guix/build-system/pyproject.scm: Likewise. Fixes: guix/guix#5841 Change-Id: I39a1ec7ce6da2e5f3298323b36070c3e3b197669
2026-03-07gnu: home: dotfiles: Fix inclusion of directories having .git in their name.Giacomo Leidi
* gnu/home/services/dotfiles.scm (%home-dotfiles-excluded): Replace .git/.* with /.git/.* . * doc/guix.texi: Document it. Fixes https://codeberg.org/guix/guix/issues/6808 Change-Id: Ib6c824bb4bf5a5b3d6939807667c7961ce0cf6d2
2026-03-07gnu: Add tuned-service-type.Giacomo Leidi
* gnu/services/linux.scm (tuned-configuration,tuned-settings,tuned-ppd-settings): New configuration records. (tuned-file-systems,tuned-activation,tuned-shepherd-services, tuned-kernel-modules): New procedures. (tuned-service-type): New service type. * doc/guix.texi: Add service documentation. Change-Id: I6c8d54c23175c2ea133d99965641c548fb1d6452
2026-03-03services: readymedia: Allow relative paths to media directories.Sughosha
* gnu/services/upnp.scm (readymedia-activation): For home services, if the media directory paths are relative, create it in the user's home directory. * doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Update doc. Change-Id: I39176320d6c33c56c5b80ad9e67e989ee41565da
2026-03-03doc: Refresh python documentation.Nicolas Graves
* doc/contributing.texi: Refresh python documentation (avoid uses of "we " and "you", remove the reference to pyproject-build-system as experimental, and adjust the setuptools situation comments). Merges: https://codeberg.org/guix/guix/pulls/6427 Change-Id: Idb065befc975063ad97e6bdafb724e50d6891cb5 Reviewed-by: Yan Abu Arab <yanabuarab@gmail.com> Reviewed-by: Maxim Cournoyer <maxim@guixotic.coop> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-03-02doc: Fix typo in home-readymedia-service-type example.chris0ax
* doc/guix.texi (Miscellaneous Home Services): Change readymedia-directory to readymedia-media-directory in home-readymedia-service-type example. Merges: https://codeberg.org/guix/guix/pulls/5496 Change-Id: Ica68a26bef7e960bbda769a1a04798d86bbe7d1e Reviewed-by: Sergey Trofimov <sarg@sarg.org.ru> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-03-01gnu: services: Add gunicorn-service-type.Fabio Natali
* gnu/services/web.scm (<gunicorn-configuration>, <gunicorn-app>): New records. (unix-socket?, unix-socket-path, gunicorn-activation, gunicorn-shepherd-services): New procedures. (gunicorn-service-type): New variable. * doc/guix.texi (Web Services): Document the new service. Co-authored-by: Arun Isaac <arunisaac@systemreboot.net> Change-Id: I3aa970422e6a5d31158b798b1061e6928ad2160b Signed-off-by: jgart <jgart@dismail.de>
2026-03-01doc: Fix typo.Florian Pelz
* doc/guix.texi (Package Transformation Options): Fix typo. Change-Id: I27186684db1355d9876ecc23e76f8bcc8cdbf9eb
2026-02-27doc: Refer to more online manuals at doc.guix.gnu.org.Ludovic Courtès
* doc/htmlxref.cnf: Add grub, inetutils, and recutils. Change-Id: Icaa85d59c64b5f1ff7d34fa3e368ee1f66054fcc
2026-02-25services: Support list of strings for oci-container-configuration's entrypoint.Giacomo Leidi
Dockerfile's ENTRYPOINT statement supports also a list of strings. This patch implements this behavior for oci-container-configuration. * oci/services/containers.scm (string-or-list-of-strings?): New procedure. (oci-container-configuration)[entrypoint]: Change field type to maybe-string-or-list-of-strings. (oci-container-configuration->options): Use it. * doc/guix.texi: Document it. Change-Id: I1c94dec79c9f4b2324225810a7926be251bfd795 Reviewed-by: Owen T. Heisler <writer@owenh.net> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-02-22gnu: home: dotfiles: Files not excluded when they should.Giacomo Leidi
* gnu/home/services/dotfiles.scm (%home-dotfiles-excluded): Match content of .git directories. (directory-contents): Match whole file-name instead of basename. * doc/guix.texi: Document it. Fixes <https://issues.guix.gnu.org/71217> Authored-by: Nicolas Odermatt-Lemay <nodermattlemay@gmail.com> Change-Id: I2929fe3318e1f9f0b552c891207524dea25389ed Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-22doc: Improve raid-device-mapping documentation.Hugo Buddelmeijer
* doc/guix.texi (Mapped Devices): Move examples into the mapping defvars. Add how to load kernel modules for raid. Add RAID cindex. Change-Id: If2d3f3c48940d2428b36bdd85d31c8288db35f3b Signed-off-by: Ludovic Courtès <ludo@gnu.org> Modified-by: Ludovic Courtès <ludo@gnu.org> Merges: #6512
2026-02-22doc: Mention online documentation.Ludovic Courtès
* doc/guix.texi (Documentation): Mention the online manual and doc.guix.gnu.org. Change-Id: I5abdd85fa2166890323f99a99c30136400791bdd Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6563
2026-02-22services: readymedia: Fix configurations.Sughosha
* gnu/services/upnp.scm (%readymedia-default-log-directory): Remove variable. (%readymedia-default-log-file): New procedure. (%readymedia-default-cache-directory): Turn it into a procedure. (<readymedia-configuration>)[log-directory]: Remove field. [log-file]: New field. [cache-directory]: Set to %readymedia-default-cache-directory. (readymedia-configuration->config-file): Remove "user" and "log_dir" fields. (readymedia-shepherd-service)[modules]: Add (shepherd support). [start]: Do not map the log-directory. For home services, do not wrap the program with least-authority-wrapper. (readymedia-activation): Do not create the log-directory. * gnu/home/services/upnp.scm (%readymedia-cache-file, %readymedia-cache-path, %readymedia-log-path): Remove variables. (run-readymedia-test): Use the procedures properly. Do not test the log directory. Test the log file. * doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Update doc. Change-Id: I97d84b5287c374ddb26a495f20a36f986b0c142d Signed-off-by: Giacomo Leidi <therewasa@fishinthecalculator.me>
2026-02-10gexp: Add 'delayed-object'.David Elsing
* guix/gexp.scm (<delayed-object>): New record type. (delayed-object): New macro. (delayed-object-compiler): New gexp compiler. * tests/gexp.scm ("delayed-object"): New test. * doc/guix.texi (G-Expressions): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-02-10doc: Refer to on-line manuals at doc.guix.gnu.org.Ludovic Courtès
* doc/htmlxref.cnf: Add entries for 20 manuals at doc.guix.gnu.org. Change-Id: I28ff7b00d024214bf22b6ae06bc873528a0c7440 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6271
2026-02-10services: Fix logging for jami-service-type.Maxim Cournoyer
Its default behavior changed and it no longer logs to syslog by default; update to log to /var/log/jami.log instead. * gnu/services/telephony.scm (jami-configuration->command-line-arguments): Drop /dev/log mapping. Add /var/log/jami.log mapping. Always add --console argument. (jami-shepherd-services): Conditionally add #:log-file argument; simplify usernames logic a bit. * gnu/services/telephony.scm (jami-configuration): Update doc. * doc/guix.texi (Telephony Services): Likewise. Change-Id: Ia2819866c84db4cba92fad52dfd0a74acdc887fc
2026-02-09gnu: services: Add xandikos-service-type.Wilko Meyer
* gnu/services/dav.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add file. * doc/guix.texi (DAV Services): Document the service. Change-Id: I5345efd579f9e527eb8798397b52bf1b9b4cab56
2026-02-08services: web: Add go-webdav.Sören Tempel
* gnu/services/web.scm (go-webdav-service-type): New service. (go-webdav-account-service): New variable. (go-webdav-shepherd-service): New procedures. * gnu/tests/web.scm (%test-go-webdav): Add tests for the service. * doc/guix.texi (Web Services): Document it. Signed-off-by: Danny Milosavljevic <dannym@friendly-machines.com>
2026-02-08import/elpa: Add GNU-devel repository.Maxim Cournoyer
* guix/import/elpa.scm (%elpa-archives): Register GNU-devel archive. * doc/guix.texi (Invoking guix import): Document it. Change-Id: If036334477be7537ff70a62d4900427d74bc05db
2026-02-06services: static-networking: Add ‘scope’ field to <network-route>.Ludovic Courtès
* gnu/services/base.scm (assert-network-route-scope): New procedure. (<network-route>)[scope]: New field. (network-set-up/linux)[route-scope->constant]: New procedure. Use it to pass #:scope to ‘route-add’. * doc/guix.texi (Networking Setup): Document it. Fixes: guix/guix#4175 Reported-by: Christopher Baines <mail@cbaines.net> Change-Id: I24399eca6e691d63fa3d01be564060a3d693d650 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #5507
2026-02-03doc: Document “standard” pull requests and AGit.Ludovic Courtès
* doc/contributing.texi (Submitting Patches): Document “standard” pull requests and AGit. Merges guix/guix!5840 Change-Id: I8fe93e4dde0b9543f3bd99c66cf1fdb6ba69c449 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Remove “Debbugs Usertags” section.Ludovic Courtès
* doc/contributing.texi (Debbugs Usertags): Remove. Merges guix/guix!5840 Change-Id: If550e31918c495ed24578fcbaaa179eb36521687 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Update Debbugs deprecation warnings.Ludovic Courtès
* doc/contributing.texi (The Issue Tracker): Update deprecation notice. (Debbugs User Interfaces): Likewise. Merges guix/guix!5840 Change-Id: Ic5c1bddddbb8c53b031d52887f57372759badf8b Signed-off-by: Cayetano Santos <csantosb@inventati.org>
generated by cgit v1.3 (git 2.53.0) at 2026-05-27 17:06:06 +0000