Skip to content
GitLab
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
asdf
asdf
Commits
317998be
Commit
317998be
authored
Oct 07, 2013
by
Francois-Rene Rideau
Browse files
More webpage editing.
parent
8be7c5ad
Changes
1
Hide whitespace changes
Inline
Side-by-side
doc/index.html
View file @
317998be
...
...
@@ -41,34 +41,58 @@
</p>
<a
id=
"what_it_is"
></a>
<h3>
What it is
</h3>
<p>
ASDF 3 contains two parts:
<tt>
asdf/defsystem
</tt>
and
<tt>
uiop
</tt>
.
</p>
<p><tt>
asdf/defsystem
</tt>
,
is a tool to describe how Lisp source code is organized in systems,
and how to build a system in term of actions that depend on previous actions.
</p>
<p>
It is roughly what Common Lisp hackers use to build software
where C hackers might use GNU
<tt>
Make
</tt>
.
</p>
<p>
ASDF stands for
<em>
A
</em>
nother
<em>
S
</em>
ystem
<em>
D
</em>
efinition
<em>
F
</em>
acility,
in the continuity of the Lisp
<tt>
DEFSYSTEM
</tt>
of yore.
</p>
<p><tt>
uiop
</tt>
,
also known as
<tt>
asdf/driver
</tt>
,
the Utilities for Implementation- and OS- Portability,
is a Common Lisp portability library and runtime support system
that helps you write Common Lisp software in a portable way.
</p>
<p>
In addition to many general-purpose Lisp utilities,
it notably provides portable abstractions to
gloss over implementation quirks, support hot-upgrade of code,
manipulate pathnames, create programs, use command-line arguments,
access the environment, use the filesystem,
call other programs and parse their output,
compile Lisp code, muffle conditions, or configure Lisp software.
See its
<a
href=
"http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=uiop/README;hb=HEAD;js=1"
>
README
</a>
.
<p>
ASDF 3 contains two parts:
<tt>
asdf/defsystem
</tt>
and
<tt>
uiop
</tt>
.
</p>
<dl>
<dt><tt>
asdf/defsystem
</tt></dt>
<dd>
<p>
is a tool to describe how Lisp source code is organized in systems,
and how to build a system in term of actions that depend on previous actions.
</p>
<p>
Typical actions consist in compiling a Lisp source file (if not up to date)
and loading the resulting compilation output (if not both loaded and up to date).
And you must typically compile and load files that define packages, macros, variables,
before you may compile and load other files that use them.
</p>
<p>
It is roughly what Common Lisp hackers use to build and load software
where C hackers might use GNU
<tt>
Make
</tt>
to build software and
<tt>
ld.so
</tt>
to load it.
</p>
<p><tt>
asdf/defsystem
</tt>
is the part that people usually refer to as
<tt>
ASDF
</tt>
,
with
<tt>
uiop
</tt>
being only a supporting library,
that happens to be distributed at the same time, by necessity.
</p>
</dd>
<dt><tt>
uiop
</tt></dt>
<dd>
<p>
also known as
<tt>
asdf/driver
</tt>
,
the Utilities for Implementation- and OS- Portability,
is a Common Lisp portability library and runtime support system
that helps you write Common Lisp software in a portable way.
</p>
<p>
In addition to many general-purpose Lisp utilities,
it notably provides portable abstractions to
gloss over implementation quirks, support hot-upgrade of code,
manipulate pathnames, create programs, use command-line arguments,
access the environment, use the filesystem,
call other programs and parse their output,
compile Lisp code, muffle conditions, or configure Lisp software.
See its
<a
href=
"http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=uiop/README;hb=HEAD;js=1"
>
README
</a>
.
</p>
<p><tt>
uiop
</tt>
is distributed as part of the
<tt>
ASDF
</tt>
,
its source code is transcluded in the single-file
<tt>
asdf.lisp
</tt>
being distributed
and the precompiled fasls provided by Lisp implementations.
<tt>
ASDF
</tt>
relies heavily on it for its portability layer and runtime support,
particularly so as to handle pathnames and filesystem access.
<tt>
uiop
</tt>
is useful on its own and can also be compiled and distributed separately.
</p>
</dd>
</dl>
<a
id=
"what_it_is_not"
></a>
<h3>
What it is not
</h3>
<p>
ASDF will
<em>
not
</em>
download missing software components for you.
...
...
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment