aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 0ee16cbcecabf49e82ce2f7f5f6edb03aa7fe1be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# de Paul records

Software freedom empowers sharing.  Let's dedicate our libre software projects
to saints known for fostering sharing!

This Autoconf macro pakage is dedicated to St. Lawrence, a deacon martyred in
ancient Rome.  Emperor Valerian — after having the pope executed — demanded that
Lawrence hands over all Church's treasures.  Lawrence asked for 3 days to gather
all valueable items but instead used that time to give everything to the poor.
He's said to have told the emperor "These are the treasures of the Church."
while pointing at the poor roman folk.

## What's here?

Currently, there's just one macro, `AX_ADD_GUILE_PRE_INST_ENV()`.  It causes a
`pre-inst-env` script to be written at user-chosen path (relative to build dir)
at `configure` time.  The script helps amend the `GUILE_LOAD_PATH`,
`GUILE_LOAD_COMPILED_PATH` and `PATH` environment variables with useful paths —
by default `src/guile`, `src/guile` and `srcipts`, respectively, all relative to
build directory.

The script can be invoked as

```shell-script
./pre-inst-env <command> [arguments]...
```

to run the specified command with the desired environment or without arguments

```shell-script
./pre-inst-env
```

to spawn a shell with these environment variables defined.

Look at [de Paul records](https://git.koszko.org/de-paul-records/about) for an
example of how this can be integrated into a project.

## Building & installation

This software has a Guix package definition in Wojtek's [personal
channel](https://git.koszko.org/guix/about).  That can serve you as a point of
reference.

## Copying

The source code of this package is available under CC0 v1.0.  The repository is
kept compliant with the [REUSE](https://reuse.software/) specification, version
3.0.