[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
09/11: doc: Move channel @cindex within their nodes.
From: |
guix-commits |
Subject: |
09/11: doc: Move channel @cindex within their nodes. |
Date: |
Sun, 27 Sep 2020 16:55:25 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit 8e2d5a0c0d0542f220fff16d92c6b5267ebbcc1f
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Sun Sep 27 22:42:40 2020 +0200
doc: Move channel @cindex within their nodes.
* doc/guix.texi (Channels): Move @cindex at the beginning of the node
they refer to from the end of the previous node.
---
doc/guix.texi | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index d20b33c..81f46cc 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4852,11 +4852,11 @@ introduction from a trusted source since that is the
root of your trust.
If you're curious about the authentication mechanics, read on!
-@cindex personal packages (channels)
-@cindex channels, for personal packages
@node Creating a Channel
@section Creating a Channel
+@cindex personal packages (channels)
+@cindex channels, for personal packages
Let's say you have a bunch of custom package variants or personal packages
that you think would make little sense to contribute to the Guix project, but
would like to have these packages transparently available to you at the
@@ -4919,10 +4919,10 @@ Authentication}, and @ref{Specifying Channel
Authorizations}, for info
on how to do it.
-@cindex subdirectory, channels
@node Package Modules in a Sub-directory
@section Package Modules in a Sub-directory
+@cindex subdirectory, channels
As a channel author, you may want to keep your channel modules in a
sub-directory. If your modules are in the sub-directory @file{guix}, you must
add a meta-data file @file{.guix-channel} that contains:
@@ -4933,11 +4933,11 @@ add a meta-data file @file{.guix-channel} that contains:
(directory "guix"))
@end lisp
-@cindex dependencies, channels
-@cindex meta-data, channels
@node Declaring Channel Dependencies
@section Declaring Channel Dependencies
+@cindex dependencies, channels
+@cindex meta-data, channels
Channel authors may decide to augment a package collection provided by other
channels. They can declare their channel to be dependent on other channels in
a meta-data file @file{.guix-channel}, which is to be placed in the root of
@@ -4975,10 +4975,10 @@ For the sake of reliability and maintainability, you
should avoid dependencies
on channels that you don't control, and you should aim to keep the number of
dependencies to a minimum.
-@cindex channel authorizations
@node Specifying Channel Authorizations
@section Specifying Channel Authorizations
+@cindex channel authorizations
@anchor{channel-authorizations}
As we saw above, Guix ensures the source code it pulls from channels
comes from authorized developers. As a channel author, you need to
@@ -5076,10 +5076,10 @@ authentication! Pay attention to merges in particular:
merge commits
are considered authentic if and only if they are signed by a key present
in the @file{.guix-authorizations} file of @emph{both} branches.
-@cindex primary URL, channels
@node Primary URL
@section Primary URL
+@cindex primary URL, channels
Channel authors can indicate the primary URL of their channel's Git
repository in the @file{.guix-channel} file, like so:
@@ -5099,10 +5099,10 @@ This feature only makes sense for authenticated
repositories, such as
the official @code{guix} channel, for which @command{guix pull} ensures
the code it fetches is authentic.
-@cindex news, for channels
@node Writing Channel News
@section Writing Channel News
+@cindex news, for channels
Channel authors may occasionally want to communicate to their users
information about important changes in the channel. You'd send them all
an email, but that's not convenient.
- branch master updated (d753aee -> b0cd4e0), guix-commits, 2020/09/27
- 01/11: guix build: Add '--without-tests'., guix-commits, 2020/09/27
- 05/11: packages: 'package-input-rewriting' has a #:deep? parameter., guix-commits, 2020/09/27
- 08/11: doc: Move "Primary URL" after "Specifying Channel Authorizations"., guix-commits, 2020/09/27
- 11/11: gnu: qjackctl: Update to 0.6.3., guix-commits, 2020/09/27
- 06/11: doc: Update the master menu., guix-commits, 2020/09/27
- 03/11: packages: 'package-input-rewriting/spec' can rewrite implicit dependencies., guix-commits, 2020/09/27
- 02/11: packages: 'package-mapping' can recurse on implicit inputs., guix-commits, 2020/09/27
- 04/11: packages: 'package-mapping' correctly recurses into 'replacement'., guix-commits, 2020/09/27
- 07/11: doc: Promote "Channels" as chapter and reorder., guix-commits, 2020/09/27
- 09/11: doc: Move channel @cindex within their nodes.,
guix-commits <=
- 10/11: gnu: Add grokmirror., guix-commits, 2020/09/27