summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2026-02-03doc: Remove “Sending a Patch Series” section.Ludovic Courtès
* doc/contributing.texi (Sending a Patch Series): Remove. Merges guix/guix!5840 Change-Id: I8f15c4385b24cecc6a8f1bd13c2065d2a267e5b1 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Contributions are now made on Codeberg.Ludovic Courtès
* doc/contributing.texi (Submitting Patches): Document Codeberg pull requests as the only method. Mention guix-patches@gnu.org in a footnote. Remove paragraphs about of ‘git send-email’ and the associated workflow. Merges guix/guix!5840 Reported-by: Nick Blumenauer <nicknb@posteo.com> Change-Id: Ifbd46665a14a83f014ddff4234cc69bf93c3a8d1 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-02home: services: ssh: Add support for known_hosts2 file.Oleg Pykhalov
This commit adds a new 'known-hosts2' field to the OpenSSH home service configuration, enabling a hybrid approach to SSH host key management. * gnu/home/services/ssh.scm (<home-openssh-configuration>)[known-hosts2]: New field. (openssh-configuration-files): Generate ~/.ssh/known_hosts2 when specified. * doc/guix.texi (Secure Shell): Document new 'known-hosts2' field. Change-Id: I1d314706eaf6af9547833020abe857f4d8c44b86
2026-01-27serialization: Use ‘bytevector-slice’ from Guile >= 3.0.9.Ludovic Courtès
* guix/serialization.scm (sub-bytevector): Remove. (read-byte-string): Use ‘bytevector-slice’. * configure.ac: Require Guile 3.0.9. * doc/contributing.texi (Requirements): Adjust accordingly. Change-Id: I7aa11a2182530ea5131be591db03b17efb6847a4 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #4495
2026-01-27services: Add endlessh-service-type.Clombrong
* docs/guix.texi: Document EndleSSH service and configuration. * gnu/services/ssh.scm: New service. * gnu/services/ssh.scm: Define shepherd service. Merges: https://codeberg.org/guix/guix/pulls/5910 Co-Authored-By: Giacomo Leidi <therewasa@fishinthecalculator.me> Change-Id: Ief4520b536276b88f2e5027ef0897bf84b2835df Signed-off-by: Giacomo Leidi <therewasa@fishinthecalculator.me>
2026-01-27doc: Fix typo.Maxim Cournoyer
* doc/guix.texi (Invoking guix import): Fix typo. Change-Id: I4d9234ac3c4d83f64d36e7aedf4c67e9eaf79167
2026-01-26doc: Fix hello package example.Charles Roelli
* doc/guix.texi (Defining Packages): Fix package example. Change-Id: Ib3bf14f50a938de569b7eb1927ec18d9ee5d1e5c Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #5838
2026-01-26doc: cookbook: Don’t insist on mounting home directories on the head node.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up a Head Node): State that mounting home directories on the head node is “optional”. Change-Id: Id60b54d463f5422f71a71607cd71ed347a98865e Merges: #5890
2026-01-26doc: cookbook: Recommend systemd timer for ‘guix gc’.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up a Head Node): Give instructions for the systemd timer rather than ‘crontab’. Change-Id: I063ad0ea694500a67553d66d37ae354b9c078a65
2026-01-26doc: cookbook: Update for unprivileged guix-daemon execution.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up a Head Node): Add note about unprivileged guix-daemon. Remove ‘--build-users-group=guixbuild’ flag from ‘.service’ snippets. Mention “systemd timer” next to “crontab entry”. Change-Id: I72ac59d3ce8a5572dbeb8cb4c7764a8478f6e1ee
2026-01-25transformations: Add ‘--amd-gpu’ transformation option.Ludovic Courtès
* guix/transformations.scm (split-on-commas): New procedure, moved from… (transform-package-toolchain): … here. (package-amd-gpu-specialization, transform-package-amd-gpu-targets): New procedures. (%transformations, %options): Add ‘amd-gpu’. * tests/transformations.scm ("options->transformations, amd-gpu") ("options->transformations, amd-gpu, not applicable") ("options->transformations, amd-gpu, missing clang-rocm input") ("options->transformations, amd-gpu, wrong GPU"): New tests. * doc/guix.texi (Package Transformation Options): Document it. Change-Id: I56bf0dffbf12bc08cf6318fe56952473b395c303 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #5583 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25doc: Add an URL link.Hartmut Goebel
* doc/guix.texi (Services)[Telephony Services]{Jami}: Add link to the Jami project home-page. Change-Id: If8e5ad61f9f36c0403e74d6926e89eb463bb009b Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25doc: Small rewording.Hartmut Goebel
* doc/guix.texi (Services)[Continuous Integration]: Add quotes to mark terms as such. Fix typo. Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25doc: Fix an URL.Hartmut Goebel
* doc/guix.texi (Services)[Desktop Services]: Fix an URL. Signed-off-by: Rutherther <rutherther@ditigal.xyz>
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>