Unnamed repository; edit this file to name it for gitweb.
git clone https://logand.com/git/picolisp.git/
Log | Files | Refs | README | LICENSE

commit 752ad94c7ff341664847a55cfab251802300b8a3
parent 9c9704beef8072d79d520686dcf11a5567a48f70
Author: Alexander Burger <abu@software-lab.de>
Date:   Tue, 10 May 2011 09:21:54 +0200

Global vs. local invocation
Mdoc/app.html | 26++++++++++++++++++--------
Mgames/README | 19+++++++++----------
2 files changed, 27 insertions(+), 18 deletions(-)

diff --git a/doc/app.html b/doc/app.html @@ -326,7 +326,7 @@ the server process (you must have generated a <a href="#pw">".pw" file</a> for this), and enter the <code>html</code> statement <pre><code> -$ bin/psh 8080 +$ /usr/share/picolisp/bin/psh 8080 : (html 0 "Hello" "@lib.css" NIL "Hello World!") HTTP/1.0 200 OK Server: PicoLisp @@ -456,7 +456,7 @@ application server is running, and you did generate a <a href="#pw">".pw" file</a>) <pre><code> -$ bin/psh 8080 +$ /usr/share/picolisp/bin/psh 8080 : </code></pre> @@ -1089,8 +1089,8 @@ so far, we want to build a simple bignum calculator. ("bignum" because PicoLisp can do <i>only</i> bignums) <p>It uses a single form, a single numeric input field, and lots of buttons. It -can be found in the PicoLisp distribution in "misc/calc.l", together with a -directly executable wrapper script "misc/calc". +can be found in the PicoLisp distribution (e.g. under "/usr/share/picolisp/") in +"misc/calc.l", together with a directly executable wrapper script "misc/calc". <p>To use it, change to the PicoLisp installation directory, and start it as @@ -1098,10 +1098,11 @@ directly executable wrapper script "misc/calc". $ misc/calc </code></pre> -<p>If you want to use it from other directories too, change the two relative -path names in the first line to absolute paths. We recommend symbolic links in -some global directories, as described in the <a -href="tut.html#script">Scripting</a> section of the PicoLisp Tutorial. +<p>or call it with an absolute path, e.g. + +<pre><code> +$ /usr/share/picolisp/misc/calc +</code></pre> <p>If you like to get a PicoLisp prompt for inspection, start it instead as @@ -2178,6 +2179,15 @@ with a some initial data and two sample reports. <p><hr> <h3><a name="getStarted">Getting Started</a></h3> +<p>For a global installation (see <a href="ref.html#inst">Installation</a>), +please create a symbolic link to the place where the program files are +installed. This is necessary because the application needs read/write access to +the current working directory (for the database and other runtime data). + +<pre><code> +$ ln -s /usr/share/picolisp/app +</code></pre> + <p>As ever, you may start up the application in debugging mode <pre><code> diff --git a/games/README b/games/README @@ -1,4 +1,4 @@ -12nov09abu +10may11abu (c) Software Lab. Alexander Burger @@ -8,11 +8,14 @@ This directory contains a few simple games. They are neither especially interesting, nor powerful, but may be useful as programming examples. +For a global PicoLisp installation (see the INSTALL file), either supply a full +path to "/usr/share/picolisp/games/<file>.l" instead of just "games/<file>.l" in +the commands below, or change the working directory to "/usr/share/picolisp/". 'mine' is a simplified version of the minesweeper game. You can start it as: -$ ./dbg games/mine.l -main -go +$ pil games/mine.l -main -go + It will display a 12-by-12 field with 24 (default) hidden mines. You can move around using the standard 'vi'-keys 'j' (down), 'k' (up), 'l' (right) and 'h' @@ -38,7 +41,7 @@ their underlying principles and strategies). Start 'nim' as -$ ./dbg games/nim.l +$ pil games/nim.l + and then find the optimal move path for, let's say, three heaps of four matches each: @@ -54,7 +57,7 @@ from heap 3). To play Tic-Tac-Toe, enter -$ ./dbg games/ttt.l -main +$ pil games/ttt.l -main + A three-by-three board is displayed. Enter your moves with the 'go' function: @@ -75,7 +78,7 @@ Your positions are marked with 'T', the computer's with '0'. The 'chess' game is minimalistic (441 lines of code). Nevertheless, it plays some slow - though correct - chess. Start it as: -$ ./dbg games/chess.l -main +$ pil games/chess.l -main + +---+---+---+---+---+---+---+---+ 8 |<R>|<N>|<B>|<Q>|<K>|<B>|<N>|<R>| +---+---+---+---+---+---+---+---+ @@ -103,10 +106,6 @@ Alternatively, you can also run it through XBoard (in the X Window System): $ xboard -fcp games/xchess -This requires the symbolic links in "/usr/lib/" and "/usr/bin/", as recommended -in INSTALL. If this is not an option, please modify the first line ("#!") of -"games/xchess". - Without XBoard, you may enter your moves with the field names (in lower case) for the "from" and "to" positions: @@ -192,7 +191,7 @@ which later can be restored with There is also a plain 'sudoku' solver: -$ ./dbg games/sudoku.l +$ pil games/sudoku.l + : (main (quote