1
0
Fork 0
cl-sites/ecl.common-lisp.dev/static/manual/About-this-book.html

218 lines
8 KiB
HTML
Raw Permalink Normal View History

2024-12-24 19:15:49 +01:00
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.0.3, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>About this book (ECL Manual)</title>
<meta name="description" content="About this book (ECL Manual)">
<meta name="keywords" content="About this book (ECL Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="Indexes.html" rel="index" title="Indexes">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Introduction.html" rel="up" title="Introduction">
<link href="What-is-ECL.html" rel="next" title="What is ECL">
<style type="text/css">
<!--
/* colors */
span.r {font-family: initial; font-weight: normal; font-style: normal}
@media (prefers-color-scheme: dark) {
/* dark theme */
html { color: seashell;
background: #1A1A1A; }
body { background: #1A1A1A; }
th { border-bottom: 2px solid lightgray; }
h1, h2, h3, h4, h5 { background-image: linear-gradient(to left, #202020, #3A3A3A); }
code, var, code a { color: darkorange;
background: #2A2A2A; }
a { color: seashell; }
pre { background: #2A2A2A;
color: seashell;
/* mark longer code block with stripe on the left */
border-left: 5px solid darkorange;
padding-left: 10px; }
pre.screen { background: #2A2A2A;
border: 1px solid lightgray; }
pre.programlisting { background: #2A2A2A;
border-left: 1px solid lightgray;
border-top: 1px solid lightgray; }
/* we need a light background in order for the images to be readable */
img { background: white }
}
@media (prefers-color-scheme: light) {
/* light theme */
html { background: white }
body { background: white }
th { border-bottom: 2px solid gray; }
h1, h2, h3, h4, h5 { background: lightgray; }
code, var, code a { color: darkred;
background: whitesmoke; }
a { color: #000; }
pre { background: whitesmoke;
color: black;
/* mark longer code block with stripe on the left */
border-left: 5px solid darkred;
padding-left: 10px; }
pre.screen { background: #EEE;
border: 1px solid black; }
pre.programlisting { background: #EEEEEE;
border-left: 1px solid black;
border-top: 1px solid black; }
}
body {
margin: 1em 125px 0 10%;
line-height: 1.5em;
padding: 0 2em 1em 2em;
font: 13px Verdana,Arial, sans-serif
}
ul, dd, dl, dt { margin-top: 0; margin-bottom: 0; }
p, code, td, dl, dt {
line-height: 1.5em;
}
table {
font: inherit;
border-collapse: collapse;
}
th, td {
vertical-align: top;
}
h1, h2, h3 { padding-left: 15px; }
h4, h5 { padding-left: 5px; }
code, pre {
font-size: 1em;
font-family: monospace;
}
var {
font-size: 1em;
}
/* links inside code appear the same as the code itself */
code a {
font-weight: normal;
text-decoration: none;
}
/* but get an underline when hovering */
code a:hover {
text-decoration: underline;
}
/* ordinary links appear in bold */
a { font-weight: bold; }
pre.verbatim {
margin: 0 0 0 0;
}
pre {
overflow: auto;
}
pre.screen {
font-weight: bold;
padding: 0.5em;
}
pre.programlisting {
padding: 0.5em;
}
div p { padding: 0 2em }
li p { padding: 0; margin: 0 }
hr { display: none; }
div.funcsynopsis p {
text-indent: -2em;
}
div.variablelist {
padding: 0 2em;
}
.type, .funcsynopsis, .symbol {
font-family: monospace;
}
.type, .symbol, .replaceable {
white-space: nowrap;
}
-->
</style>
</head>
<body lang="en">
<div class="section-level-extent" id="About-this-book">
<div class="nav-panel">
<p>
Next: <a href="What-is-ECL.html" accesskey="n" rel="next">What is ECL</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Indexes.html" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="About-this-book-1">About this book</h3>
<p>This manual is part of the ECL software system. It documents deviations
of ECL from various standards ([see <a class="pxref" href="Bibliography.html">ANSI</a>], [see <a class="pxref" href="Bibliography.html">AMOP</a>],...),
extensions, daily working process (compiling files, loading sources,
creating programs, etc) and the internals of this implementation.
</p>
<p>It is not intended as a source to learn Common Lisp. There are other
tutorials and textbooks available in the Net which serve this
purpose. The homepage of the
<a class="uref" href="https://common-lisp.net">Common-Lisp.net</a> contains a good list of
links of such teaching and learning material.
</p>
<p>This book is structured into four parts:
</p>
<ul class="mini-toc">
<li><a href="About-this-book.html#User_0027s-guide-1" accesskey="1">User&rsquo;s guide</a></li>
<li><a href="About-this-book.html#Developer_0027s-guide-1" accesskey="2">Developer&rsquo;s guide</a></li>
<li><a href="About-this-book.html#Standards-1" accesskey="3">Standards</a></li>
<li><a href="About-this-book.html#Extensions-1" accesskey="4">Extensions</a></li>
</ul>
<div class="subsection-level-extent" id="User_0027s-guide-1">
<h4 class="subsection">User&rsquo;s guide</h4>
<p>We begin with [<a class="ref" href="User_0027s-guide.html">User&rsquo;s guide</a>] which provides introductory material
showing the user how to build and use ECL and some of its unique
features. This part assumes some basic Common Lisp knowledge and is
suggested as an entry point for new users who want to start using
<b class="b"><span class="r">Embeddable Common Lisp</span></b>.
</p>
</div>
<div class="subsection-level-extent" id="Developer_0027s-guide-1">
<h4 class="subsection">Developer&rsquo;s guide</h4>
<p>[<a class="ref" href="Developer_0027s-guide.html">Developer&rsquo;s guide</a>] documents <b class="b"><span class="r">Embeddable Common Lisp</span></b> implementation details. This
part is not meant for normal users but rather for the ECL developers
and other people who want to contribute to <b class="b"><span class="r">Embeddable Common Lisp</span></b>. This section is prone
to change due to the dynamic nature of the software. Covered topics
include source code structure, contributing guide, internal
implementation details and many other topics relevant to the development
process.
</p>
</div>
<div class="subsection-level-extent" id="Standards-1">
<h4 class="subsection">Standards</h4>
<p>[<a class="ref" href="Standards.html">Standards</a>] documents all parts of the standard which are left as
implementation specific or to which ECL doesn&rsquo;t adhere. For instance,
precision of floating point numbers, available character sets, actual
input/output protocols, etc.
</p>
<p>Section covers also <em class="emph">C Reference</em> as a description of <span class="r">ANSI Common-Lisp</span> from
the C/C++ programmer perspective and <em class="emph">ANSI Dictionary</em> for <span class="r">Common-Lisp</span>
constructs available from C/C++.
</p>
</div>
<div class="subsection-level-extent" id="Extensions-1">
<h4 class="subsection">Extensions</h4>
<p>[<a class="ref" href="Extensions.html">Extensions</a>] introduces all features which are specific to ECL and
which lay outside the standard. This includes configuring, building and
installing ECL multiprocessing capabilities, graphics libraries,
interfacing with the operating system, etc.
</p></div>
</div>
<hr>
<div class="nav-panel">
<p>
Next: <a href="What-is-ECL.html" accesskey="n" rel="next">What is ECL</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Indexes.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>