commit d92f9144bab42b51cb266bc06931de67d92cb412
parent c76f788372bdae412122f7d91f4d7abdeeceb663
Author: Andres Navarro <canavarro82@gmail.com>
Date: Mon, 23 May 2011 18:18:20 -0300
Added a preliminary manual. Only intro & license.
Diffstat:
6 files changed, 472 insertions(+), 0 deletions(-)
diff --git a/manual/html/Introduction.html b/manual/html/Introduction.html
@@ -0,0 +1,74 @@
+<html lang="en">
+<head>
+<title>Introduction - klisp Reference Manual</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="klisp Reference Manual">
+<meta name="generator" content="makeinfo 4.13">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="prev" href="License.html#License" title="License">
+<link rel="next" href="../index.html#dir" title="(dir)">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<a name="Introduction"></a>
+<p>
+Next: <a rel="next" accesskey="n" href="../index.html#dir">(dir)</a>,
+Previous: <a rel="previous" accesskey="p" href="License.html#License">License</a>,
+Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
+<hr>
+</div>
+
+<h2 class="chapter">1 Introduction</h2>
+
+<p>klisp is an open source interpreter for the Kernel Programming
+Language. It aims at being comprehensive and robust as specified in
+the "Revised(-1) Report on the Kernel Programming Language", but
+that probably won't happen for some time. It is written in C99 under
+the MIT license. It draws heavily from the Lua interpreter source
+code & file structure. It uses the IMath library for arbitrary sized
+integers and rationals.
+
+ <p>Kernel is a conservative, Scheme-like dialect of Lisp in which
+everything is a first-class object. It was created by John N. Shutt.
+You can read all about it at http://web.cs.wpi.edu/~jshutt/kernel.html
+
+ <p>klisp is freely available for both academic and commercial purposes.
+See LICENSE for details. it can be downloaded at
+http://www.bitbucket.org/AndresNavarro/klisp
+
+ <p>klisp is developed by Andres Navarro, a Computer Science
+undergraduate at Buenos Aires University (UBA). You can reach him at
+<canavarro82@gmail.com>.
+
+ <p>This manual describes klisp version 0.1, presuming some familiarity
+with the Lisp family of languages in general, and with the Kernel
+Programming Language in particular. There are frequent references to
+the Kernel Programming Language Report. Unlike in the report, no
+rationale is provided for any feature, only a description of the
+implemented functionality.
+
+ <p>This is edition 0.1.
+
+<!-- appendices -->
+<!-- TODO -->
+<!-- @include index.texi -->
+<!-- Print the tables of contents -->
+<!-- FOR some reason this ends up in the last node instead of the general... -->
+<!-- TODO @summarycontents -->
+<!-- TODO @contents -->
+<!-- That's all -->
+</body></html>
+
diff --git a/manual/html/License.html b/manual/html/License.html
@@ -0,0 +1,70 @@
+<html lang="en">
+<head>
+<title>License - klisp Reference Manual</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="klisp Reference Manual">
+<meta name="generator" content="makeinfo 4.13">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="prev" href="index.html#Top" title="Top">
+<link rel="next" href="Introduction.html#Introduction" title="Introduction">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<div class="node">
+<a name="License"></a>
+<p>
+Next: <a rel="next" accesskey="n" href="Introduction.html#Introduction">Introduction</a>,
+Previous: <a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
+Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
+<hr>
+</div>
+
+<!-- node-name, next, previous, up -->
+ <p>klisp is licensed under the terms of the MIT license reproduced below.
+This means that klisp is free software and can be used for both academic
+and commercial purposes at absolutely no cost.
+The two projects whose code klisp uses, Lua & IMath, are also distributed
+under the MIT license.
+
+ <ul>
+<li>klisp Parts: Copyright © 2011 Andres Navarro.
+<li>Lua Parts: Copyright © 1994-2010 Lua.org, PUC-Rio.
+<li>IMath Parts: Copyright © 2002-2007 Michael J. Fromberger.
+<li>srfi-78: Copyright © 2005-2006 Sebastian Egner.
+</ul>
+
+<h2 class="unnumbered">MIT/X11 License</h2>
+
+<p>Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+ <p>The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+ <p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+<!-- add next node -->
+ </body></html>
+
diff --git a/manual/html/index.html b/manual/html/index.html
@@ -0,0 +1,51 @@
+<html lang="en">
+<head>
+<title>klisp Reference Manual</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="klisp Reference Manual">
+<meta name="generator" content="makeinfo 4.13">
+<link title="Top" rel="start" href="index.html#Top">
+<link rel="up" href="../index.html#dir" title="(dir)">
+<link rel="prev" href="../index.html#dir" title="(dir)">
+<link rel="next" href="License.html#License" title="License">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+ pre.display { font-family:inherit }
+ pre.format { font-family:inherit }
+ pre.smalldisplay { font-family:inherit; font-size:smaller }
+ pre.smallformat { font-family:inherit; font-size:smaller }
+ pre.smallexample { font-size:smaller }
+ pre.smalllisp { font-size:smaller }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
+--></style>
+</head>
+<body>
+<h1 class="settitle">klisp Reference Manual</h1>
+<div class="node">
+<a name="Top"></a>
+<p>
+Next: <a rel="next" accesskey="n" href="License.html#License">License</a>,
+Previous: <a rel="previous" accesskey="p" href="../index.html#dir">(dir)</a>,
+Up: <a rel="up" accesskey="u" href="../index.html#dir">(dir)</a>
+<hr>
+</div>
+
+<ul class="menu">
+<li><a accesskey="1" href="License.html#License">License</a>: Conditions for copying and changing klisp.
+<li><a accesskey="2" href="Introduction.html#Introduction">Introduction</a>: Introduction and conventions used.
+
+<!-- TODO -->
+<!-- TODO index -->
+<!-- * Index:: Index including concepts, functions, variables, -->
+<!-- and other terms. -->
+<!-- Appendices -->
+<!-- TODO -->
+<!-- TODO add detailed node listing -->
+ </ul>
+
+<!-- *-texinfo-*- -->
+ </body></html>
+
diff --git a/manual/klisp.info b/manual/klisp.info
@@ -0,0 +1,112 @@
+This is klisp, produced by makeinfo version 4.13 from
+/home/deka/prog/kernel/klisp/manual/src/klisp.texi.
+
+This file documents klisp.
+
+ This is edition 0.1 of the klisp Reference Manual, for klisp
+version 0.1.
+
+ Copyright (C) 2011 Andres Navarro
+
+ Permission is granted to make and distribute this manual, in whole
+or in part.
+
+
+File: klisp, Node: Top, Next: License, Prev: (dir), Up: (dir)
+
+ This Info file contains edition 0.1 of the klisp Reference Manual,
+corresponding to klisp version 0.1.
+
+ Copyright (C) 2011 Andres Navarro
+
+ Permission is granted to make and distribute this manual, in whole
+or in part.
+
+* Menu:
+
+* License:: Conditions for copying and changing klisp.
+* Introduction:: Introduction and conventions used.
+
+
+File: klisp, Node: License, Next: Introduction, Prev: Top, Up: Top
+
+ klisp is licensed under the terms of the MIT license reproduced
+below. This means that klisp is free software and can be used for
+both academic and commercial purposes at absolutely no cost. The two
+projects whose code klisp uses, Lua & IMath, are also distributed
+under the MIT license.
+
+ * klisp Parts: Copyright (C) 2011 Andres Navarro.
+
+ * Lua Parts: Copyright (C) 1994-2010 Lua.org, PUC-Rio.
+
+ * IMath Parts: Copyright (C) 2002-2007 Michael J. Fromberger.
+
+ * srfi-78: Copyright (C) 2005-2006 Sebastian Egner.
+
+MIT/X11 License
+***************
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+ The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+File: klisp, Node: Introduction, Next: (dir), Prev: License, Up: Top
+
+1 Introduction
+**************
+
+klisp is an open source interpreter for the Kernel Programming
+Language. It aims at being comprehensive and robust as specified in
+the "Revised(-1) Report on the Kernel Programming Language", but that
+probably won't happen for some time. It is written in C99 under the
+MIT license. It draws heavily from the Lua interpreter source code &
+file structure. It uses the IMath library for arbitrary sized
+integers and rationals.
+
+ Kernel is a conservative, Scheme-like dialect of Lisp in which
+everything is a first-class object. It was created by John N. Shutt.
+You can read all about it at http://web.cs.wpi.edu/~jshutt/kernel.html
+
+ klisp is freely available for both academic and commercial
+purposes. See LICENSE for details. it can be downloaded at
+http://www.bitbucket.org/AndresNavarro/klisp
+
+ klisp is developed by Andres Navarro, a Computer Science
+undergraduate at Buenos Aires University (UBA). You can reach him at
+<canavarro82@gmail.com>.
+
+ This manual describes klisp version 0.1, presuming some familiarity
+with the Lisp family of languages in general, and with the Kernel
+Programming Language in particular. There are frequent references to
+the Kernel Programming Language Report. Unlike in the report, no
+rationale is provided for any feature, only a description of the
+implemented functionality.
+
+ This is edition 0.1.
+
+
+
+Tag Table:
+Node: Top334
+Node: License775
+Node: Introduction2442
+
+End Tag Table
diff --git a/manual/src/intro.texi b/manual/src/intro.texi
@@ -0,0 +1,75 @@
+@c -*-texinfo-*-
+@setfilename ../src/intro
+
+@node License, Introduction, Top, Top
+@comment node-name, next, previous, up
+
+klisp is licensed under the terms of the MIT license reproduced below.
+This means that klisp is free software and can be used for both academic
+and commercial purposes at absolutely no cost.
+The two projects whose code klisp uses, Lua & IMath, are also distributed
+under the MIT license.
+
+@itemize @bullet
+@item
+klisp Parts: Copyright @copyright{} 2011 Andres Navarro.
+@item
+Lua Parts: Copyright @copyright{} 1994-2010 Lua.org, PUC-Rio.
+@item
+IMath Parts: Copyright @copyright{} 2002-2007 Michael J. Fromberger.
+@item
+srfi-78: Copyright @copyright{} 2005-2006 Sebastian Egner.
+@end itemize
+
+@unnumbered MIT/X11 License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+@c add next node
+@node Introduction, (dir), License, Top
+@chapter Introduction
+
+ klisp is an open source interpreter for the Kernel Programming
+Language. It aims at being comprehensive and robust as specified in
+the "Revised(-1) Report on the Kernel Programming Language", but
+that probably won't happen for some time. It is written in C99 under
+the MIT license. It draws heavily from the Lua interpreter source
+code & file structure. It uses the IMath library for arbitrary sized
+integers and rationals.
+
+ Kernel is a conservative, Scheme-like dialect of Lisp in which
+everything is a first-class object. It was created by John N. Shutt.
+You can read all about it at http://web.cs.wpi.edu/~jshutt/kernel.html
+
+ klisp is freely available for both academic and commercial purposes.
+See LICENSE for details. it can be downloaded at
+http://www.bitbucket.org/AndresNavarro/klisp
+
+ klisp is developed by Andres Navarro, a Computer Science
+undergraduate at Buenos Aires University (UBA). You can reach him at
+<canavarro82@@gmail.com>.
+
+ This manual describes klisp version 0.1, presuming some familiarity
+with the Lisp family of languages in general, and with the Kernel
+Programming Language in particular. There are frequent references to
+the Kernel Programming Language Report. Unlike in the report, no
+rationale is provided for any feature, only a description of the
+implemented functionality.
+
+ This is edition 0.1.
diff --git a/manual/src/klisp.texi b/manual/src/klisp.texi
@@ -0,0 +1,90 @@
+\input texinfo @c -*-texinfo-*-
+@c %**start of header
+@setfilename klisp
+@settitle klisp Reference Manual
+@c %**end of header
+
+@ifinfo
+This file documents klisp.
+
+@c The edition number appears in several places in this file
+@c and also in the file intro.texi.
+This is edition 0.1 of the klisp Reference Manual,
+for klisp version 0.1.
+
+Copyright (C) 2011 Andres Navarro
+
+Permission is granted to make and distribute this manual, in whole or
+in part.
+@c TODO put up better text for this.
+@end ifinfo
+
+@setchapternewpage odd
+
+@titlepage
+@title klisp Reference Manual
+@subtitle klisp version 0.1
+@c The edition number appears in several places in this file
+@c and also in the file intro.texi.
+@subtitle Edition 0.1, May 2011
+
+@author by Andres Navarro
+@page
+@vskip 0pt plus 1filll
+Copyright @copyright{} 2011 Andres Navarro
+
+@sp 2
+This is edition 0.1 of the @cite{klisp Reference Manual},
+for klisp Version 01.,@*
+May 2011.@*
+
+@sp 2
+
+Permission is granted to make and distribute this manual, in whole or
+in part.
+@end titlepage
+@page
+
+@node Top, License, (dir), (dir)
+
+@ifinfo
+This Info file contains edition 0.1 of the klisp Reference Manual,
+corresponding to klisp version 0.1.
+
+Copyright @copyright{} 2011 Andres Navarro
+
+Permission is granted to make and distribute this manual, in whole or
+in part.
+@c TODO put up better text for this.
+@end ifinfo
+
+@menu
+* License:: Conditions for copying and changing klisp.
+* Introduction:: Introduction and conventions used.
+
+@c TODO
+
+@c TODO index
+@c * Index:: Index including concepts, functions, variables,
+@c and other terms.
+
+@c Appendices
+@c TODO
+
+@c TODO add detailed node listing
+@end menu
+
+@include intro.texi
+
+@c appendices
+@c TODO
+
+@c @include index.texi
+
+@c Print the tables of contents
+@c FOR some reason this ends up in the last node instead of the general...
+@c TODO @summarycontents
+@c TODO @contents
+@c That's all
+
+@bye
