Changeset 9388


Ignore:
Timestamp:
May 7, 2008, 8:39:03 PM (11 years ago)
Author:
mikel
Message:

added a section on batching build-application from the command line

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/source/doc/src/ide.xml

    r9348 r9388  
    1313<chapter><title>The &CCL; IDE</title>
    1414 
     15  <!-- ================================================================ -->
    1516  <sect1><title>Introduction</title>
    1617   
     
    3233  </sect1>
    3334
     35  <!-- ================================================================ -->
    3436  <sect1><title>Building the IDE</title>
    3537   
     
    7779  </sect1>
    7880
     81  <!-- ================================================================ -->
    7982  <sect1><title>Running the IDE</title>
    8083   
     
    9295  </sect1>
    9396
     97  <!-- ================================================================ -->
    9498  <sect1>
    9599    <title>IDE Features</title>
     
    171175  </sect1>
    172176 
     177  <!-- ================================================================ -->
    173178  <sect1><title>IDE Sources</title>
    174179   
     
    193198  </sect1>
    194199
     200  <!-- ================================================================ -->
    195201  <sect1><title>The Application Builder</title>
    196202    <anchor id="application_builder"/>
     
    422428    use <code>BUILD-APPLICATION</code>, see the Currency Converter
    423429    example in "ccl/examples/cocoa/currency-converter/".</para>
     430
     431    <!-- ***************************************************** -->
     432    <sect2>
     433      <title>Running the Application Builder From the Command
     434      Line</title>
     435
     436      <para>It's possible to automate use of the application builder
     437        by running a call to <literal>CCL:BUILD-APPLICATION</literal>
     438        from the terminal command line. For example, the following
     439        command, entered at a shell prompt in Mac OS X's Terminal
     440        window, builds a working copy of the &CCL; environment called
     441        "Foo.app":</para>
     442
     443      <programlisting>
     444ccl -b -e "(require :cocoa)" -e "(require :build-application)" -e "(ccl::build-application :name \"Foo\")"
     445      </programlisting>
     446
     447      <para>You can use the same method to automate building your
     448      Lisp/Cocoa applications. &CCL; handles each Lisp expressions
     449      passed with a <literal>-e</literal> argument in order, so you
     450      can simply evaluate a sequence of Lisp expressions as in the
     451      above example to build your application, ending with a call
     452      to <literal>CCL:BUILD-APPLICATION</literal>. The call
     453      to <literal>CCL:BUILD-APPLICATION</literal> can process all the
     454      same arguments as if you evaluated it in a Listener window in
     455      the &CCL; IDE.</para>
     456
     457      <para>Building a substantial Cocoa application (rather than just
     458      reproducing the Lisp environment using defaults, as is done in
     459      the above example) is likely to involve a relatively complicated
     460      sequence of loading source files and perhaps evaluating Lisp
     461      forms. You might be best served to place your command line in a
     462      shell script that you can more easily edit and test.</para>
     463
     464      <para>One potentially complicated issue concerns loading all
     465        your Lisp source files in the right order. You might consider
     466        using ASDF to define and load a system that includes all the
     467        parts of your application before
     468        calling <literal>CCL:BUILD-APPLICATION</literal>. ASDF is a
     469        "another system-definition facility", a sort
     470        of <literal>make</literal> for Lisp, and is included in the
     471        &CCL; distribution. You can read more about ASDF at the ASDF
     472        <ulink url="http://constantly.at/lisp/asdf/">home
     473        page</ulink>.</para>
     474
     475      <para>Alternatively, you could use the standard features of
     476        Common Lisp to load your application's files in the proper
     477        order.</para>
     478    </sect2>
    424479  </sect1>
    425480
Note: See TracChangeset for help on using the changeset viewer.