Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Diff of /preface.xmlf [f587e9] .. [9e7c20] Maximize Restore

  Switch to side-by-side view

--- a/preface.xmlf
+++ b/preface.xmlf
@@ -1,13 +1,9 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE preface [
-<!ENTITY % eclent SYSTEM "ecl.ent">
-%eclent;
-]>
-<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
-<preface xml:id="preface">
+<?xml version="1.0" encoding="utf-8"?><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<book lang="en">
+<preface id="preface">
  <title>Preface</title>
 
- <section xml:id="preface.words">
+ <section id="preface.words">
   <title>About this book</title>
 
   <para>This manual is part of the &ECL; software system. It documents
@@ -39,7 +35,7 @@
   fragile one and prone to change.</para>
  </section>
 
- <section xml:id="preface.what.is.ecl">
+ <section id="preface.what.is.ecl">
   <title>What is &ECL;?</title>
 
   <para>&CommonLisp; is a general purpose programming language. It lays its
@@ -77,10 +73,10 @@
 
  </section>
 
- <section xml:id="preface.history">
+ <section id="preface.history">
   <title>History</title>
 
-  <para><figure float="1" xml:id="fig.family-tree">
+  <para><figure float="1" id="fig.family-tree">
    <title>ECL's family tree</title>
    <mediaobject>
     <imageobject>
@@ -122,7 +118,7 @@
   goal that other Common Lisps were struggling to achieve.</para>
 
   <para>This is where the <acronym>ECLS</acronym> or
-  <acronym>ECL</acronym>-Spain project began. Juanjo Garc��a-Ripoll took
+  <acronym>ECL</acronym>-Spain project began. Juanjo Garc&iacute;a-Ripoll took
   the ECoLisp sources and worked on them, with some immediate goals in mind:
   increase portability, make the code 64-bit clean, make it able to build
   itself from scratch, without other implementation of &CommonLisp; and restore
@@ -141,21 +137,21 @@
   and porting &ECL; to new platforms.</para>
 
   <para>Currently, development of &ECL; is still driven by Juanjo
-  Garc��a-Ripoll with the help of Michael Goffioul in the Windows
+  Garc&iacute;a-Ripoll with the help of Michael Goffioul in the Windows
   port. The project homepage is located at <ulink
   url="http://ecls.sourceforge.net"><uri>http://ecls.sourceforge.net</uri></ulink>,
   and there is a mailing list where questions, bug reports and other
   discussions may be carried out.</para>
  </section>
 
- <section xml:id="Copyright.ECL">
-  <title>Copyright of ECL</title>
+ <section id="Copyright">
+  <title>Copyright</title>
 
   <para>&ECL; is distributed under the GNU LGPL, which allows for commercial
   uses of the software. A more precise description is given in the Copyright
   notice which is shipped with &ECL;.</para>
 
-<programlisting>
+<screen>
 ---- BEGINNING OF COPYRIGHT FOR THE ECL CORE ENVIRONMENT ------------
 
   Copyright (c) 2000, Juan Jose Garcia Ripoll
@@ -192,271 +188,10 @@
   Report bugs, comments, suggestions to the ecl mailing list:
   ecls-list@lists.sourceforge.net.
 
----- END OF COPYRIGHT FOR THE ECL CORE ENVIRONMENT ------------------</programlisting>
- </section>
-
- <section xml:id="Copyright.Manual">
-  <title>Copyright of this manual</title>
-
-  <para>Copyright: Juan Jos�� Garc��a-Ripoll, 2006.</para>
-
-  <para>Copyright: Kevin M. Rosenberg 2002-2003, (UFFI Reference)</para>
-
-  <itemizedlist>
-   <listitem><para>&ACL; is a registered trademark of Franz Inc.</para></listitem>
-   <listitem><para>&LW; is a registered trademark of Xanalys Inc.</para></listitem>
-   <listitem><para><productname>Microsoft Windows</productname> is a registered
-   trademark of Microsoft Inc.</para></listitem>
-   <listitem><para>Other brand or product names are the registered trademarks
-   or trademarks of their respective holders.</para></listitem>
-  </itemizedlist>
-
-  <para>Permission is granted to copy, distribute and/or modify this document
-  under the terms of the GNU Free Documentation License, Version 1.1 or any
-  later version published by the Free Software Foundation; with no Invariant
-  Sections, with the no Front-Cover Texts, and with no Back-Cover Texts.  A
-  copy of the license is shown below.</para>
-
-  <programlisting>
-   &GFDL;</programlisting>
-
- </section>
-
- <section xml:id="preface.installation">
-  <title>Installation</title>
-
-  <para>The following sections describe which machines are supported by &ECL;,
-  how to build and install it on them. You should read at least <xref
-  linkend="preface.platforms"/> and in particular <xref linkend="table.ports"/>
-  which details the other sections containing installation instructions for
-  your platform.</para>
-
-  <section xml:id="preface.platforms">
-   <title>Supported platforms</title>
-
-   <table xml:id="table.ports">
-    <title>Supported platforms</title>
-    <tgroup cols="3">
-     <thead>
-      <row>
-       <entry>Architecture</entry>
-       <entry>Operating system</entry>
-       <entry>Toolchain</entry>
-       <entry>Tested<footnote><para>YES means that a dedicated machine regularly builds and tests &ECL; on this platform.</para></footnote></entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>x86 <footnote xml:id="note.x86"><para>Intel 32 bit processors
-       (Pentium, Pentium II, Pentium 3, Pentium 4) and AMD
-       clones</para></footnote>
-       </entry>
-       <entry>Linux</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86_64<footnote xml:id="note.amd"><para>AMD and Intel processors with
-       64 bit extensions.</para></footnote></entry>
-       <entry>Linux</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>PPC</entry>
-       <entry>Linux</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>Itanium</entry>
-       <entry>Linux</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry>FreeBSD</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry><link linkend="preface.bsd">OpenBSD</link></entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry><link linkend="preface.bsd">NetBSD</link></entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry>Windows XP, Vista, 7</entry>
-       <entry><link linkend="preface.msvc">Microsoft compilers</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry>Windows XP, Vista, 7</entry>
-       <entry><link linkend="preface.autoconf">&cygwin;</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry>Windows XP, Vista, 7</entry>
-       <entry><link linkend="preface.autoconf">&mingw; and Msys tools</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry>OS X Tiger</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86_64</entry>
-       <entry>OS X Tiger</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86</entry>
-       <entry>Solaris</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>x86_64</entry>
-       <entry>Solaris</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-      <row>
-       <entry>Sparc</entry>
-       <entry>Solaris</entry>
-       <entry><link linkend="preface.autoconf">Autoconf</link></entry>
-       <entry>YES</entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </table>
-   
-   <para>In <xref linkend="table.ports"/> we show the operating systems in
-   which ECL is known to run and where it is regularly tested. Note that ECL
-   might successfully build on other platforms, and that porting is relatively
-   easy. We regularly get reports on ECL being built on other platforms (ARM,
-   Motorola 68x, Sparc, etc), so the best thing is to try yourself.</para>
-
-  </section>
-
-  <section xml:id="preface.autoconf">
-   <title>Autoconf based configuration</title>
-
-   <para>&ECL;, like many other free programs, can be built and installed a GNU
-   tool called Autoconf. This is a set of automatically generated scripts that
-   detect the features of your machine, such as the compiler type, existing
-   libraries, desired installation path, and configures &ECL; accordingly. The
-   following procedure describes how to build &ECL; using this procedure and it
-   applies to all platforms except for the Windows ports.</para>
-
-   <procedure>
-    <step>
-     <para>Unpack the tar file</para>
-     <screen>$ gunzip -c ecl-0.9i.tgz | tar xf -</screen>
-    </step>
-    <step><para>Choose a directory in which you will install &ECL;. Following
-    the Unix covention we will use
-    <filename>/usr/local</filename></para></step>
-    <step>
-     <para>Run the configuration file
-     <screen>$ cd ecl-0.9i
-     $ ./configure --prefix=/usr/local</screen>
-     If you are building under Solaris 9 you should replace the last line with
-     <screen>$ ./configure --enable-slow-config --with-system-gmp=no \
-     --prefix=/usr/local</screen>
-     By now you should have a directory with the name
-     <filename>build</filename> and a bunch of makefiles inside it.</para>
-    </step>
-    <step>
-     <para>Use GNU make to begin building ECL. Normally this amounts to
-     invoking
-     <screen>$ make</screen>
-     from the command line.</para>
-    </step>
-    <step>
-     <para>Install the program using
-     <screen>$ make install</screen>
-     </para>
-    </step>
-    <step>
-     <para>Make sure the program is installed and ready to run
-     <screen>$ /usr/local/ecl
-     ECL (Embeddable Common-Lisp) 0.9i
-     Copyright (C) 1984 Taiichi Yuasa and Masami Hagiya
-     Copyright (C) 1993 Giuseppe Attardi
-     Copyright (C) 2000 Juan J. Garcia-Ripoll
-     ECL is free software, and you are welcome to redistribute it
-     under certain conditions; see file 'Copyright' for details.
-     Type :h for Help.  Broken at EVAL.
-     &gt; </screen>
-     </para>
-    </step>
-   </procedure>
-
-  </section>
-
-  <section xml:id="preface.osdep">
-   <title>Platform specific instructions</title>
-
-   <section xml:id="preface.msvc">
-    <title>Microsoft compilers</title>
-
-    <para>If you have a commercial version of Microsoft Visual Studio, the
-    steps are simple:</para>
-    <procedure>
-     <step><para>Change to the <code>msvc</code> directory.</para></step>
-
-     <step><para>Run <code>nmake</code> to build ECL.</para></step>
-
-     <step><para>Run <code>nmake install prefix=d:\Software\ECL</code>
-     where the <code>prefix</code> is the directory where you want to install
-     ECL.</para></step>
-
-     <step><para>Optionally, if you want to build a self-installing
-     executable, you can install <ulink
-     url="http://nsis.sourceforge.net">NSIS</ulink> and run <code>nmake
-     windows-nsi</code>.</para></step>
-    </procedure>
-
-    <para>If you want to build ECL using the free Microsoft Visual Studio
-    Express 2010 or better, you should follow these before building ECL as
-    sketched before:</para>
-    <procedure>
-     <step><para>Download and install <ulink
-     url="http://www.microsoft.com/express/">Microsoft Visual Studio
-     C++ Compiler</ulink>.</para></step>
-
-     <step><para>Download and install the <ulink
-     url="http://msdn.microsoft.com/en-us/windows/bb980924">Windows
-     SDK</ulink></para></step>
-
-     <step><para>Open the Windows SDK terminal, which will set up the
-     appropriate paths and environment variables.</para>
-     </step>
-    </procedure>
-   </section>
-
-   <section xml:id="preface.bsd">
-    <title>OpenBSD and NetBSD</title>
-
-    <para>Before following the instructions in <xref linkend="preface.autoconf"/> you should install the following packages: <application>boehm-gc</application> and <application>gmp-4.1</application> or better. Another component, <application>libffi</application> will be needed if you want to use the <link linkend="ext.ffi">dynamic foreign interface</link>.</para>
-   </section>
-
-  </section>
- </section>
+---- END OF COPYRIGHT FOR THE ECL CORE ENVIRONMENT ------------------
+</screen>
+ </section>
+
 </preface>
 </book>
 <!-- Keep this comment at the end of the file