and there create a file with any name of your choice,
and there create a file with any name of your choice,
and with the type @file{conf},
and with the type @file{conf}@footnote{By requiring the @file{.conf}
for instance @file{42-asd-link-farm.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 @file{.} character.
It is customary to start the filename with two digits, to control the
sorting of the @code{conf} files in the source registry directory, and
thus the order in which the directories will be scanned.},
for instance @file{42-asd-link-farm.conf},
containing the line:
containing the line:
@kbd{(:directory "/home/luser/.asd-link-farm/")}
@kbd{(:directory "/home/luser/.asd-link-farm/")}
...
@@ -465,20 +500,9 @@ to be recursively scanned for @file{.asd} files, instead use:
...
@@ -465,20 +500,9 @@ to be recursively scanned for @file{.asd} files, instead use:
@kbd{(:tree "/home/luser/lisp/")}
@kbd{(:tree "/home/luser/lisp/")}
Note that your Operating System distribution or your system administrator
may already have configured system-managed libraries for you.
@c FIXME: clarify.
The required @file{.conf} extension allows you to have disabled files
or editor backups (ending in @file{~}), and works portably
(for instance, it is a pain to allow both empty and non-empty extension on CLISP).
Excluded are files the name of which start with a @file{.} character.
It is customary to start the filename with two digits
that specify the order in which the directories will be scanned.
ASDF will automatically read your configuration
ASDF will automatically read your configuration
the first time you try to find a system.
the first time you try to find a system.
You can reset the source-registry configuration with:
If necessary, you can reset the source-registry configuration with:
@lisp
@lisp
(asdf:clear-source-registry)
(asdf:clear-source-registry)
...
@@ -487,14 +511,28 @@ You can reset the source-registry configuration with:
...
@@ -487,14 +511,28 @@ You can reset the source-registry configuration with:
@c FIXME: too specific. Push this down to discussion of dumping an
@c FIXME: too specific. Push this down to discussion of dumping an
@c image?
@c image?
And you probably should do so before you dump your Lisp image,
@c And you probably should do so before you dump your Lisp image,
if the configuration may change
@c if the configuration may change
between the machine where you save it at the time you save it
@c between the machine where you save it at the time you save it
and the machine you resume it at the time you resume it.
@c and the machine you resume it at the time you resume it.
Actually, you should use @code{(asdf:clear-configuration)}
@c Actually, you should use @code{(asdf:clear-configuration)}
before you dump your Lisp image, which includes the above.
@c before you dump your Lisp image, which includes the above.
@item
In earlier versions of ASDF, the system source registry was configured
using a global variable, @code{asdf:*central-registry*}. For more
details about this, see the following section, @ref{Configuring ASDF to
find your systems --- old style}. Unless you need to understand this,
skip directly to @ref{Configuring where ASDF stores object files}.
@end itemize
Note that your Operating System distribution or your system administrator
may already have configured system-managed libraries for you.
@node Configuring ASDF to find your systems --- old style, Configuring where ASDF stores object files, Configuring ASDF to find your systems, Loading ASDF
@section Configuring ASDF to find your systems --- old style
@section Configuring ASDF to find your systems --- old style
The old way to configure ASDF to find your systems is by
The old way to configure ASDF to find your systems is by
...
@@ -580,6 +618,7 @@ but it is supported for old users, and for users who want to programmatically
...
@@ -580,6 +618,7 @@ but it is supported for old users, and for users who want to programmatically
control what directories are added to the ASDF search path.
control what directories are added to the ASDF search path.
@node Configuring where ASDF stores object files, Resetting the ASDF configuration, Configuring ASDF to find your systems --- old style, Loading ASDF
@section Configuring where ASDF stores object files
@section Configuring where ASDF stores object files
@findex clear-output-translations
@findex clear-output-translations
...
@@ -659,11 +698,11 @@ ASDF-Binary-Locations is now not needed anymore and should not be used.
...
@@ -659,11 +698,11 @@ ASDF-Binary-Locations is now not needed anymore and should not be used.
cl-launch 3.000 and common-lisp-controller 7.2 have been updated
cl-launch 3.000 and common-lisp-controller 7.2 have been updated
to just delegate this functionality to ASDF.
to just delegate this functionality to ASDF.
@node Using ASDF, Defining systems with defsystem, Configuring ASDF, Top
@node Using ASDF, Resetting the ASDF configuration, Configuring where ASDF stores object files, Loading ASDF
@comment node-name, next, previous, up
@comment node-name, next, previous, up
@node Resetting the ASDF configuration, , Configuring where ASDF stores object files, Loading ASDF
@section Resetting Configuration
@section Resetting the ASDF configuration
When you dump and restore an image, or when you tweak your configuration,
When you dump and restore an image, or when you tweak your configuration,
you may want to reset the ASDF configuration.
you may want to reset the ASDF configuration.
...
@@ -688,7 +727,7 @@ For compatibility with all Lisp implementations, however,
...
@@ -688,7 +727,7 @@ For compatibility with all Lisp implementations, however,
you might want instead your build script to explicitly call
you might want instead your build script to explicitly call
@code{(asdf:clear-configuration)} at an appropriate moment before dumping.
@code{(asdf:clear-configuration)} at an appropriate moment before dumping.
@node Using ASDF, Defining systems with defsystem, Loading ASDF, Top
@chapter Using ASDF
@chapter Using ASDF
@section Loading a system
@section Loading a system
...
@@ -1490,7 +1529,7 @@ and has many options that prove useful in this context,
...
@@ -1490,7 +1529,7 @@ and has many options that prove useful in this context,
such as @code{:use-reexport} and @code{:mix-reexport}
such as @code{:use-reexport} and @code{:mix-reexport}
that allow for ``inheritance'' of symbols being exported.
that allow for ``inheritance'' of symbols being exported.
@node The object model of ASDF, Operations, Defining systems with defsystem, Top
@node The object model of ASDF, Controlling where ASDF searches for systems, Defining systems with defsystem, Top
@comment node-name, next, previous, up
@comment node-name, next, previous, up
@chapter The object model of ASDF
@chapter The object model of ASDF
...
@@ -1582,7 +1621,7 @@ but instead do something global on the system.
...
@@ -1582,7 +1621,7 @@ but instead do something global on the system.
* Functions::
* Functions::
@end menu
@end menu
@node Operations, Predefined operations of ASDF, The object model of ASDF, The object model of ASDF
@node Operations, Components, The object model of ASDF, The object model of ASDF