Skip to content

Commit 34f0fda

Browse files
committed
guix: Small updates to README wording
1 parent 402e3a5 commit 34f0fda

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

contrib/guix/README.md

+15-12
Original file line numberDiff line numberDiff line change
@@ -40,12 +40,14 @@ Otherwise, follow the [Guix installation guide][guix/bin-install].
4040

4141
Guix allows us to achieve better binary security by using our CPU time to build
4242
everything from scratch. However, it doesn't sacrifice user choice in pursuit of
43-
this: users can decide whether or not to bootstrap and to use substitutes.
43+
this: users can decide whether or not to bootstrap and to use substitutes
44+
(pre-built packages).
4445

4546
After installation, you may want to consider [adding substitute
46-
servers](#speeding-up-builds-with-substitute-servers) to speed up your build if
47-
that fits your security model (say, if you're just testing that this works).
48-
This is skippable if you're using the [Dockerfile][fanquake/guix-docker].
47+
servers](#speeding-up-builds-with-substitute-servers) from which to download
48+
pre-built packages to speed up your build if that fits your security model (say,
49+
if you're just testing that this works). Substitute servers are set up by
50+
default if you're using the [Dockerfile][fanquake/guix-docker].
4951

5052
If you prefer not to use any substitutes, make sure to supply `--no-substitutes`
5153
like in the following snippet. The first build will take a while, but the
@@ -164,14 +166,15 @@ find output/ -type f -print0 | sort -z | xargs -r0 sha256sum
164166
_This whole section is automatically done in the convenience
165167
[Dockerfiles][fanquake/guix-docker]_
166168

167-
For those who are used to life in the fast _(and trustful)_ lane, you can use
168-
[substitute servers][guix/substitutes] to enable binary downloads of packages.
169+
For those who are used to life in the fast _(and trustful)_ lane, you can
170+
specify [substitute servers][guix/substitutes] from which to download pre-built
171+
packages.
169172

170173
> For those who only want to use substitutes from the official Guix build farm
171174
> and have authorized the build farm's signing key during Guix's installation,
172175
> you don't need to do anything.
173176
174-
#### Authorize the signing keys
177+
#### Step 1: Authorize the signing keys
175178

176179
For the official Guix build farm at https://ci.guix.gnu.org, run as root:
177180

@@ -185,7 +188,7 @@ For dongcarl's substitute server at https://guix.carldong.io, run as root:
185188
wget -qO- 'https://guix.carldong.io/signing-key.pub' | guix archive --authorize
186189
```
187190

188-
#### Use the substitute servers
191+
#### Step 2: Specify the substitute servers
189192

190193
The official Guix build farm at https://ci.guix.gnu.org is automatically used
191194
unless the `--no-substitutes` flag is supplied.
@@ -215,9 +218,9 @@ As mentioned at the bottom of [this manual page][guix/bin-install]:
215218
216219
### When will Guix be packaged in debian?
217220

218-
Vagrant Cascadian has been making good progress on this
219-
[here][debian/guix-package]. We have all the pieces needed to put up an APT
220-
repository and will likely put one up soon.
221+
Thanks to Vagrant Cascadian's diligent work, Guix is now [in debian
222+
experimental][debian/guix-experimental]! Hopefully it will make its way into a
223+
release soon.
221224

222225
[b17e]: http://bootstrappable.org/
223226
[r12e/source-date-epoch]: https://reproducible-builds.org/docs/source-date-epoch/
@@ -229,5 +232,5 @@ repository and will likely put one up soon.
229232
[guix/substitute-server-auth]: https://www.gnu.org/software/guix/manual/en/html_node/Substitute-Server-Authorization.html
230233
[guix/time-machine]: https://guix.gnu.org/manual/en/html_node/Invoking-guix-time_002dmachine.html
231234

232-
[debian/guix-package]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=850644
235+
[debian/guix-experimental]: https://packages.debian.org/experimental/guix
233236
[fanquake/guix-docker]: https://github.com/fanquake/core-review/tree/master/guix

0 commit comments

Comments
 (0)