~ruther/guix-local

ref: d58da8a56b75af73a7b5466f7ef8a81679713aa3 guix-local/doc d---------
519524f9 — Ludovic Courtès 8 months ago
doc: Use versioned URL for references to translated Guix manuals.

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
2e2f80fa — Ludovic Courtès 8 months ago
doc: Use markup for commands in “Upgrading Guix”.

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
b12d80ae — Ludovic Courtès 8 months ago
doc: Move “When you’re done” instructions right after ‘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>
02840cc7 — Ludovic Courtès 8 months ago
doc: Mention the tarball URL and clarify binary installation steps.

* doc/guix.texi (Binary Installation): Mention the tarball URL.  Clarify what
the steps do.

Change-Id: Ic929b10c29b69752fd549b78295682bdf4fb76f6
Signed-off-by: Rutherther <rutherther@ditigal.xyz>
6e89d38c — Ludovic Courtès 8 months ago
doc: Move ‘guix-install.sh’ commands upfront in “Binary Installation”.

* doc/guix.texi (Binary Installation): Move installation commands upfront.

Change-Id: Ie63837f29d5c2f25e3e50039facb8cdb12ba2f82
Signed-off-by: Rutherther <rutherther@ditigal.xyz>
a92a0dda — Ludovic Courtès 8 months ago
doc: Reword introduction to ‘guix-install.sh‘.

* doc/guix.texi (Binary Installation): Reword introduction to
‘guix-install.sh’.

Change-Id: I51a1f55191cccde3800ef32a7a8ebe15f5e2c813
Signed-off-by: Rutherther <rutherther@ditigal.xyz>
6275c911 — Ludovic Courtès 8 months ago
doc: Link to ‘guix-install.sh’ upfront under “Binary Installation”.

* 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>
93e1f4e3 — Ludovic Courtès 8 months ago
doc: Remove ‘#’ from code snippets to allow for copy/paste.

* doc/guix.texi (Binary Installation): Remove leading ‘#’ from code snippets.

Change-Id: Id459799ffdf26da3f9ab2907ed68e0ac7eb857fc
Signed-off-by: Rutherther <rutherther@ditigal.xyz>
f45b68fe — Ludovic Courtès 8 months ago
doc: Use @command for commands under “Binary Installation”.

* doc/guix.texi (Binary Installation): Use @command and @code appropriately.

Change-Id: If2d0d25a3e7e97c19f14c6f70143b5481b49b727
Signed-off-by: Rutherther <rutherther@ditigal.xyz>
60005904 — Ludovic Courtès 8 months ago
doc: Move instructions about ‘guix’ from other distros to the bottom.

* 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>
32c28c68 — Ludovic Courtès 8 months ago
doc: Remove Parabola instructions from “Binary Installation”.

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>
077aaa11 — Rutherther 8 months ago
doc: Bump version to 1.5.0.

* 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
import: crate: Generate comments with ‘TODO REVIEW:’ prefix.

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
1232e535 — Hilton Chain 10 months ago
gnu: rust-crates: Add ‘package:’ prefix for replaced crates.

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>
a2f6d5c4 — Christopher O'Neill 9 months ago
doc: Remove paragraph stating Xorg display server used by default.

* 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>
d08d7c6e — Hugo Buddelmeijer 9 months ago
doc: Better explain extra development tools when building from git.

* 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>
74d66546 — Hugo Buddelmeijer 9 months ago
doc: Explain that some test require network when building from git.

* 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>
d32b285b — Hugo Buddelmeijer 9 months ago
doc: Improve building from git instructions.

* 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>
cf005b51 — Ludovic Courtès 9 months ago
doc: Add missing double quotes in ‘mapped-device’ snippet.

* doc/guix.texi (Mapped Devices): Add missing double quotes in
‘luks-device-mapping’ example.

Change-Id: I5bcd980ec3d5d142ea37697575f539d640bc6466
Signed-off-by: Rutherther <rutherther@ditigal.xyz>
20157dae — Rutherther 10 months ago
image: Add qcow2-gpt image type.

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>
Next