Ignore:
Timestamp:
10/28/12 08:50:41 (8 years ago)
Author:
Mark Evenson
Message:

Updated FAQ.

Embiggened statement of conformance.

Now using two (!) CSS counters to mark sections.

Use a sans-serif font by default.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • public_html/faq.shtml

    r13759 r14219  
    2020<h1>Index</h1>
    2121<ol id="toc">
    22   <li><a href="#general">General</a>
     22  <li class="topic"><a href="#general">General Questions about ABCL</a>
     23    <ol>
     24      <li class="question"><a href="#what">What is ABCL?</a></li>
     25      <li class="question"><a href="#license">What license is used for ABCL?</a></li>
     26      <li class="question"><a href="#bug-reporting">How/Where should I report bugs?</a></li>
     27      <li class="question"><a href="#speed">Is ABCL faster or slower than implementation XYZ?</a></li>
     28      <li class="question"><a href="#qa">What is the quality of the implementation? How can you tell?</a></li>
     29      <li class="question"><a href="#repository">Where is ABCL's source code repository?</a></li>
     30      <li class="question"><a href="#documentation">Where is ABCL's documentation?</a></li>
     31    </ol>
     32  </li>
     33
     34  <li class="topic"><a href="#building">Questions about Building ABCL</a>
     35    <ol>
     36      <li class="question"><a href="#avoiding-recompilation">The Ant build process seems to recompile from scratch each time.  How do I avoid this?</a></li>
     37    </ol>
     38  </li>
     39
     40  <li class="topic"><a href="#running">Questions about Running ABCL</a>
    2341  <ol>
    24     <li><a href="#what">What is ABCL?</a></li>
    25     <li><a href="#license">What license is used for ABCL?</a></li>
    26     <li><a href="#bug-reporting">How/Where should I report bugs?</a></li>
    27     <li><a href="#speed">Is ABCL faster or slower than implementation XYZ?</a></li>
    28     <li><a href="#qa">What is the quality of the implementation? How can you tell?</a></li>
    29     <li><a href="#repository">Where is ABCL's source code repository?</a></li>
    30     <li><a href="#documentation">Where is ABCL's documentation?</a></li>
    31   </ol>
    32   </li> <!-- general -->
    33 
    34   <li><a href="#building">Building</a>
    35   <ol>
    36     <li><a href="#avoiding-recompilation">The Ant build process seems to recompile from scratch each time.  How do I avoid this?</a></li>
    37   </ol>
    38   </li>
    39 
    40   <li><a href="#running">Running</a>
    41   <ol>
    42     <li>
     42    <li class="question">
    4343      <a href="#maxpermgen-errors">Java is running out of memory
    4444      with an error reporting something about
     
    4646      do?</a>
    4747    </li>
    48     <li>
    49       <a href="#~/.abclrc">What's the name of the startup configuration file?</a>
     48    <li class="question">
     49      <a href="#dotabclrc">What's the name of the startup configuration file?</a>
    5050    </li>
    51 
    5251  </ol>
    5352  </li>
    5453</ol>
    5554
    56 
    5755<div class="h2" title="general" id="general">
    58 <h2>General</h2>
     56<h2 class="topic">General</h2>
    5957
    6058<div class="h3" title="what" id="what">
    61 <h3>What is ABCL?</h3>
    62 <p>ABCL is an implementation of the full Common Lisp specification, with
    63 the exception of the implementation of the long form of
    64 DEFINE-METHOD-COMBINATION.</p>
    65 
    66 <p>
    67 Unfortunately, the CLOS implementation is not fully completely through
    68 a MOP (MetaObject Protocol). Perhaps roughly a third of the
    69 functionality defined by <a
    70 href="http://www.lisp.org/mop/index.html">AMOP</a> is present.  Any
    71 contributions in this area would be greatly appreciated, of course.
     59<h3 class="question">What is ABCL?</h3>
     60<p>ABCL stands for Armed Bear Common Lisp.  ABCL is an implementation
     61of Common Lisp hosted on the <a href="http://en.wikipedia.org/wiki/Java_virtual_machine">Java Virtual Machine</a>.  With the release of <a
     62href="http://common-lisp.net/project/armedbear/#downloads">abcl-1.0</a>,
     63Armed Bear Common Lisp is a conforming implementation of the
     64<a href="ftp://ftp1.ansi.org/cust_serv/td_10-25-10/ANSI%2BINCITS%2B226-1994%2B(R2004).pdf">ANSI Common Lisp specification</a>.  The required statement of conformance
     65is included in the <a href="#user-manual">User Manual</a>.</p>
     66
     67<p>
     68With abcl-1.1.0-dev (aka "ABCL trunk"), now contains a complete
     69implementation of the <a
     70href="http://www.lisp.org/mop/index.html">AMOP</a>.
    7271</p>
    7372</div>
     
    7574
    7675<div class="h3" title="license" id="license">
    77 <h3>What license is used for ABCL?</h3>
    78 
    79 <p>ABCL is distributed under the <a href="http://www.gnu.org/copyleft/gpl.html"
    80 >GNU General Public License</a> with <a
     76<h3 class="question">What license is used for ABCL?</h3>
     77
     78<p>ABCL is distributed under the <a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a> with <a
    8179href="http://www.gnu.org/software/classpath/license.html">Classpath
    8280exception</a>. This is the same license as used for JAVA SE and GNU Classpath.</p>
     
    103101
    104102<div class="h3" title="bug-reporting" id="bug-reporting">
    105 <h3>How/Where should I report bugs?</h3>
     103<h3 class="question">How/Where should I report bugs?</h3>
    106104
    107105<p>
     
    131129
    132130<div class="h3" title="speed" id="speed">
    133 <h3>Is ABCL faster or slower than implementation XYZ?</h3>
     131<h3 class="question">Is ABCL faster or slower than implementation XYZ?</h3>
    134132
    135133<p>General comparisons are hard to make, the relative speeds depend
     
    156154
    157155<div class="h3" title="qa" id="qa">
    158 <h3>What is the quality of the implementation? How can you tell?</h3>
     156<h3 class="question">What is the quality of the implementation? How can you tell?</h3>
    159157
    160158<p>The project recognizes there are several dimensions to quality:</p>
     
    189187
    190188<div class="h3" title="repository" id="repository">
    191 <h3>Where is ABCL's source code repository?</h3>
    192 
    193 <p>If you want to build the latest (unstable) ABCL code,
    194 you can check out through
    195 svn://common-lisp.net/project/armedbear/svn/trunk/abcl.</p>
    196 
    197 <p>
    198 This repository is also exported read-only via HTTP at
     189<h3 class="question">Where is ABCL's source code repository?</h3>
     190
     191<p>The source code may be viewed with a web browser by visiting  <a
     192href="http://trac.common-lisp.net/armedbear/browser/trunk/abcl/">http://trac.common-lisp.net/armedbear/browser/trunk/abcl/</a>.
     193</p>
     194
     195<p>If you want to build the source, ABCL trunk,
     196can be checked out via <a
     197href="http://subversion.apache.org/">Subversion (aka "svn")</a> from
     198the URI
     199<a href="svn://common-lisp.net/project/armedbear/svn/trunk/abcl/">svn://common-lisp.net/project/armedbear/svn/trunk/abcl/</a>.</p>
     200
     201<p>
     202This ABCL source repository is also exported read-only via HTTP at
    199203<a href="http://svn.common-lisp.net/armedbear/trunk/abcl">http://svn.common-lisp.net/armedbear/trunk/abcl</a>
    200204</p>
     
    202206
    203207<div class="h3" title="documentation" id="documentation">
    204 <h3>Where is ABCL's documentation?</h3>
     208<h3 class="question">Where is ABCL's documentation?</h3>
    205209
    206210<p>Documentation on ABCL can be found in several places, depending on the
     
    208212
    209213<ol>
    210   <li>Users of the system are invited to start with the <a href="http://code.google.com/p/abcl-dynamic-install/downloads/detail?name=abcl-20120110a.pdf">Armed Bear Common Lisp User Manual</a></li>
     214  <li id="user-manual">Users of the system are invited to start with the <a href="http://code.google.com/p/abcl-dynamic-install/downloads/detail?name=abcl-20120110a.pdf">Armed Bear Common Lisp User Manual</a></li>
    211215  <li>Our <a href="http://trac.common-lisp.net/armedbear/wiki">wiki</a></li>
    212216  <li>The <a href="http://trac.common-lisp.net/armedbear/browser">source
     
    220224
    221225<div class="h2" title="Building" id="building">
    222 <h2>Building</h2>
     226<h2 class="topic">Building</h2>
    223227
    224228<div class="h3" title="Avoiding recompilation" id="avoiding-recompilation">
    225 <h3>The Ant build process seems to recompile from scratch each time.  How do I avoid this?</h3>
     229<h3 class="question">The Ant build process seems to recompile from scratch each time.  How do I avoid this?</h3>
    226230
    227231<p>
     
    238242
    239243<div class="h2" title="Running" id="running">
    240 <h2>Running</h2>
     244<h2 class="topic">Running</h2>
    241245
    242246<div class="h3" title="Out of Memory errors" id="maxpermgen-errors">
    243 <h3>Java is running out of memory with an error reporting something
     247<h3 class="question">Java is running out of memory with an error reporting something
    244248about "java.lang.OutOfMemoryError: PermGen space".  What can I
    245249do?</h3>
     
    274278</p>
    275279
    276 <div class="h3" title="What is the name of the startup run control script?" id="~/.abclrc">
    277 <h3>Is there a file that customizes the startup of the ABCL process?</h3>
     280<div class="h3" title="What is the name of the startup run control script?" id="dotabclrc">
     281<h3 class="question">Is there a file that customizes the startup of the ABCL process?</h3>
    278282
    279283<p>
Note: See TracChangeset for help on using the changeset viewer.