Changeset 11950


Ignore:
Timestamp:
Apr 14, 2009, 12:28:51 AM (11 years ago)
Author:
rme
Message:

Updates for 1.3.

File:
1 edited

Legend:

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

    r11567 r11950  
    1616  <sect1><title>Releases and System Requirements</title>
    1717   
    18     <para>Version 1.2 is the latest release of &CCL; as of April
    19     2008. It is intended to be a more stable release and follow a more
    20     regular release schedule than previous versions.  It is easier for
    21     users who wish to track the "bleeding edge" of development to do
    22     so.</para>
    23 
    24    <para>Versions 1.2 is available for five platform
    25    configurations:</para>
     18    <para>Version 1.3 is the latest stable release of &CCL; as of April
     19    2009.</para>
     20
     21   <para>Version 1.3 is available for seven platform configurations:</para>
    2622    <itemizedlist>
    2723      <listitem>
     
    3228      </listitem>
    3329      <listitem>
    34         <para>Linux on X86-64 (64-bit implementation)</para>
     30        <para>Linux on x86 (32-bit and 64-bit implementations)</para>
    3531      </listitem>
    3632      <listitem>
    37         <para>Mac OS X on X86-64 (64-bit implementation)</para>
     33        <para>Mac OS X on x86 (32-bit and 64-bit implementations)</para>
    3834      </listitem>
    39       <listitem><para>FreeBSD on X86-64 (64-bit implementation)</para></listitem>
     35      <listitem>
     36        <para>FreeBSD on x86 (32-bit and 64-bit implementations)</para>
     37      </listitem>
     38      <listitem>
     39        <para>Solaris on x86 (32-bit and 64-bit implementations)</para>
     40      </listitem>
     41      <listitem>
     42        <para>MS Windows on x86 (32-bit and 64-bit implementations)</para>
     43      </listitem>
    4044    </itemizedlist>
    4145
    4246    <para>A 64-bit version of &CCL; requires a 64-bit processor
    4347      running a 64-bit OS variant.</para>
    44      
    45     <para>There are ongoing efforts to port &CCL; to the Windows
    46       operating system and to 32-bit x86 processors.</para>
    4748   
    4849    <para>Additional platform-specific information is given in the
     
    5556    development "snapshots" and CVS updates.  1.1 snapshots introduced
    5657    support for x86-64 platforms, internal use of Unicode, and many
    57     other features, but were moving targets. </para>
     58    other features, but were moving targets.  Version 1.2 was a stable
     59    version released in April 2008.</para>
    5860
    5961    <!-- ***************************************************** -->
     
    6668
    6769    <!-- ***************************************************** -->
    68     <sect2><title>Linux X8664</title>
    69 
    70       <para>&CCL; runs on relatively recent Linux distributions for
    71       the x86-64 architecture.  It requires a Linux with Thread Local
    72       Storage support in the toolchain and standard libraries, and the
    73       New Posix Thread Library (NPTL).  Fortunately, these features
    74       seem to be present in all current Linux distributions for
    75       x86-64, though there may be some problems with early Linux
    76       distributions for x86-64. Some GCC versions older than 4.0 on
    77       Linux have been known to have problems compiling some of the C
    78       code in the kernel; some very old Linux distributions don't
    79       follow the current ABI standards with regard to segment register
    80       usage; some early Linux kernels for x86-64 had problems mapping
    81       large regions of the address space; and so on. It's difficult to
    82       enumerate exactly what versions of which Linux distributions have
    83       what problems.  A rule of thumb is that&mdash;because much of
    84       the development of &CCL; for x86-64 took place in that time
    85       frame&mdash;Linux distributions released earlier than early 2006
    86       may have problems running &CCL;. </para>
    87     </sect2>
    88 
    89     <!-- ***************************************************** -->
    90     <sect2><title>FreeBSD-amd64</title> <para>&CCL; runs on FreeBSD on
    91     x86-64 (FreeBSD releases generally call the platform "amd64").
    92     &CCL; should run under FreeBSD 6.0 or later; as of this writing,
    93     FreeBSD 7.0 is about to be released and it may be necessary for
    94     FreeBSD 7 users to install the "compat6x" package in order to use
    95     a version of &CCL; built on FreeBSD 6.x.</para>
    96     </sect2>
    97 
    98     <!-- ***************************************************** -->
    99     <sect2><title>DarwinPPC-MacOS-X</title>
    100 
    101       <para> &CCL; runs under OS X versions 10.4 and 10.5 and requires
    102       at least version 10.3.9</para>
    103 
    104       <para>The 64-bit DarwinPPC version of &CCL; requires
    105         functionality introduced in OSX 10.4 (namely, the ability to
    106         run 64-bit binaries). The 64-bit DarwinPPC version also,
    107         obviously, requires a G5 processor.</para>
     70    <sect2><title>Linux x86</title>
     71   
     72      <para>
     73        Because of the nature of Linux distributions, it's difficult
     74        to give precise version number requirements.  In general, a
     75        "fairly modern" (no more than 2 or three years old) kernel and
     76        C library are more likely to work well than older
     77        versions.</para>
     78    </sect2>
     79
     80    <!-- ***************************************************** -->
     81    <sect2><title>FreeBSD x86</title>
     82    <para>&CCL; should run on
     83    FreeBSD 6.x and 7.x.
     84    FreeBSD 7 users will need to install the "compat6x" package in order to use
     85    the distributed &CCL; kernel, which is built on a FreeBSD 6.x system.</para>
     86    </sect2>
     87
     88    <!-- ***************************************************** -->
     89    <sect2><title>Mac OS X (ppc and x86)</title>
     90
     91      <para> &CCL; runs under Mac OS X versions 10.4 and 10.5.
     92      </para>
     93
     94      <para>64-bit versions of &CCL; require 64-bit processors
     95      (e.g., a G5 or Core 2 processor).  Some early Intel-based Macintoshes
     96      used processors that don't support
     97      64-bit operation, so the 64-bit &CCL; will not run on them, although
     98      the 32-bit &CCL; will.
     99      </para>
    108100
    109101      <para>&CCL; hasn't been tested under Darwin proper, but
    110102        &CCL; doesn't intentionally use any Mac OS X features beyond
    111103        the Darwin subset and therefore it seems likely that &CCL;
    112         would run on PPC Darwin versions that correspond to recent OSX
     104        would run on Darwin versions that correspond to recent Mac OS X
    113105        versions.</para>
    114106    </sect2>
    115107
    116     <!-- ***************************************************** -->
    117     <sect2><title>Darwinx8664-MacOS-X</title> <para>&CCL; runs on
    118     64-bit DarwinX86 (Mac OS X on Intel).</para>
    119 
    120       <para>&CCL; Darwinx8664/MacOS X requires a 64-bit processor.
    121         All Macintoshes currently sold by Apple (as of early 2008) and
    122         all Macintoshes introduced by Apple since August 2006 have
    123         such processors.  However, the original MacBooks, MacBook Pros
    124         and Intel iMacs (models introduced in early 2006) used 32-bit
    125         Core Duo processors, and so &CCL; will not (yet) run on
    126         them.</para>
    127 
    128     </sect2>
    129108  </sect1>
    130109
     
    138117    if they prefer. Tarballs are available for those who prefer them,
    139118    but if you have Subversion installed, it is simpler and more
    140     flexible to use Subversion than tarballs.  It is easier to keep up
    141     with the bleeding edge if you are using Subversion, since disk
    142     images and tarballs are generated much less frequently than
    143     changes to Subversion.
     119    flexible to use Subversion than tarballs.
    144120    </para>
    145121
     
    153129      <para>If you are using Mac OS X then you can install and use
    154130         &CCL; in the usual Macintosh way.  Download and mount a
    155          disk image, then drag Clozure CL to the Applications folder.
    156          After that you can double-click the Clozure CL application to
    157          run it.  The disk images are available at
    158          <ulink url="ftp://clozure.com/pub/release/1.2/"/> </para>
     131         disk image, then drag the ccl folder to the Applications folder
     132         or wherever you wish.
     133         After that you can double-click the Clozure CL application found
     134         inside the ccl directory.  The disk images are available at
     135         <ulink url="ftp://clozure.com/pub/release/1.3/"/> </para>
    159136
    160137      <para>So that &CCL; can locate its source code, and for other
    161138        reasons explained in
    162         <xref linkend="Predefined-Logical-Hosts"/>, you should either put the
    163         <literal>ccl</literal> directory in the same directory as the
    164         Clozure CL application, or else put the Clozure CL application
     139        <xref linkend="Predefined-Logical-Hosts"/>, you keep the
     140        Clozure CL application
    165141        in the <literal>ccl</literal> directory.  If you use a shell,
    166142        you can set the value of the
     
    168144        to explicitly indicate the location of
    169145        the <literal>ccl</literal> directory. If you choose to do
    170         that, then the <literal>ccl</literal> and the Clozure CL
     146        that, then the <literal>ccl</literal> directory and the Clozure CL
    171147        application can each be in any location you find
    172148        convenient.</para>
     
    180156      latest, or a specific version of &CCL;, unless you prefer
    181157      the Mac Way.  Subversion is a source code control system that is
    182       in wide usage.  Most modern OSes come with subversion
     158      in wide usage.  Most modern OSes come with Subversion
    183159      pre-installed. A complete, buildable and runnable set of &CCL;
    184       sources and binaries can be retrieved by doing one subversion
    185       checkout.</para>
    186 
    187 
    188       <para>One subversion command creates a
    189       <literal>ccl</literal> directory with runnable binaries, and a
    190       complete set of buildable sources.  To get the bleeding edge
    191       &CCL; for Darwin x86 (both 32- and 64-bit versions),
    192       at the command line type:</para>
     160      sources and binaries can be retrieved with a single Subversion command.
     161      </para>
     162
     163      <para>Day-to-day development of &CCL; takes place in an area
     164      of the Subversion repository known as the trunk.  At most times,
     165      the trunk is perfectly usable, but occasionally it can be unstable
     166      or totally broken.  If you wish to live on the
     167      bleeding edge, the following command will fetch a copy of the trunk
     168      for Darwin x86 (both 32- and 64-bit versions):
     169      </para>
    193170
    194171        <programlisting>
     
    198175
    199176        <para>
    200           To get a bleeding-edge &CCL; for a different operating
    201           system, replace "darwinx86" with one of the following names
    202           (all versions include both 32- and 64-bit binaries):
     177          To get a trunk &CCL; for another platform, replace
     178          "darwinx86" with one of the following names (all versions
     179          include both 32- and 64-bit binaries):
    203180        </para>
    204181        <itemizedlist>
     182          <listitem><para>darwinx86</para></listitem>
    205183          <listitem><para>linunxx86</para></listitem>
    206184          <listitem><para>freebsdx86</para></listitem>
     
    211189        </itemizedlist>
    212190
    213         <para>To get the 1.2 version of &CCL; type:</para>
     191        <para>Release versions of &CCL; are intended to be stable.  While
     192        bugs will be fixed in the release branches, enhancements
     193        and new features will go into the trunk.  To get the 1.3 release
     194        of &CCL; type:</para>
    214195        <programlisting>
    215196          <![CDATA[
    216 svn co http://svn.clozure.com/publicsvn/openmcl/release/1.2/darwinx8664/ccl]]>
     197svn co http://svn.clozure.com/publicsvn/openmcl/release/1.3/darwinx86/ccl]]>
    217198        </programlisting>
    218199
    219200       
    220         <para>These examples fetch the complete sources and binaries
    221         for the Darwin X8664 build of &CCL;. You can fetch a different
    222         version by substituting its name in place of
    223         "darwinx8664". Current available versions are:</para>
     201        <para>The above command will fetch the complete sources and binaries
     202        for the Darwin x86 build of &CCL;. To get a &CCL; for another platform,
     203        replace "darwinx86" with one of the following names (all versions
     204        include both 32- and 64-bit binaries):</para>
    224205
    225206        <itemizedlist>
    226           <listitem><para>darwinppc</para></listitem>
    227           <listitem><para>darwinx8664</para></listitem>
    228           <listitem><para>freebsdx8664</para></listitem>
    229           <listitem><para>linuxppc</para></listitem>
    230           <listitem><para>linuxx8664</para></listitem>
     207          <listitem><para>darwinx86</para></listitem>
     208          <listitem><para>linunxx86</para></listitem>
     209          <listitem><para>freebsdx86</para></listitem>
     210          <listitem><para>solarisx86</para></listitem>
     211          <listitem><para>windows</para></listitem>
     212          <listitem><para>linuxppc</para></listitem>
     213          <listitem><para>darwinppc</para></listitem>
    231214        </itemizedlist>
    232215
     
    282265    <sect2><title>Tarballs</title>
    283266      <para>Tarballs are available at <ulink
    284       url="ftp://clozure.com/pub/release/1.2/"/>.  Download and extract
     267      url="ftp://clozure.com/pub/release/1.3/"/>.  Download and extract
    285268      one on your local disk.  Then edit the &CCL; shell script to set
    286269      the value of <varname>CCL_DEFAULT_DIRECTORY</varname> and start
Note: See TracChangeset for help on using the changeset viewer.