bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-10 Thread Marek Paśnikowski
``` @node Specifying Additional Channels @section Specifying Additional Channels @cindex extending the package collection (channels) @cindex variant packages (channels) You can specify @emph{additional channels} to pull from. To use a channel, write @code{~/.config/guix/channels.scm} to instruct @

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-10 Thread Tobias Geerinckx-Rice via Bug reports for GNU Guix
> PS: (url "file://path/to/local/repository") Actually, 'path' is a hostname here, so I guess it *must not* work even as a relative file name. Whether Guix/Guile follows standards that well, or correctly errors out for an incorrect reason, I don't know. Kind regards, T G-R Sent on the go.

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-10 Thread Tobias Geerinckx-Rice via Bug reports for GNU Guix
Hi Marek, On 10 April 2022 12:55:09 UTC, "Marek Paśnikowski" wrote: >In light of the above replies [...] in CommonMark. Thanks! Please try to submit Texinfo going forward. It doesn't need to be perfect but it will be so much closer to something we can merge. You'll learn something, *and* sa

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-10 Thread Marek Paśnikowski
In light of the above replies and my own experiences, I propose the following to be the text of the chapter. Formatted in CommonMark. ## 6.1 Specifying Additional Channels You can specify _additional channels_ to pull from. To use a channel, write `~/.config/guix/channels.scm` to instruct `guix p

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > 2. If I create my own channel from scratch, > then I have to authorize it with my key. > Thus I know the commit and the key fingerprint. You don't have to do any authorization -- you can skip .guix- authorization and channel introducti

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > 3. For a local repository, use (url "file://") or (url "/path"). Yes, that should work. Greetings, Maxime. signature.asc Description: This is a digitally signed message part

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > 1. If I clone someone else's channel, do not bother with the > introduction. If with ‘clone’ you mean a ‘local git checkout+modifications’ here, and its a local clone, then probably yes --- if some attacker can replace the contents of

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > Regarding point 4.: I meant both /etc/config.scm and > ~/src/guix-config/home-configuration.scm . > My understanding is that it should be possible to define private > (user specific) channels. > I could be wrong here. > I do not like th

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Marek Paśnikowski
Thank you for the quick reply. Those are my conclusions: 1. If I clone someone else's channel, do not bother with the introduction. 2. If I create my own channel from scratch, then I have to authorize it with my key. Thus I know the commit and the key fingerprint. 3. For a local repository, use

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Maxime Devos schreef op ma 04-04-2022 om 19:53 [+0200]: > Marek Paśnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > > 3. How do I declare a local repository? > > The same way as an external repository.  Just replace the > "https://..."; > of the repo at savannah with > "file://home/user/locat

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 2. What ==is== the channel introduction? From (guix)Channel Authentication: As a user, you must provide a “channel introduction” in your channels file so that Guix knows how to authenticate its first commit. A channel specification

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > How do I find the PGP fingerprint? (guix)Channel Authentication The specification above shows the name and URL of the channel. The call to ‘make-channel-introduction’ above specifies that authentication of this channel starts at c

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 1. (channel (introduction -)) is not mentioned at all. It isn't in (guix)Specifying Aditional Channels, because its optional (albeit nice to have for security). It is documented in the next few sections. signature.asc Description: T

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 4. How do I declare a channel within the config.scm file? What do you mean with ‘the config.scm file’ here? The operating system configuration file, which is conventionally named configuration.scm or config.scm but in principle can be

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Maxime Devos
Marek Paśnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 3. How do I declare a local repository? The same way as an external repository. Just replace the "https://..."; of the repo at savannah with "file://home/user/location/of/git/repository". But yes, this could be documented ... Greeti

bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels

2022-04-04 Thread Marek Paśnikowski
Dear Guix Developers I love the Guix's vision of system management. Thank you for your hard work to implement it. It pains me greatly to see the documentation be completely useless. It gives descriptions of Guix programs, but almost nothing usable for configuration files. I am considering filing