snow-fort-guix-channel/README.md

[Snow fort](https://snow-fort.org) packages as [Guix](https://guix.gnu.org/)
[channel](https://guix.gnu.org/manual/en/html_node/Channels.html).

The relevant part of Guix manual is
[Additional Channels](https://guix.gnu.org/manual/en/html_node/Specifying-Additional-Channels.html).
But here are short instructions anyway.

## Note about dependencies

Only libraries which are in snow-fort and not (scheme ...) or (srfi ...) are added to the Guix
package as dependency.

See the part about installing srfi-libraries for more details.

## Add the Guix channell

Copy this:

<pre>
(cons (channel
       (name 'snow-fort)
       (url "https://gitea.scheme.org/Rinne/snow-fort-guix-channel.git"))
 %default-channels)
</pre>

Into:

    ~/.config/guix/channels.scm

## Update the channels

Run:

    guix pull

## Installing packages

The packages have been prefixed with "snow-", and spaces replaced with "-".

So for example to install package (arvyy mustache) run:

    guix install snow-arvyy-mustache

or:

    guix shell snow-arvyy-mustache

## Using the libraries

When you install a library it will be in path:

    ${SNOW_LIBRARY_PATH}/usr/lib/snow

To use the libraries add the installation path into your implementations load path.

Example with Guile:

    guix install snow-arvyy-mustache
    guile --r7rs -L ${SNOW_LIBRARY_PATH}/usr/lib/snow

Example with Gauche:

    guix install snow-arvyy-mustache
    gosh -r7 -A ${SNOW_LIBRARY_PATH}/usr/lib/snow

Example with Sagittarius:

    guix install snow-arvyy-mustache
    sash -r7 -L ${SNOW_LIBRARY_PATH}/usr/lib/snow

## Installing SRFI libraries

SRFI libraries are not yet packaged into this channel. See related
[issue](https://gitea.scheme.org/Rinne/snow-fort-guix-channel/issues/2).