index.html 7.46 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 23 24 25 26 27
    <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>
        <li><a href="#mailing-list">Mailing List</a></li>
        <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.
32 33 34
          It will hopefully be bundled will all official releases
          of Common Lisp implementations made after that date.
        </p>
35 36 37 38 39
        <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>
40
        <p>It is roughly what Common Lisp hackers use to build software
41 42 43 44 45
          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>
46 47 48 49 50 51
        <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>
52 53 54 55 56 57 58
        <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>
59
          <li><a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=doc/asdf.texinfo">as texinfo source</a></li>
60
        </ul>
61 62 63 64 65
        <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>
66

67
        <a id="downloads"></a>
68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
        <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>
          <li>download just the source for
            <!--<a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob_plain;tag=RELEASE;f=asdf.lisp">asdf.lisp</a>,-->
            <a href="http://common-lisp.net/project/asdf/asdf.lisp">asdf.lisp</a>,
          </li>
          <li>download the
            <!--<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>
            to get all bells and whistles,
          </li>
          <li>pull the latest from our git repository
            (<a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git">browse</a>)
84
            <pre>git clone git://common-lisp.net/projects/asdf/asdf.git</pre>
85 86
            (Note that our "master" branch is for current development;
            get our "release" branch for the latest stable release.)
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
        </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>

        <a id="mailing-list"></a>
        <h3>Mailing List</h3>
        <ul>
          <li><a href="http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel">asdf-devel</a>:
            A list for questions, patches, bug reports, and so on; It's for everything.
        </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
112
          <dt>Since December 2009</dt>
113
          <dd>Fran&ccedil;ois-Ren&eacute; Rideau is de facto maintainer,
114 115
            with notable contributions from Robert P. Goldman,
            Juanjo Garcia-Ripoll and James Anderson.
116
            ASDF 2 released
117
            with many clean-ups, better configurability
118 119 120 121 122
            and updated documentation.
          </dd>
          <dt>May 2006 to November 2009</dt>
          <dd>Gary King is de facto maintainer,
            with notable contributions from
123
            Robert P. Goldman, Nikodemus Siivola, Christophe Rhodes, Daniel Herring.
124
            Many small features and bug fixes,
125
            making the project more maintanable,
126 127 128 129 130 131
            moving to using git and common-lisp.net.
          </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.
132
            The system made more robust, a few more features.
133
          <dt>August 2001 to May 2004</dt>
134
          <dd>Developed by Daniel Barlow, with notable contributions from
135 136 137
            Christophe Rhodes, Kevin Rosenberg, Edi Weitz, Rahul Jain.
          <dt>August 2001</dt>
          <dd>Created by Daniel Barlow</dd>
138 139
      </dl>
          </div>
140 141 142 143 144 145 146
      <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
147
        <div id="timestamp">Last updated 2010-10-06</div>
148
    </div>
149 150
  </body>
</html>