Changeset 14219


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.

Location:
public_html
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • public_html/faq-style.css

    r13544 r14219  
     1body {
     2    font-family: sans-serif;
     3}
    14/* Use CSS2 to automatically number the FAQ questions and answer */
     5ol#toc, div#general {
     6    counter-reset: topic;
     7}
    28ol#toc {
     9    border-style: solid;
     10}
     11ol#toc li.topic, div#general h2.topic {
     12    list-style: none;
    313    counter-reset: question;
    414}
    5 ol#toc  li {
     15div#general h2.topic {
     16    margin-left: -4em;
     17}
     18ol#toc li.topic:before, div#general h2.topic:before {
     19    content: counter(topic) ".  ";
     20    counter-increment: topic;
     21}
     22ol#toc li.question {
    623    list-style: none;
    724}
    8 ol#toc > li  li:before {
    9     content: counter(question) ". ";
     25ol#toc li.question:before,  div#general h3.question:before {
     26    content: counter(topic) "." counter(question) ". ";
    1027    counter-increment: question;
    1128}
    12 
    13 div#general {
    14     counter-reset: answer;
    15 }
    16 div#general h3:before {
    17     content: counter(answer) ". ";
    18     counter-increment: answer
     29div#general h3.question {
     30    margin-left: -2em;
    1931}
    2032
    21 ol#toc li li {
    22     margin-left: 1em;
    23 }
     33
     34
     35
     36
     37
     38
     39
     40
     41
     42
     43
     44
     45
     46
     47
     48
     49
     50
     51
  • 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.