Merge branch 'master' of common-lisp.net:asdf/asdf

  <body>

    <div class="header">

      <span class="logo">

        <a href="http://common-lisp.net/project/asdf/" title="ASDF Homepage">

        <a href="https://common-lisp.net/project/asdf/" title="ASDF Homepage">

          <img src="lisp-logo120x80.png" title="ASDF homepage" width="100" alt="Lisp Lizzard" />

        </a>

      </span>

              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>.

              <a href="https://gitlab.common-lisp.net/asdf/asdf/tree/master/uiop/README.md">README.md</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

          For that, you want <a href="http://quicklisp.org/"><tt>Quicklisp</tt></a>,

          that builds upon ASDF, and is great for pulling and installing

          tarballs of packages you may depend upon;

          we also recommend <a href="http://common-lisp.net/project/clbuild/"><tt>clbuild</tt></a>,

          we also recommend <a href="https://common-lisp.net/project/clbuild/"><tt>clbuild</tt></a>,

          that now builds upon Quicklisp, as a great tool for pulling from version control

          packages you need to modify or want to contribute to.

          We recommend you should <em>not</em> use <tt>asdf-install</tt> anymore,

        </p><p>

          If you're unsatisfied with ASDF,

          beside helping with our

          <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=TODO">TODO list</a>,

          <a href="https://gitlab.common-lisp.net/asdf/asdf/tree/master/TODO">TODO list</a>,

          you might be interested in other build systems for Common-Lisp:

          <ul>

            <li>Alastair Bridgewater's small and simple one-package-per-file

              <a href="https://bugs.launchpad.net/asdf/+bug/1230368"><tt>quick-build</tt></a>

              (also reimplemented as the ASDF extension

              <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf-package-system.git"

              <a href="https://gitlab.common-lisp.net/asdf/asdf-package-system"

                 ><tt>asdf-package-system</tt></a>; similar to <tt>faslpath</tt> below).

            </li>

            <li>Fran&ccedil;ois-Ren&eacute; Rideau's

              <a href="http://common-lisp.net/project/xcvb/"><tt>XCVB</tt></a>

              <a href="https://common-lisp.net/project/xcvb/"><tt>XCVB</tt></a>

              (building object and image files deterministically and in parallel,

              but not actively maintained since 2012;

              thanks to its new build model, ASDF 3 could conceivably be modified

            <th align="left">Will provide ASDF 3</th>

            <th align="left">Unmaintained</th></tr>

          <tr><th align="left">Free</th>

            <td align="left"><tt>abcl ccl clisp cmucl ecl mkcl sbcl</tt></td>

            <td align="left"><tt>clasp gcl</tt></td>

            <td align="left"><tt>abcl ccl clasp clisp cmucl ecl mkcl sbcl</tt></td>

            <td align="left"><tt>gcl</tt></td>

            <td align="left"><tt>mcl xcl</tt></td></tr>

          <tr><th align="left">Proprietary</th>

            <td align="left"><tt>allegro</tt></td>

        </table>

        <p>

          To deal with an implementation that doesn't yet provide ASDF 3,

          we provide <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=tools/install-asdf.lisp">a script</a> that can install ASDF 3

          we provide <a href="https://common-lisp.net/asdf/asdf/tree/master/tools/install-asdf.lisp">a script</a> that can install ASDF 3

          where your implementation goes looking for it

          when you <tt>(require "asdf")</tt> .

        </p><p>

          <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>

          <li><a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=doc/asdf.texinfo">as texinfo source</a></li>

          <li><a href="https://gitlab.common-lisp.net/asdf/asdf/tree/master/doc/asdf.texinfo">as texinfo source</a></li>

        </ul>

        <p>Regarding the internal design of ASDF in general,

          and the work we did on ASDF 3,

          <cite><a href="http://fare.tunes.org/files/asdf3/asdf3-2014.html"

                   >ASDF 3, or Why Lisp is Now an Acceptable Scripting Language</a></cite>

          (<a href="http://fare.tunes.org/files/asdf3/asdf3-2014.pdf">PDF</a>,

          <a href="http://github.com/fare/asdf3-2013">git</a>).

          <a href="https://github.com/fare/asdf3-2013">git</a>).

          The shorter version (8 pages), submitted to

          <a href="http://www.european-lisp-symposium.org/">ELS 2014</a>,

          focuses on ASDF 3 and misses historical and technical information

          <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>

          (<a href="http://common-lisp.net/gitweb?p=projects/asdf/ilc2010.git">git</a>).

          (<a href="https://gitlab.common-lisp.net/asdf/ilc2010">git</a>).

        </p>

        <p>Finally, while the manual covers all the basics,

          some advanced or new features remain underdocumented.

        </p>

        <ul>

          <li>download just the latest <em>release</em> 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>;

            <a href="https://common-lisp.net/project/asdf/asdf.lisp">asdf.lisp</a>;

          </li>

          <li>download the latest <em>release</em>

            <!--<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>

            <a href="https://common-lisp.net/project/asdf/asdf.tar.gz">tarball</a>

            to get all bells and whistles;

          </li>

          <li>pull the latest <em>development</em> tree from our git repository

            <pre>git clone git://common-lisp.net/projects/asdf/asdf.git</pre>

            <pre>git clone https://gitlab.common-lisp.net/asdf/asdf.git</pre>

            (note that our "master" branch is for current development;

            get our "release" branch for the latest stable release.

            Run <tt>make</tt> to create <tt>build/asdf.lisp</tt>);

          </li>

          <li>browse the latest <em>development</em> tree from our git

        repository:

          <a href="http://common-lisp.net/gitweb/?p=asdf/asdf.git;a=summary;js=1">gitweb</a>

            <!-- <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git">gitweb</a> -->

          <a href="https://gitlab.common-lisp.net/asdf/asdf">gitlab</a>

          </li>

          <li>download the tarball of a past release:

            <a href="http://common-lisp.net/project/asdf/archives/">archives</a>

            <a href="https://common-lisp.net/project/asdf/archives/">archives</a>

        </li></ul>

        <a id="extensions"></a>

        <h3>Extensions</h3>

        <p>Known extensions to ASDF include:</p>

        <ul>

          <li><a href="http://common-lisp.net/gitweb/?p=asdf/asdf-contrib.git"

          <li><a href="https://gitlab.common-lisp.net/asdf/asdf-contrib"

                 ><tt>asdf-contrib</tt></a>,

            a collection of most of the below.</li>

          <li><a href="http://common-lisp.net/gitweb/?p=asdf/asdf-encodings.git"

          <li><a href="https://gitlab.common-lisp.net/asdf/asdf-encodings"

                 ><tt>asdf-encodings</tt></a>,

            to compile Lisp source files with character encodings other than UTF-8.</li>

          <li><a href="http://common-lisp.net/gitweb/?p=asdf/asdf-finalizers.git"

          <li><a href="https://gitlab.common-lisp.net/asdf/asdf-finalizers"

                 ><tt>asdf-finalizers</tt></a>,

            to allow macros to include code to be evaluated

            at the end of a file being compiled.</li>

          <li>

            <!-- <a href="http://common-lisp.net/gitweb?p=projects/xcvb/asdf-dependency-grovel.git"> -->

            <a href="http://common-lisp.net/gitweb/?p=xcvb/asdf-dependency-grovel.git;a=summary;js=1">

            <a href="https://gitlab.common-lisp.net/xcvb/asdf-dependency-grovel">

            <tt>asdf-dependency-grovel</tt></a>,

            to compute the actual dependencies in a big ASDF system.</li>

          <li><a href="http://common-lisp.net/project/qitab/"

          <li><a href="https://common-lisp.net/project/qitab/"

                 ><tt>poiu</tt></a>,

            to compile a system in parallel.</li>

          <li><a href="http://common-lisp.net/project/asdf-system-connections/"

          <li><a href="https://common-lisp.net/project/asdf-system-connections/"

                 ><tt>asdf-system-connections</tt></a>,

            lets you specify systems that are automatically loaded when

            two other systems are loaded, to connect them.</li>

          <li><a href="http://www.lrde.epita.fr/~didier/software/lisp/misc.php#asdf-flv"

                 ><tt>asdf-flv</tt></a>,

            to bind file-local variables around the compilation of some files.</li>

          <li><a href="http://common-lisp.net/gitweb/?p=asdf/asdf-package-system.git"

          <li><a href="http://gitlab.common-lisp.net/asdf/asdf-package-system"

                 ><tt>asdf-package-system</tt></a>,

            to compile Lisp source files with one package per file

            that also determines dependencies, in the style of

        <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-2014 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>

        <div id="timestamp">Last updated 2014-10-10</div>

        <div id="timestamp">Last updated 2015-03-28</div>

    </div>

  </body>

</html>