ng0-packages/README

PACKAGES -- package definitions for GNU Guix
--------------------------------------------

Guix packages of various software, created by:
ng0 <ng0@no-reply.pragmatique.xyz>

A collection of custom GNU Guix packages that aren't suitable for
submission upstream at the moment or in general.

License
-------

AGPL3

This code is AGPL3 licensed. It will be relicensed the moment
it is merged into Guix.

URL
---

The current upstream of this repository is
http://git.pragmatique.xyz/ng0-packages/log.html

Its maintainer can be reached at https://people.pragmatique.xyz/ng0/

Usage
-----

Just point Guix towards the root of this source tree:

export GUIX_PACKAGE_PATH=/path/to/packages
or
guix package -L /path/to/packages -i package-name

The packages in this repository will take precedence over those in the
official distribution.

To make use of the packages in your GuixSD config file:

Be sure to have GUIX_PACKAGE_PATH for your shell exported,
for bash this could be achieved like this:

export GUIX_PACKAGE_PATH="/home/user/src/packages"

In the section of your systems "config.scm", you should find
something like this:

(use-modules (gnu) (gnu system nss))

Now to make use of "ii-ssl" as an systemwide installed package we change this
to:

(use-modules (gnu) (gnu system nss)
             (ng0 packages personalized))

and do the usual thing:
 - save
 - guix system build /etc/config.scm
 - sudo -E guix system reconfigure /etc/config.scm

The "-E" in "sudo -E" is important!

Bugs? Issues?
-------------

BUGS?! In my work?! Impossible!
Should you find bugs or anything to your disliking, report them on
the mailinglist found at https://pragmatique.xyz ... other methods
will be added. You can also find me on the mentioned chatserver on
that page.

Contributing?
-------------

clone the repository, do your changes, tell me the location (onion, ip, dyndns,
dns) of your repository and I will cherrypick the changes.
Otherwise you can send an email to me with patches through an mbox formated
version of your commits (via git format-patch).

TODO
----

For an mostly outdated TODO, read the "TODO" file.