aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorWojtek Kosior <koszko@koszko.org>2023-12-12 17:08:29 +0100
committerW. Kosior <koszko@koszko.org>2024-05-03 14:46:37 +0200
commit34c7c18379d3868deb4e1cbd08b01dc125a131a3 (patch)
tree49471b54b3658a647d737ce1eb39b2ea751467a4 /README
parentaa9ac252206615713ab988d7068da9e14a9bccc0 (diff)
downloadguix-34c7c18379d3868deb4e1cbd08b01dc125a131a3.tar.gz
guix-34c7c18379d3868deb4e1cbd08b01dc125a131a3.zip
Personalize the README.
Change-Id: I18e2ba1eafedd42fcc06c4eba6e41b20bb57967b
Diffstat (limited to 'README')
-rw-r--r--README23
1 files changed, 23 insertions, 0 deletions
diff --git a/README b/README
index b9f36f8344..31d3197788 100644
--- a/README
+++ b/README
@@ -1,5 +1,28 @@
-*- mode: org -*-
+This is [[https://koszko.org/koszko.html][Wojtek]]'s Guix fork. It serves as a home for personal modifications
+and additions that for some reason aren't in upstream Guix. These may include
+package and service definitions, as well as changes to Guix itself. You're
+free to clone this repository and use it for your own needs. But if you
+choose to do so, please be ready to deal with some peculiarities.
+
+- The tip this repository is intended to be frequently rebased on top of
+ upstream Guix so expect ~git pull~ to complain.
+- As a result of the rebasing approach, the ~--allow-downgrades~ flag has to
+ be used when running ~guix pull~ or ~guix (system|home) reconfigure~.
+- As another result of the rebasing approach, there's no PGP authorization (it
+ would not be possible to provide it reliably). The =.guix-authorizations=
+ file is removed by one of the tip commits to remove the warning from ~guix
+ pull~.
+- If you don't know what all this means, this is probably not for you. Try
+ [[https://guix.gnu.org/][upstream Guix]] instead :)
+
+Feel free to look into the ~koszko-scripts~ branch to see the scripts I am
+using to maintain this thing. Note they might prove pretty useless to you.
+
+
+* The original README introduction
+
[[https://www.gnu.org/software/guix/][GNU Guix]] (IPA: /ɡiːks/) is a purely functional package manager, and
associated free software distribution, for the [[https://www.gnu.org/gnu/gnu.html][GNU system]]. In addition
to standard package management features, Guix supports transactional