doc: Explain how to use local guix repositories.
* doc/guix.texi (Using a Custom Guix Channel): Add note and example on how to exempt a local guix repository from git ownership checks. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
This commit is contained in:
parent
3809aa01a1
commit
c756c62cfd
1 changed files with 20 additions and 1 deletions
|
@ -81,7 +81,7 @@ Copyright @copyright{} 2020, 2021 Brice Waegeneire@*
|
||||||
Copyright @copyright{} 2020 R Veera Kumar@*
|
Copyright @copyright{} 2020 R Veera Kumar@*
|
||||||
Copyright @copyright{} 2020, 2021, 2022 Pierre Langlois@*
|
Copyright @copyright{} 2020, 2021, 2022 Pierre Langlois@*
|
||||||
Copyright @copyright{} 2020 pinoaffe@*
|
Copyright @copyright{} 2020 pinoaffe@*
|
||||||
Copyright @copyright{} 2020 André Batista@*
|
Copyright @copyright{} 2020, 2023 André Batista@*
|
||||||
Copyright @copyright{} 2020, 2021 Alexandru-Sergiu Marton@*
|
Copyright @copyright{} 2020, 2021 Alexandru-Sergiu Marton@*
|
||||||
Copyright @copyright{} 2020 raingloom@*
|
Copyright @copyright{} 2020 raingloom@*
|
||||||
Copyright @copyright{} 2020 Daniel Brooks@*
|
Copyright @copyright{} 2020 Daniel Brooks@*
|
||||||
|
@ -5412,6 +5412,25 @@ From there on, @command{guix pull} will fetch code from the @code{super-hacks}
|
||||||
branch of the repository at @code{example.org}. The authentication concern is
|
branch of the repository at @code{example.org}. The authentication concern is
|
||||||
addressed below (@pxref{Channel Authentication}).
|
addressed below (@pxref{Channel Authentication}).
|
||||||
|
|
||||||
|
Note that you can specify a local directory on the @code{url} field above if
|
||||||
|
the channel that you intend to use resides on a local file system. However,
|
||||||
|
in this case @command{guix} checks said directory for ownership before any
|
||||||
|
further processing. This means that if the user is not the directory owner,
|
||||||
|
but wants to use it as their default, they will then need to set it as a safe
|
||||||
|
directory in their global git configuration file. Otherwise, @command{guix}
|
||||||
|
will refuse to even read it. Supposing your system-wide local directory is at
|
||||||
|
@code{/src/guix.git}, you would then create a git configuration file at
|
||||||
|
@code{~/.gitconfig} with the following contents:
|
||||||
|
|
||||||
|
@example
|
||||||
|
[safe]
|
||||||
|
directory = /src/guix.git
|
||||||
|
@end example
|
||||||
|
|
||||||
|
@noindent
|
||||||
|
This also applies to the root user unless when called with @command{sudo} by
|
||||||
|
the directory owner.
|
||||||
|
|
||||||
@node Replicating Guix
|
@node Replicating Guix
|
||||||
@section Replicating Guix
|
@section Replicating Guix
|
||||||
|
|
||||||
|
|
Reference in a new issue