John Darrington <j...@gnu.org> skribis:
> * doc/guix.texi: Added various @cindex tags to assist readers.
That’s a good idea, there were too few entries so far.
A general remark: please pay attention to spelling and case, like
“Guix”, “SSH”, etc.
> +@cindex installing guix
> GNU Guix is available for download from its website at
“Guix”
> +@cindex installation guix from binaries
“installing Guix from binaries”
> @item
> +@cindex authorized substitutes
Also:
@cindex substitutes, authorization thereof
(I’ve just reread what the Texinfo manual has to say, and it’s always
enlightening (info "(texinfo) Index Entries").)
> @item
> +@cindex substitutes
> Installing @uref{http://gnutls.org/, GnuTLS-Guile} will allow you to
> access @code{https} URLs for substitutes, which is highly recommended
> (@pxref{Substitutes}). It also allows you to access HTTPS URLs with the
This part doesn’t really talk about substitutes, not sure if it’s a good
idea to have an entry here.
> +@cindex nix
@cindex Nix, compatibility
> @noindent
> +@cindex authorized substitutes
> Each build machine must authorize the key of the master machine so that
> it accepts store items it receives from the master:
This doesn’t talk about substitute authorization in general, so I
wouldn’t put this entry here.
> +@cindex installing packages
> +@cindex removing packages
Maybe also “package installation” and “package removal”.
> @cindex security
> @cindex digital signatures
> +@cindex authorized substitutes
Also @cindex substitutes, authorization thereof.
> +@cindex exporting
“exporting store items”
> @item @code{initrd} (default: @code{base-initrd})
> +@cindex initrd
Also @cindex initial RAM disk.
> @node User Accounts
> @subsection User Accounts
>
> +@cindex users
Also:
@cindex user accounts
@cindex accounts
> +@cindex tor
“Tor”
> +@cindex ssh
“SSH server”
> +@cindex ssh
Ditto.
OK with changes along these lines, thank you!
Ludo’.
