<html lang="en">
<head>
<title>Predefined operations of asdf - asdf Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="asdf Manual">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Operations.html#Operations" title="Operations">
<link rel="prev" href="Operations.html#Operations" title="Operations">
<link rel="next" href="Creating-new-operations.html#Creating-new-operations" title="Creating new operations">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual describes asdf, a system definition facility for Common
Lisp programs and libraries.
asdf Copyright (C) 2001-2004 Daniel Barlow and contributors
This manual Copyright (C) 2001-2004 Daniel Barlow and
contributors
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
``Software''), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED ``AS IS'', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Predefined-operations-of-asdf"></a>
<p>
Next: <a rel="next" accesskey="n" href="Creating-new-operations.html#Creating-new-operations">Creating new operations</a>,
Previous: <a rel="previous" accesskey="p" href="Operations.html#Operations">Operations</a>,
Up: <a rel="up" accesskey="u" href="Operations.html#Operations">Operations</a>
<hr>
</div>
<!-- node-name, next, previous, up -->
<h4 class="subsection">3.1.1 Predefined operations of asdf</h4>
<p>All the operations described in this section are in the <code>asdf</code>
package. They are invoked via the <code>operate</code> generic function.
<pre class="lisp"> (asdf:operate 'asdf:<var>operation-name</var> '<var>system-name</var> {<var>operation-options ...</var>})
</pre>
<div class="defun">
— Operation: <b>compile-op</b><var> &key proclamations<a name="index-compile_002dop-6"></a></var><br>
<blockquote>
<p>This operation compiles the specified component. If proclamations are
supplied, they will be proclaimed. This is a good place to specify
optimization settings.
<p>When creating a new component type, you should provide methods for
<code>compile-op</code>.
<p>When <code>compile-op</code> is invoked, component dependencies often cause
some parts of the system to be loaded as well as compiled. Invoking
<code>compile-op</code> does not necessarily load all the parts of the
system, though; use <code>load-op</code> to load a system.
</p></blockquote></div>
<div class="defun">
— Operation: <b>load-op</b><var> &key proclamations<a name="index-load_002dop-7"></a></var><br>
<blockquote>
<p>This operation loads a system.
<p>The default methods for <code>load-op</code> compile files before loading them.
For parity, your own methods on new component types should probably do
so too.
</p></blockquote></div>
<div class="defun">
— Operation: <b>load-source-op</b><var><a name="index-load_002dsource_002dop-8"></a></var><br>
<blockquote>
<p>This operation will load the source for the files in a module even if
the source files have been compiled. Systems sometimes have knotty
dependencies which require that sources are loaded before they can be
compiled. This is how you do that.
<p>If you are creating a component type, you need to implement this
operation - at least, where meaningful.
</p></blockquote></div>
<div class="defun">
— Operation: <b>test-system-version</b><var> &key minimum<a name="index-test_002dsystem_002dversion-9"></a></var><br>
<blockquote>
<p>Asks the system whether it satisfies a version requirement.
<p>The default method accepts a string, which is expected to contain of a
number of integers separated by #\. characters. The method is not
recursive. The component satisfies the version dependency if it has
the same major number as required and each of its sub-versions is
greater than or equal to the sub-version number required.
<pre class="lisp"> (defun version-satisfies (x y)
(labels ((bigger (x y)
(cond ((not y) t)
((not x) nil)
((> (car x) (car y)) t)
((= (car x) (car y))
(bigger (cdr x) (cdr y))))))
(and (= (car x) (car y))
(or (not (cdr y)) (bigger (cdr x) (cdr y))))))
</pre>
<p>If that doesn't work for your system, you can override it. I hope
you have as much fun writing the new method as <tt>#lisp</tt> did
reimplementing this one.
</p></blockquote></div>
<div class="defun">
— Operation: <b>feature-dependent-op</b><var><a name="index-feature_002ddependent_002dop-10"></a></var><br>
<blockquote>
<p>An instance of <code>feature-dependent-op</code> will ignore any components
which have a <code>features</code> attribute, unless the feature combination
it designates is satisfied by <code>*features*</code>. This operation is
not intended to be instantiated directly, but other operations may
inherit from it.
</blockquote></div>
</body></html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
723830890bac44da3d113209b14e090b
>
files
>
247
