commit d725a46541f65a1f5ce10ddeba1d5d5e136d964e
parent 52d317b4a07d499556a3291adce87ad1681ffaeb
Author: Andres Navarro <canavarro82@gmail.com>
Date: Fri, 21 Oct 2011 15:11:12 -0300
Updated manual and README to name this version 0.2. Added the new port applicatives to the manual.
Diffstat:
7 files changed, 158 insertions(+), 20 deletions(-)
diff --git a/README b/README
@@ -1,4 +1,4 @@
-README for klisp 0.1
+README for klisp 0.2
* What is klisp?
--------------
diff --git a/manual/html/Introduction.html b/manual/html/Introduction.html
@@ -72,14 +72,14 @@ See LICENSE for details. it can be downloaded at
undergraduate at Buenos Aires University (UBA). You can reach him at
<a href="mailto:canavarro82@gmail.com">canavarro82@gmail.com</a>.
- <p>This manual describes klisp version 0.1, presuming some familiarity
+ <p>This manual describes klisp version 0.2, 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.
+ <p>This is edition 0.2.
<ul class="menu">
<li><a accesskey="1" href="Caveats.html#Caveats">Caveats</a>: Flaws and a request for help.
diff --git a/manual/html/Ports.html b/manual/html/Ports.html
@@ -317,6 +317,55 @@ within those strings and character objects are output as if by
<p>SOURCE NOTE: this is missing from Kernel, it is taken from Scheme.
</p></blockquote></div>
+<div class="defun">
+— flush-output-port: <b>(</b><var>flush-output-port </var>[<var>port</var>])<var><a name="index-g_t_0028-282"></a></var><br>
+<blockquote><p> If the <code>port</code> optional argument is not specified, then the
+value of the <code>output-port</code> keyed dynamic variable is used. If
+the <code>port</code> is closed or if it is not an output port, an error is
+signaled.
+
+ <p>Applicative <code>flush-ouput-port</code> flushes any buffered data in the
+output port to the underlying file or device. The result returned by
+<code>flush-output-port</code> is inert.
+
+ <p>SOURCE NOTE: this is missing from Kernel, it is taken from r7rs Scheme.
+</p></blockquote></div>
+
+<div class="defun">
+— file-exists?: <b>(</b><var>file-exists? string</var>)<var><a name="index-g_t_0028-283"></a></var><br>
+<blockquote><p> <code>string</code> should be the name/path for a file.
+
+ <p>Predicate <code>file-exists?</code> checks to see if a file named
+<code>string</code> exists.
+
+ <p>SOURCE NOTE: this is missing from Kernel, it is taken from r7rs Scheme.
+</p></blockquote></div>
+
+<div class="defun">
+— delete-file: <b>(</b><var>delete-file string</var>)<var><a name="index-g_t_0028-284"></a></var><br>
+<blockquote><p> <code>string</code> should be the name/path for an existing file.
+
+ <p>Applicative <code>delete-file</code> deletes the file named <code>string</code>.
+If it doesn't exists or can't be deleted, an error is signaled. The
+result returned by <code>delete-file</code> is inert.
+
+ <p>SOURCE NOTE: this is missing from Kernel, it is taken from r7rs Scheme.
+</p></blockquote></div>
+
+<div class="defun">
+— rename-file: <b>(</b><var>rename-file string1 string2</var>)<var><a name="index-g_t_0028-285"></a></var><br>
+<blockquote><p> <code>string1</code> should be the name/path for an existing file,
+<code>string2</code> should be the name/path for a non existing file.
+
+ <p>Applicative <code>rename-file</code> renames the file named <code>string1</code>
+to <code>string2</code>. If the file doesn't exists or can't be renamed for
+any reason, an error is signaled. The result returned by
+<code>rename-file</code> is inert.
+
+ <p>SOURCE NOTE: this is missing from Kernel AND Scheme, it is taken
+from C, being quite similar to <code>delete-file</code>.
+</p></blockquote></div>
+
<!-- appendices -->
<!-- TODO -->
<!-- *-texinfo-*- -->
diff --git a/manual/klisp.info b/manual/klisp.info
@@ -3,8 +3,8 @@ klisp.texi.
This file documents klisp.
- This is edition 0.1 of the klisp Reference Manual, for klisp version
-0.1.
+ This is edition 0.2 of the klisp Reference Manual, for klisp version
+0.2.
Copyright (C) 2011 Andres Navarro
@@ -21,8 +21,8 @@ the header "Permission to copy this report", that reads:
File: klisp.info, 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.
+ This Info file contains edition 0.2 of the klisp Reference Manual,
+corresponding to klisp version 0.2.
Copyright (C) 2011 Andres Navarro
@@ -142,14 +142,14 @@ See LICENSE for details. it can be downloaded at
undergraduate at Buenos Aires University (UBA). You can reach him at
<canavarro82@gmail.com>.
- This manual describes klisp version 0.1, presuming some familiarity
+ This manual describes klisp version 0.2, 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.
+ This is edition 0.2.
* Menu:
@@ -2373,6 +2373,50 @@ klisp and was taken from Scheme.
SOURCE NOTE: this is missing from Kernel, it is taken from Scheme.
+ -- flush-output-port: (flush-output-port [port])
+ If the `port' optional argument is not specified, then the value
+ of the `output-port' keyed dynamic variable is used. If the
+ `port' is closed or if it is not an output port, an error is
+ signaled.
+
+ Applicative `flush-ouput-port' flushes any buffered data in the
+ output port to the underlying file or device. The result returned
+ by `flush-output-port' is inert.
+
+ SOURCE NOTE: this is missing from Kernel, it is taken from r7rs
+ Scheme.
+
+ -- file-exists?: (file-exists? string)
+ `string' should be the name/path for a file.
+
+ Predicate `file-exists?' checks to see if a file named `string'
+ exists.
+
+ SOURCE NOTE: this is missing from Kernel, it is taken from r7rs
+ Scheme.
+
+ -- delete-file: (delete-file string)
+ `string' should be the name/path for an existing file.
+
+ Applicative `delete-file' deletes the file named `string'. If it
+ doesn't exists or can't be deleted, an error is signaled. The
+ result returned by `delete-file' is inert.
+
+ SOURCE NOTE: this is missing from Kernel, it is taken from r7rs
+ Scheme.
+
+ -- rename-file: (rename-file string1 string2)
+ `string1' should be the name/path for an existing file, `string2'
+ should be the name/path for a non existing file.
+
+ Applicative `rename-file' renames the file named `string1' to
+ `string2'. If the file doesn't exists or can't be renamed for any
+ reason, an error is signaled. The result returned by `rename-file'
+ is inert.
+
+ SOURCE NOTE: this is missing from Kernel AND Scheme, it is taken
+ from C, being quite similar to `delete-file'.
+
File: klisp.info, Node: Alphabetical Index, Next: (dir), Prev: Ports, Up: Top
@@ -2688,6 +2732,6 @@ Node: Numbers72131
Node: Strings91630
Node: Characters96977
Node: Ports99687
-Node: Alphabetical Index110985
+Node: Alphabetical Index112662
End Tag Table
diff --git a/manual/src/intro.texi b/manual/src/intro.texi
@@ -84,14 +84,14 @@ See LICENSE for details. it can be downloaded at
undergraduate at Buenos Aires University (UBA). You can reach him at
@email{canavarro82@@gmail.com}.
- This manual describes klisp version 0.1, presuming some familiarity
+ This manual describes klisp version 0.2, 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.
+ This is edition 0.2.
@menu
* Caveats:: Flaws and a request for help.
diff --git a/manual/src/klisp.texi b/manual/src/klisp.texi
@@ -19,8 +19,8 @@ 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.
+This is edition 0.2 of the klisp Reference Manual,
+for klisp version 0.2.
Copyright (C) 2011 Andres Navarro
@@ -40,10 +40,10 @@ permission is granted to copy it in whole or in part without fee.
@titlepage
@title klisp Reference Manual
-@subtitle klisp version 0.1
+@subtitle klisp version 0.2
@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
+@subtitle Edition 0.2, October 2011
@author by Andres Navarro
@page
@@ -51,8 +51,8 @@ permission is granted to copy it in whole or in part without fee.
Copyright @copyright{} 2011 Andres Navarro
@sp 2
-This is edition 0.1 of the @cite{klisp Reference Manual},
-for klisp Version 01.,@*
+This is edition 0.2 of the @cite{klisp Reference Manual},
+for klisp Version 0.2,@*
May 2011.@*
@sp 2
@@ -73,8 +73,8 @@ permission is granted to copy it in whole or in part without fee.
@node Top, License, (dir), (dir)
@ifinfo
-This Info file contains edition 0.1 of the klisp Reference Manual,
-corresponding to klisp version 0.1.
+This Info file contains edition 0.2 of the klisp Reference Manual,
+corresponding to klisp version 0.2.
Copyright @copyright{} 2011 Andres Navarro
diff --git a/manual/src/ports.texi b/manual/src/ports.texi
@@ -270,3 +270,48 @@ within those strings and character objects are output as if by
SOURCE NOTE: this is missing from Kernel, it is taken from Scheme.
@end deffn
+
+@deffn flush-output-port (flush-output-port [port])
+ If the @code{port} optional argument is not specified, then the
+value of the @code{output-port} keyed dynamic variable is used. If
+the @code{port} is closed or if it is not an output port, an error is
+signaled.
+
+ Applicative @code{flush-ouput-port} flushes any buffered data in the
+output port to the underlying file or device. The result returned by
+@code{flush-output-port} is inert.
+
+ SOURCE NOTE: this is missing from Kernel, it is taken from r7rs Scheme.
+@end deffn
+
+@deffn file-exists? (file-exists? string)
+ @code{string} should be the name/path for a file.
+
+ Predicate @code{file-exists?} checks to see if a file named
+@code{string} exists.
+
+ SOURCE NOTE: this is missing from Kernel, it is taken from r7rs Scheme.
+@end deffn
+
+@deffn delete-file (delete-file string)
+ @code{string} should be the name/path for an existing file.
+
+ Applicative @code{delete-file} deletes the file named @code{string}.
+If it doesn't exists or can't be deleted, an error is signaled. The
+result returned by @code{delete-file} is inert.
+
+ SOURCE NOTE: this is missing from Kernel, it is taken from r7rs Scheme.
+@end deffn
+
+@deffn rename-file (rename-file string1 string2)
+ @code{string1} should be the name/path for an existing file,
+@code{string2} should be the name/path for a non existing file.
+
+ Applicative @code{rename-file} renames the file named @code{string1}
+to @code{string2}. If the file doesn't exists or can't be renamed for
+any reason, an error is signaled. The result returned by
+@code{rename-file} is inert.
+
+ SOURCE NOTE: this is missing from Kernel AND Scheme, it is taken
+from C, being quite similar to @code{delete-file}.
+@end deffn
