Next: Configuring ASDF to find your systems --- old style, Previous: Configuring ASDF, Up: Configuring ASDF [Contents][Index]
In order to compile and load your systems, ASDF must be configured to find the .asd files that contain system definitions.
There are a number of different techniques for setting yourself up with ASDF, starting from easiest to the most complex:
If you install software there, you don’t need further configuration.3
source-registry
facility,
fully described in its own chapter of this manual.
See Controlling where ASDF searches for systems. Here is a quick
recipe for getting started:
The simplest way to add a path to your search path, say /home/luser/.asd-link-farm/ is to create the directory ~/.config/common-lisp/source-registry.conf.d/ and there create a file with any name of your choice, and with the type conf4, for instance 42-asd-link-farm.conf, containing the line:
(:directory "/home/luser/.asd-link-farm/")
If you want all the subdirectories under /home/luser/lisp/ to be recursively scanned for .asd files, instead use:
(:tree "/home/luser/lisp/")
ASDF will automatically read your configuration the first time you try to find a system. If necessary, you can reset the source-registry configuration with:
(asdf:clear-source-registry)
asdf:*central-registry*
.
For more details about this, see the following section,
Configuring ASDF to find your systems --- old style.
Unless you need to understand this,
skip directly to Configuring where ASDF stores object files.
Note that your Operating System distribution or your system administrator may already have configured system-managed libraries for you.
~/common-lisp/ is only included in the default configuration starting with ASDF 3.1.2 or later.
By requiring the .conf extension, and ignoring other files, ASDF allows you to have disabled files, editor backups, etc. in the same directory with your active configuration files.
ASDF will also ignore files whose names start with a . character.
It is customary to start the filename with two digits, to control the
sorting of the conf
files in the source registry directory, and
thus the order in which the directories will be scanned.
Next: Configuring ASDF to find your systems --- old style, Previous: Configuring ASDF, Up: Configuring ASDF [Contents][Index]