Skip to content
Snippets Groups Projects
Commit dc78314a authored by Robert P. Goldman's avatar Robert P. Goldman Committed by Gary King
Browse files

Fixed VCS info; replaced variables done by hand with @defvar env.

Replaced CVS info with git info.

In the asdf-binary-locations section, where I had originally had an
itemization with @code for the variables (and hand-managed the variable
index), I used @defvar environment, which manages a lot of this properly
for me.
parent 8ac1f255
No related branches found
No related tags found
No related merge requests found
...@@ -174,6 +174,9 @@ Note to SBCL users: you are cautioned that installing ASDF yourself may ...@@ -174,6 +174,9 @@ Note to SBCL users: you are cautioned that installing ASDF yourself may
break some SBCL contribs. We are working to provide instructions for break some SBCL contribs. We are working to provide instructions for
doing this safely. doing this safely.
If you want to get the latest and greatest version of ASDF from its VCS
repository, @xref{Getting the latest version}.
@section Loading ASDF @section Loading ASDF
If your CL implementation does @emph{not} provide ASDF through the If your CL implementation does @emph{not} provide ASDF through the
...@@ -1110,12 +1113,6 @@ As of version 1.365, ASDF includes @emph{ASDF-binary-locations} to ...@@ -1110,12 +1113,6 @@ As of version 1.365, ASDF includes @emph{ASDF-binary-locations} to
mitigate the problem. mitigate the problem.
@section Default locations @section Default locations
@vindex *enable-asdf-binary-locations*
@vindex *centralize-lisp-binaries*
@vindex *default-toplevel-directory*
@vindex *include-per-user-information*
@vindex *map-all-source-files*
@vindex *source-to-target-mappings*
@findex output-files-for-system-and-operation @findex output-files-for-system-and-operation
The default binary location for each Lisp implementation is a The default binary location for each Lisp implementation is a
...@@ -1140,44 +1137,51 @@ Here is a summary of the variables that control ASDF's source-to-binary ...@@ -1140,44 +1137,51 @@ Here is a summary of the variables that control ASDF's source-to-binary
mappings. All of them are in the ASDF package, so must be set mappings. All of them are in the ASDF package, so must be set
@emph{after} loading ASDF. @emph{after} loading ASDF.
@itemize @defvar *enable-asdf-binary-locations*
If false, then ASDF will place binaries in the same directory as the
@item @code{*enable-asdf-binary-locations*}:
If false, then ASDF will place binaries in the same directory as the
source. If true, then ASDF will move the binaries using the rest of source. If true, then ASDF will move the binaries using the rest of
the configuration. Defaults to @code{nil}. the configuration. Defaults to @code{nil}.
@end defvar
@defvar *centralize-lisp-binaries*
@item @code{*centralize-lisp-binaries*}: If true, compiled lisp files If true, compiled lisp files
without an explicit mapping (see @code{*source-to-target-mappings*}) without an explicit mapping (see @code{*source-to-target-mappings*})
will be placed in subdirectories of will be placed in subdirectories of
@code{*default-toplevel-directory*}. If false, then compiled lisp @code{*default-toplevel-directory*}. If false, then compiled lisp
files without an explicit mapping will be placed in subdirectories files without an explicit mapping will be placed in subdirectories
of their sources. Defaults to @code{nil}. of their sources. Defaults to @code{nil}.
@end defvar
@item @code{*default-toplevel-directory*}. If @defvar *default-toplevel-directory*
If
@code{*centralize-lisp-binaries*} is true, then compiled lisp files @code{*centralize-lisp-binaries*} is true, then compiled lisp files
without an explicit mapping (see @code{*source-to-target-mappings*}) without an explicit mapping (see @code{*source-to-target-mappings*})
will be placed in subdirectories of will be placed in subdirectories of
@code{*default-toplevel-directory*}. Defaults to a sub-directory @code{*default-toplevel-directory*}. Defaults to a sub-directory
named `.fasls` in the current user's home directory. named `.fasls` in the current user's home directory.
@end defvar
@item @code{*include-per-user-information*}. specifies whether or not @defvar *include-per-user-information*
specifies whether or not
to include user information in the directory. Only used when to include user information in the directory. Only used when
@code{*centralize-lisp-binaries*} is true. Defaults to @code{nil}. @code{*centralize-lisp-binaries*} is true. Defaults to @code{nil}.
@end defvar
@item @code{*map-all-source-files*}. If true, then all source files @defvar *map-all-source-files*
If true, then all source files
will be mapped by ASDF. If @code{nil}, then only Common Lisp Source will be mapped by ASDF. If @code{nil}, then only Common Lisp Source
Files (i.e., instances of cl-source-file or its subclasses) will Files (i.e., instances of cl-source-file or its subclasses) will
be. Defaults to @code{nil}. be. Defaults to @code{nil}.
@end defvar
@item @code{*source-to-target-mappings*}. This specifies mappings @defvar *source-to-target-mappings*
This specifies mappings
from source to target. If the target is nil, then it from source to target. If the target is nil, then it
means to *not* map the source to anything. I.e., to leave means to *not* map the source to anything. I.e., to leave
it as is. This has the effect of turning off it as is. This has the effect of turning off
ASDF-Binary-Locations for the given source directory. The ASDF-Binary-Locations for the given source directory. The
default depends on the Lisp implementation. default depends on the Lisp implementation.
@end itemize @end defvar
These variables are used by These variables are used by
@code{output-files-for-system-and-operation} to determine where to @code{output-files-for-system-and-operation} to determine where to
...@@ -1257,38 +1261,19 @@ location of the system's source file and the relative pathname. For example ...@@ -1257,38 +1261,19 @@ location of the system's source file and the relative pathname. For example
@emph{FIXME: Need to revise this to give information about the git repository.} @emph{FIXME: Need to revise this to give information about the git repository.}
@enumerate
@item
Decide which version you want. HEAD is the newest version and Decide which version you want. HEAD is the newest version and
usually OK, whereas RELEASE is for cautious people (e.g. who already usually OK, whereas RELEASE is for cautious people (e.g. who already
have systems using asdf that they don't want broken), a slightly older have systems using asdf that they don't want broken), a slightly older
version about which none of the HEAD users have complained. version about which none of the HEAD users have complained.
There is also a STABLE version, which is earlier than release.
@item You may get the ASDF source repository using git:
Check it out from sourceforge cCLan CVS: @kbd{git clone http://common-lisp.net/project/asdf/asdf.git}
@kbd{cvs -d:pserver:anonymous@@cvs.cclan.sourceforge.net:/cvsroot/cclan login}
(no password: just press @key{Enter})
@kbd{cvs -z3 -d:pserver:anonymous@@cvs.cclan.sourceforge.net:/cvsroot/cclan co -r RELEASE asdf}
or for the bleeding edge, instead
@kbd{cvs -z3 -d:pserver:anonymous@@cvs.cclan.sourceforge.net:/cvsroot/cclan co -A asdf}
@end enumerate
If you are tracking the bleeding edge, you may want to subscribe to
the cclan-commits mailing list (see
@url{http://sourceforge.net/mail/?group_id=28536}) to receive commit
messages and diffs whenever changes are made.
For more CVS information, look at
@url{http://sourceforge.net/cvs/?group_id=28536}.
You will find the above referenced tags in this repository.
Discussion of ASDF development is conducted on the mailing list
@kbd{asdf-devel@@common-lisp.net}.
@node TODO list, missing bits in implementation, Getting the latest version, Top @node TODO list, missing bits in implementation, Getting the latest version, Top
@comment node-name, next, previous, up @comment node-name, next, previous, up
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment