summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2026-01-25gnu: texlive: Deprecate in favor of texlive-scheme-full.Andreas Enge
* gnu/packages/texlive.scm (%texlive-date, %texlive-year, texlive-extra-src, texlive-texmf-src, texlivebin, texlivetexmf): Delete variables. (texlive): Redefine as texlive-scheme-full. * gnu/packages/books.scm: Remove module inclusion. * doc/guix.texi: Remove documentation for monolithic texlive. Change-Id: I23837ca29cbbc080833be122972dcfe31c0fd1bb Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-22doc: Use devel url on master.Rutherther
To prevent redirection to the versioned maual, use devel on master branch. * doc/htmlxref.cnf: Point GUIX to devel manual. Change-Id: I6b2bf3b78ca5815ff49e6ebe50bc12383e64a7fd
2026-01-22Merge branch 'version-1.5.0'Rutherther
Change-Id: Id73c0c74600a3da3373b3a37236b505af65bfe31
2026-01-19doc: Use versioned URL for references to translated Guix manuals.Ludovic Courtès
Partly addresses guix/guix#5725. * doc/htmlxref.cnf (GUIX): Add /1.5.0. Change-Id: I49ef15c00ca45b83a48ba0d1366b79a108e1e1a8 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #5754
2026-01-19import: nuget: Add tests and documentation.Danny Milosavljevic
* guix/import/nuget.scm: Prevent optimizing small functions away completely. * tests/import/nuget.scm: New file. * doc/guix.texi (nuget): Document it. * Makefile.am (SCM_TESTS): Add reference to it. Fixes: guix/guix#5483 Change-Id: Id58932fe404a11a03e61a91d3b6177b39548f1bc
2026-01-19doc: Use markup for commands in “Upgrading Guix”.Ludovic Courtès
This is a followup to d5cf3b5defa8e224194ac0b195eb07fcb9d27a02. * doc/guix.texi (Upgrading Guix): Use markup for commands. Change-Id: I0b751ddc7f0e8e57813be23c809c23ade1e6cbd1 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #5724
2026-01-19doc: Move “When you’re done” instructions right after ↵Ludovic Courtès
‘guix-install.sh’. * doc/guix.texi (Binary Installation): Move “When you’re done” instructions right after script execution. Change-Id: I70c9015add401a6ad6465941f423a3c4c9ef9b24 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Mention the tarball URL and clarify binary installation steps.Ludovic Courtès
* doc/guix.texi (Binary Installation): Mention the tarball URL. Clarify what the steps do. Change-Id: Ic929b10c29b69752fd549b78295682bdf4fb76f6 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Move ‘guix-install.sh’ commands upfront in “Binary Installation”.Ludovic Courtès
* doc/guix.texi (Binary Installation): Move installation commands upfront. Change-Id: Ie63837f29d5c2f25e3e50039facb8cdb12ba2f82 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Reword introduction to ‘guix-install.sh‘.Ludovic Courtès
* doc/guix.texi (Binary Installation): Reword introduction to ‘guix-install.sh’. Change-Id: I51a1f55191cccde3800ef32a7a8ebe15f5e2c813 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Link to ‘guix-install.sh’ upfront under “Binary Installation”.Ludovic Courtès
* doc/guix.texi (Binary Installation): Link to the script upfront rather than in a footnote. Change-Id: Icd89d0e9bb0c701b6b956ce214015e5466299bf3 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Remove ‘#’ from code snippets to allow for copy/paste.Ludovic Courtès
* doc/guix.texi (Binary Installation): Remove leading ‘#’ from code snippets. Change-Id: Id459799ffdf26da3f9ab2907ed68e0ac7eb857fc Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Use @command for commands under “Binary Installation”.Ludovic Courtès
* doc/guix.texi (Binary Installation): Use @command and @code appropriately. Change-Id: If2d0d25a3e7e97c19f14c6f70143b5481b49b727 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Move instructions about ‘guix’ from other distros to the bottom.Ludovic Courtès
* doc/guix.texi (Binary Installation): Move paragraphs about ‘guix’ packages of other distros to the bottom. Change-Id: Ie7c3484e40fb0dbe502e81f17e2d74b7afa0e777 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-19doc: Remove Parabola instructions from “Binary Installation”.Ludovic Courtès
This reverts 0f9fe721be2bd36e52b520782b585ca49aa1447d. The rationale is that there’s no reason to single out Parabola and, more importantly, it obscures the message of this section. * doc/guix.texi (Binary Installation): Remove Parabola instructions. Change-Id: Ib7b2b0629d8e3a90cd09705cc2dcde15df8f51a2 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-18doc: Bump version to 1.5.0.Rutherther
* doc/build.scm (%latest-guix-version): Bump to 1.5.0. (stylized-html): Move to versioned manual URL. (html-manual): Use versioned manual URL. Change-Id: I82048a9548894e335e7c2427a739733304a7961a Fixes: #5681 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #5715
2026-01-18import: crate: Generate comments with ‘TODO REVIEW:’ prefix.Hilton Chain
This distinguishes them from manually added ones. When committing changes, these ‘TODO REVIEW’ comments should be addressed and removed first. If you're working with Rust packaging, please update your local Guix to this commit to apply the change. * guix/import/crate.scm (cargo-lock->expressions): Generate comments with ‘TODO REVIEW:’ prefix. * tests/import/crate.scm ("crate-lockfile-import"): Don't check the exact comment string. * doc/guix-cookbook.texi (Common Workflow for Rust Packaging), * gnu/packages/rust-crates.scm: Adjust accordingly. Change-Id: I76b914b49be46d04cc61b101b6bc9e31cadb7f07 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #4567
2026-01-18gnu: rust-crates: Add ‘package:’ prefix for replaced crates.Hilton Chain
This avoids definitions like ‘(define rust-pipewire-0.8.0.fd3d8f7 rust-pipewire-0.8.0.fd3d8f7)’. * gnu/packages/rust-crates.scm: Import (gnu packages rust-sources) module with ‘package:’ prefix. * etc/teams/rust/rust-crates.tmpl, * doc/guix-cookbook.texi (Cargo Workspaces and Development Snapshots): Adjust accordingly. Change-Id: Ie41556d8f30db65e968d8e8238491f1345eeed59 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-18import: crate: Generate comments with ‘TODO REVIEW:’ prefix.Hilton Chain
This distinguishes them from manually added ones. When committing changes, these ‘TODO REVIEW’ comments should be addressed and removed first. If you're working with Rust packaging, please update your local Guix to this commit to apply the change. * guix/import/crate.scm (cargo-lock->expressions): Generate comments with ‘TODO REVIEW:’ prefix. * tests/import/crate.scm ("crate-lockfile-import"): Don't check the exact comment string. * doc/guix-cookbook.texi (Common Workflow for Rust Packaging), * gnu/packages/rust-crates.scm: Adjust accordingly. Change-Id: I76b914b49be46d04cc61b101b6bc9e31cadb7f07 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #4567
2026-01-18gnu: rust-crates: Add ‘package:’ prefix for replaced crates.Hilton Chain
This avoids definitions like ‘(define rust-pipewire-0.8.0.fd3d8f7 rust-pipewire-0.8.0.fd3d8f7)’. * gnu/packages/rust-crates.scm: Import (gnu packages rust-sources) module with ‘package:’ prefix. * etc/teams/rust/rust-crates.tmpl, * doc/guix-cookbook.texi (Cargo Workspaces and Development Snapshots): Adjust accordingly. Change-Id: Ie41556d8f30db65e968d8e8238491f1345eeed59 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-16doc: Rename package variants index anchor terms.Simon Tournier
* doc/guix.texi (Package Transformation Options): Add index term and move index term from here... (Defining Package Variants): ...to here and add index term. Fixes: guix/guix#2191 Change-Id: I8ed71d3db8a6c70368f9ae37d159622a5512db42 Signed-off-by: Gabriel Wicki <gabriel@erlikon.ch>
2026-01-15doc: Remove paragraph stating Xorg display server used by default.Christopher O'Neill
* doc/guix.texi (Desktop Services): Remove paragraph. (X Window): Remove corresponding anchor. * po/doc/guix-manual.de.po, po/doc/guix-manual.fr.po: Likewise. Change-Id: Ib545f15e51585fcc5abdb804e6d9eb0f47cb2179 Co-authored-by: Florian Pelz <pelzflorian@pelzflorian.de> Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de> Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-15doc: Better explain extra development tools when building from git.Hugo Buddelmeijer
* doc/contributing.texi (Building from Git): Better explain adding tools. Change-Id: I47fb9e5414edc5eebce64d25db6998cc51985fcb Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #4821 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-15doc: Explain that some test require network when building from git.Hugo Buddelmeijer
* doc/contributing.texi (Building from Git): Discuss network tests. Change-Id: I21c8e4a1e60ed215a6fb3507b7aedc1835f735ad Signed-off-by: Ludovic Courtès <ludo@gnu.org> Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-15doc: Improve building from git instructions.Hugo Buddelmeijer
* doc/contributing.texi (Building from Git): Improve instructions. Include 'cd' and authorizing the directory for guix shell. Change-Id: Ied8eb7553ab92504a87c0059820ca154a18c33ab Signed-off-by: Ludovic Courtès <ludo@gnu.org> Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-08services: Add opensnitch-service.Danny Milosavljevic
* gnu/services/opensnitch.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add reference to it. * doc/guix.texi (Miscellaneous Services, Security): Document it. * gnu/tests/security.scm (%test-opensnitch): New variable. Change-Id: I63d1b6636b3aaecf399664ec97383d82ff1391d1
2026-01-07doc: Remove paragraph stating Xorg display server used by default.Christopher O'Neill
* doc/guix.texi (Desktop Services): Remove paragraph. (X Window): Remove corresponding anchor. * po/doc/guix-manual.de.po, po/doc/guix-manual.fr.po: Likewise. Change-Id: Ib545f15e51585fcc5abdb804e6d9eb0f47cb2179 Co-authored-by: Florian Pelz <pelzflorian@pelzflorian.de> Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de>
2026-01-06services: Add luanti-service-type.Maxim Cournoyer
* gnu/services/games.scm (luanti-configuration): New variable. (%luanti-account): Likewise. (luanti-activation): New procedure. (luanti-shepherd-service): Likewise. (luanti-service-type): New variable. * gnu/tests/games.scm: New file. Change-Id: I65a1dcf832fa8add9c9d278d82bab91ca3eef086 Reviewed-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2026-01-05doc: Better explain extra development tools when building from git.Hugo Buddelmeijer
* doc/contributing.texi (Building from Git): Better explain adding tools. Change-Id: I47fb9e5414edc5eebce64d25db6998cc51985fcb Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #4821
2026-01-05doc: Explain that some test require network when building from git.Hugo Buddelmeijer
* doc/contributing.texi (Building from Git): Discuss network tests. Change-Id: I21c8e4a1e60ed215a6fb3507b7aedc1835f735ad Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-01-05doc: Improve building from git instructions.Hugo Buddelmeijer
* doc/contributing.texi (Building from Git): Improve instructions. Include 'cd' and authorizing the directory for guix shell. Change-Id: Ied8eb7553ab92504a87c0059820ca154a18c33ab Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-01-04doc: Add missing double quotes in ‘mapped-device’ snippet.Ludovic Courtès
* doc/guix.texi (Mapped Devices): Add missing double quotes in ‘luks-device-mapping’ example. Change-Id: I5bcd980ec3d5d142ea37697575f539d640bc6466 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-26doc: Add missing double quotes in ‘mapped-device’ snippet.Ludovic Courtès
* doc/guix.texi (Mapped Devices): Add missing double quotes in ‘luks-device-mapping’ example. Change-Id: I5bcd980ec3d5d142ea37697575f539d640bc6466
2025-12-25Merge branch 'version-1.5.0'Rutherther
Change-Id: I5a36bbdb772c88f71fbe612cf6c445c34088e35c
2025-12-23doc: Briefly discuss default git branch name.Hugo Buddelmeijer
* doc/contributing.texi (Building from git): Discuss branch name. Change-Id: I9ddb9318749c7974a8724355c1a6b18a98fa9e8e Signed-off-by: Gabriel Wicki <gabriel@erlikon.ch>
2025-12-22image: Add qcow2-gpt image type.Rutherther
qcow2 is a mbr-hybrid image. But on aarch64, we have to use grub-efi bootloader. For that bootloader, gpt should be used and Guix errors if it isn't (due to failed check in Guix code). So it's impossible to generate qcow2 type aarch64 image without using customized bootloader. One would have to define their own image instead of using the ones pre-defined. * gnu/system/system.scm (qcow2-gpt-image-type): New variable. * doc/guix.texi: Document qcow2-gpt and its use. Change-Id: I93f0880c7ca2d3f934067c12dd1143ad20828333 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-22etc: Add AppArmor profile for the daemon.Noé Lopez
* .gitignore: Add etc/apparmor.d/tunables/guix. * Makefile.am (nodist_apparmor_profile_DATA) (nodist_apparmor_profile_tunables_DATA): Define it. * configure.ac: Generate etc/apparmor.d/tunables/guix. Add --with-apparmor-profile-dir option. * etc/apparmor.d/guix-daemon: New file. * etc/apparmor.d/tunables/guix.in: New file. * doc/guix.texi: Document AppArmor profiles. * gnu/packages/package-management.scm (guix): Add future changes commented. Change-Id: Iac7df9d642383cc46a2d450c3badef31199ab041 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-22services: Modernize redis service.Ashvith Shetty
* gnu/services/databases.scm (redis-configuration): Rewrite using `define-configuration'. (redis-shepherd-service): Honor it. * doc/guix.texi (Database Services) <redis>: Regenerate documentation. Change-Id: I5b99822ca3d8d23fb5133497d00eada0336d0c65 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #2158
2025-12-22doc: Fix typo.Nguyễn Gia Phong
* doc/guix.texi (Mapped Devices): Fix typo. Change-Id: I72a5e0e651e3926def0bd5fdb67ccc01cc8a2041 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-20doc: Warn about specific nologin paths when it is not in PATH.Noé Lopez
See <https://codeberg.org/guix/guix/issues/4704#issuecomment-8751141>. * doc/guix.texi (Build Environment Setup): Add warning in case the nologin binary is not found. Reported-by: FuncProgLinux Change-Id: Ib8aa2bdaf0aef6a589afe638e2fcd539c8276ac7 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-20doc: Update information on installing guix with package managers.Noé Lopez
There is no longer a guix package in Debian. Adapt the instructions to avoid having to list how to install on every package manager. The specific instructions for Parabola are kept since it is a FSDG system. * doc/guix.texi (Binary Installation): Remove Debian and OpenSUSE installation instructions. Update examples of distros with a guix package. Add instructions for other package managers. Change-Id: Ie34b40d7224593df8e51d62d665a15a1b16b8e70 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-20doc: Mention that services doing mounts should depend on user-file-systems.Rutherther
This is a recent change. If the services do not depend on it, it's possible user-file-systems will try to unmount the file systems byt itself first. * doc/guix.texi (Shepherd Services): Mention services should depend on user-file-systems if they do mounts. Change-Id: I87f459aa43c2a59ffcae35750e02a08abc3c1f8a Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2025-12-19monad-repl: Add "graft?" command.Tomas Volf
Grafts are not always required when just exploring in the REPL, and they do take time, so this commit adds easy way to disable them. * guix/monad-repl.scm (build-graft): New meta command. * doc/guix.texi (Using Guix Interactively): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-12-13doc: Warn that extra-special-file files persist.Hugo Buddelmeijer
* doc/guix.tex (Base Services)[extra-special-file]: Add warning regarding special files persisting after extra-special-file call is removed from the system config. Change-Id: I29cb3a31ee45894293d9becf3c0ebe93ea7f0da4 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #2810
2025-12-11services: oci: Fix oci-image value field handling.Owen T. Heisler
* gnu/services/containers.scm (lower-oci-image-state, oci-lowerable-image?): Remove support for gexps and correctly lower file-like objects. * doc/guix.texi: Remove gexp from oci-image value field description. Fixes: guix/guix#3818 Change-Id: Ib812d65b32dd68f8572fcb371ab4521d22e5336c Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #3819
2025-12-08doc: Remove unreachable reference from the Cookbook.Ludovic Courtès
* doc/guix-cookbook.texi (A Scheme Crash Course): Remove “Scheme at a Glance”, which is no longer accessible. Change-Id: Ia60bf461d0410ddd042b0ad7d792548749c4cc7c Signed-off-by: Gabriel Wicki <gabriel@erlikon.ch>
2025-12-08doc: Add reference to Guix-Packager.Ludovic Courtès
* doc/guix.texi (Defining Packages): Wrap ‘guix import’ reference in @quotation. Add reference to Guix-Packager. Change-Id: I5ba1b0f66e8edd2548fb05fa6fca06d3432c7460 Signed-off-by: Gabriel Wicki <gabriel@erlikon.ch>
2025-12-08doc: Use a gexp in “Defining Packages”.Ludovic Courtès
* doc/guix.texi (Defining Packages): Update ‘arguments’ field in example to use ‘list’ and a gexp. Remove description of quote/unquote; document gexps instead. Change-Id: I2ed1f5796d76e8c389227aed58fd31aa76edbb9a Signed-off-by: Gabriel Wicki <gabriel@erlikon.ch>
2025-12-05doc: Mention newgidmap tool for systemd installationsSimon Josefsson
* doc/guix.texi (Binary Installation): Mention newgidmap. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-12-03services: hurd-vm: Support persistent images again.Ludovic Courtès
Fixes a regression introduced in bab6434f5855b92631615fdd8a2d2a225da28359 whereby following the example from the manual regarding non-volatile images would no longer work. * gnu/services/virtualization.scm (hurd-vm-shepherd-service): Pass ‘image’ to ‘system-image’ only if it’s an image. * doc/guix.texi (Virtualization Services): Explicitly say that the ‘image’ field can contain a file name. Remove use of ‘const’ for the ‘image’ field in persistent image example and adjust text. Fixes: guix/guix#4130 Reported-by: Maxim Cournoyer <maxim@guixotic.coop> Change-Id: I1a81ce27fb45978a681310b8a8788ab671b3edf8