index.html 9.08 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns='http://www.w3.org/1999/xhtml' xml:lang='en' lang='en'>
  <head>
    <title>ASDF - Another System Definition Facility</title>
    <link type='text/css' href='style.css' rel='stylesheet' />
    <meta name="author" content="the ASDF group"/>
  </head>
  <body>
    <div class="header">
      <span class="logo">
        <a href="http://common-lisp.net/project/asdf/" title="ASDF Homepage">
          <img src="lisp-logo120x80.png" title="ASDF homepage" width="100" alt="Lisp Lizzard" />
        </a>
      </span>
      <h2>ASDF</h2><h4>Another System Definition Facility</h4>
    </div>
17
18
19
20
21
22
    <div class="system-links">
      <ul>
        <li><a href="#what_it_is">What it is</a></li>
        <li><a href="#documentation">Documentation</a></li>
        <li><a href="#downloads">Getting it</a></li>
        <li><a href="#bugs">Reporting Bugs</a></li>
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
23
        <li><a href="#mailing-lists">Mailing Lists</a></li>
24
25
26
27
        <li><a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=log"
               >Changelog</a></li>
      </ul>
    </div>
28
    <div class="contents">
29
30
        <a id="ASDF 2"></a>
        <h3>ASDF 2</h3>
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
31
        <p>We released ASDF 2 on May 31st 2010.
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
32
33
34
35
36
37
38
39
40
41
42
          It has now been widely adopted by the CL community.
        </p><p>
          These implementations provide ASDF 2 in their latest release
          so you can just <tt>(require :asdf)</tt>:
          (free) abcl ccl clisp cmucl ecl sbcl xcl; (proprietary) allegro.
        </p><p>
          These implementations work with ASDF 2 but don't bundle ASDF 2 yet:
	  (proprietary) lispworks scl.
        </p><p>
          These implementations are obsolete, yet are somewhat supported by ASDF 2:
	  (free) gcl mcl; (proprietary) cormancl genera.
43
        </p>
44
45
46
47
48
        <a id="what_it_is"></a>
        <h3>What it is</h3>
        <p>ASDF is a tool for describing how source files are organized:
          what depends on which and when.
        </p>
49
        <p>It is roughly what Common Lisp hackers use to build software
50
51
52
53
54
          where C hackers would use say GNU Make.
        </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 DEFSYSTEM of yore.
        </p>
55
56
57
58
59
60
        <a id="what_it_is_not"></a>
        <h3>What it is not</h3>
        <p>ASDF will not download missing software components for you.
          For that, you want <a href="http://quicklisp.org/">quicklisp</a>.
          (quicklisp builds upon ASDF.)
        </p>
61
62
63
64
65
66
67
        <a id="documentation"></a>
        <h3>Documentation</h3>
        <p>You can read our manual:</p>
        <ul>
          <li><a href="asdf.html">as one HTML file</a></li>
          <li><a href="asdf/">split into one HTML file per section</a></li>
          <li><a href="asdf.pdf">as a PDF document</a></li>
68
          <li><a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=doc/asdf.texinfo">as texinfo source</a></li>
69
        </ul>
70
71
72
73
74
        <p>Regarding the internal design of ASDF and the work we did on ASDF 2,
          see the last draft version of our paper for
          <a href="http://www.international-lisp-conference.org/2010/index">ILC 2010</a>,
          <cite><a href="ilc2010draft.pdf"
                   >Evolving ASDF: More Cooperation, Less Coordination</a></cite></p>
75

76
        <a id="downloads"></a>
77
78
79
80
81
        <h3>Getting it</h3>
        <p>Though they may lag behind the version here, ASDF comes bundled with most Lisps.
          To get the greatest and latest, you can:
        </p>
        <ul>
82
          <li>download just the latest <em>release</em> source for
83
            <!--<a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob_plain;tag=RELEASE;f=asdf.lisp">asdf.lisp</a>,-->
84
            <a href="http://common-lisp.net/project/asdf/asdf.lisp">asdf.lisp</a>;
85
          </li>
86
          <li>download the latest <em>release</em>
87
88
            <!--<a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;tag=RELEASE;a=snapshot;sf=tgz">tarball</a>,-->
            <a href="http://common-lisp.net/project/asdf/asdf.tar.gz">tarball</a>
89
            to get all bells and whistles;
90
          </li>
91
92
93
94
          <li>download just the latest <em>development</em> source from our git repository:
            <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob_plain;f=asdf.lisp;hb=HEAD">asdf.lisp</a>
          </li>
          <li>pull the latest <em>development</em> tree from our git repository
95
            <pre>git clone git://common-lisp.net/projects/asdf/asdf.git</pre>
96
97
98
99
100
101
102
103
            (note that our "master" branch is for current development;
            get our "release" branch for the latest stable release.);
          </li>
          <li>browse the latest <em>development</em> tree from our git repository:
            <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git">gitweb</a>
          </li>
          <li>download the tarball of a past release:
            <a href="http://common-lisp.net/project/asdf/archives/">archives</a>
104
105
106
107
108
109
110
111
112
113
        </li></ul>

        <a id="bugs">
        <h3>Reporting Bugs</h3>
        <p>To report bugs, you can use our 
          <a href="https://launchpad.net/asdf/">launchpad project</a>.
          If you're unsure about the bug or want to discuss how to fix it,
          you can send email to the project mailing-list below.
        </p>

Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
114
115
        <a id="mailing-lists"></a>
        <h3>Mailing Lists</h3>
116
117
        <ul>
          <li><a href="http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel">asdf-devel</a>:
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
118
119
120
121
122
123
124
125
126
            A list for questions, suggestions, bug reports, patches, and so on.
	    It's for everyone and everything. Please join the conversation!
	  </li>
          <li><a href="http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-announce">asdf-announce</a>:
            A low-volume mailing-list for announcements only, mostly regarding new releases.
	    Posting is restricted to project administrators and to important notices.
	    Please subscribe to it if you're a Lisp implementation or distribution vendor,
	    who needs to know when to upgrade the ASDF you distribute,
	    but are otherwise not interested in day to day design and development.
127
128
129
130
131
132
133
134
135
136
        </li></ul>

        <h3>Contributing</h3>
        <p>Join our mailing list, check the code out from git,
          send questions, ideas and patches!
        </p>

        <a id="news"></a>
        <h3>What is happening</h3>
        <dl>
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
137
          <dt>Since December 2009</dt>
138
          <dd>Fran&ccedil;ois-Ren&eacute; Rideau is de facto maintainer,
139
140
            with notable contributions from Robert P. Goldman,
            Juanjo Garcia-Ripoll and James Anderson.
141
            ASDF 2 released
142
            with many clean-ups, better configurability
143
144
145
146
147
            and updated documentation.
          </dd>
          <dt>May 2006 to November 2009</dt>
          <dd>Gary King is de facto maintainer,
            with notable contributions from
148
            Robert P. Goldman, Nikodemus Siivola, Christophe Rhodes, Daniel Herring.
149
            Many small features and bug fixes,
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
150
            making the project more maintainable,
151
            moving to using git and common-lisp.net.
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
152
            Last version: 1.369.
153
154
155
156
157
          </dd>
          <dt>May 2004 to April 2006</dt>
          <dd>Christophe Rhodes is de facto maintainer,
            with notable contributions from
            Nikodemus Siivola, Peter Van Eynde, Edi Weitz, Kevin Rosenberg.
158
            The system made more robust, a few more features.
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
159
            Last version: 1.97.
160
          <dt>August 2001 to May 2004</dt>
161
          <dd>Developed by Daniel Barlow, with notable contributions from
162
            Christophe Rhodes, Kevin Rosenberg, Edi Weitz, Rahul Jain.
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
163
            Last version: 1.37.
164
165
          <dt>August 2001</dt>
          <dd>Created by Daniel Barlow</dd>
166
167
      </dl>
          </div>
168
169
170
171
172
173
174
      <div id="footer">
        <a class="nav" href="http://validator.w3.org/check/referer" title="xhtml1.1"><img src="http://common-lisp.net/project/cl-containers/shared/buttons/xhtml.gif" width="80" height="15" title="valid xhtml button" alt="valid xhtml" /></a>
        <a class="nav" href="http://www.catb.org/hacker-emblem/" title="hacker"> <img src="http://common-lisp.net/project/cl-containers/shared/buttons/hacker.png" width="80" height="15" title="hacker emblem" alt="hacker button" /></a>
        <a class="nav" href="http://www.lisp.org/" title="Association of Lisp Users"> <img src="http://common-lisp.net/project/cl-containers/shared/buttons/lambda-lisp.png" width="80" height="15" title="ALU emblem" alt="ALU button" /></a>
        <a class="nav" href="http://common-lisp.net/" title="Common-Lisp.net"> <img src="http://common-lisp.net/project/cl-containers/shared/buttons/lisp-lizard.png" width="80" height="15" title="Common-Lisp.net" alt="Common-Lisp.net button" /></a>
        <p><span class="copyright"Copyright &copy; 2001-2010 Daniel Barlow and contributors</span></p>
        <p>ASDF has an <a href="http://www.opensource.org/licenses/mit-license.php">MIT style</a> license</p>
Francois-Rene Rideau's avatar
Francois-Rene Rideau committed
175
        <div id="timestamp">Last updated 2011-04-06</div>
176
    </div>
177
178
  </body>
</html>