Changeset 35324 in project

Timestamp:

03/22/18 22:08:31 (5 weeks ago)

Author:

felix

Message:

manual: first version of "Getting started"

File:

• wiki/man/5/Getting started (moved) (moved from wiki/man/5/TODO/Getting started) (13 diffs)

wiki/man/5/Getting started

@@ -1 +1 @@
 [[tags: manual]]
-
-XXX
-* R7RS compliance?
-* Do we need to document units here?
-* Update example output
-XXX
 
 == Getting started 
@@ -51 +45 @@
 less ambitious than R6RS and more minimal. 
 
-CHICKEN fully complies with R5RS and mostly with the "R7RS small"
-language. 
+CHICKEN fully complies with R5RS and, by using a separately available
+extension also with the "R7RS small" language. 
 
 Even though Scheme is consciously minimalist, it is recognized that a
@@ -86 +80 @@
 CHICKEN includes 
 
-* a Scheme interpreter that supports almost all of  R7RS Scheme, with
+* a Scheme interpreter that supports all of R5(7)RS Scheme, with
   only a few relatively minor omissions, and with many extensions
 * a compatible compiler whose target is C, thus making porting to new
@@ -246 +240 @@
 
  $ csi
- 
  CHICKEN
- (c) 2008-2016, The CHICKEN Team
- (c) 2000-2007, Felix L. Winkelmann
- Version 4.11.0 (rev ce980c4)
- linux-unix-gnu-x86-64 [ 64bit manyargs dload ptables ]
- compiled 2016-05-28 on yves.more-magic.net (Linux)
- 
+(c) 2008-2018, The CHICKEN Team
+(c) 2000-2007, Felix L. Winkelmann
+Version 5.0.0 (rev 6653dce)
+linux-unix-gnu-x86-64 [ 64bit dload ptables ]
+
  #;1>
 
@@ -305 +297 @@
 
 <enscript highlight=scheme>
-
 ;; irregex, the regular expression library, is one of the
 ;; libraries included with CHICKEN.
@@ -386 +377 @@
 
 <enscript highlight=scheme>
+(import (chicken process-context)) ; for "command-line-arguments"
+
 (define (palindrome? x)
   (define (check left right)
@@ -393 +386 @@
              (check (add1 left) (sub1 right)))))
   (check 0 (sub1 (string-length x))))
+
 (let ((arg (car (command-line-arguments))))
   (display 
@@ -423 +417 @@
 ;;; Library pal-proc.scm
 (declare (unit pal-proc))
+
 (define (palindrome? x)
   (define (check left right)
@@ -438 +433 @@
 ;;; Client pal-user.scm
 (declare (uses pal-proc))
+
+(import (chicken process-context))
+
 (let ((arg (car (command-line-arguments))))
   (display 
@@ -456 +454 @@
  level is a palindrome
 
+The "unit" mechanism is relatively low-level and requires some 
+familiarity with underlying mechanism used to manage compilation
+units. See [[Units and linking model]] for more information.
+
 === Installing an egg
 
@@ -465 +467 @@
 
 In this example, we install the {{uri-common}} egg, for parsing
-Uniform Resource Identifiers. The installation produces a lot of
-output, which we have edited for space.
+Uniform Resource Identifiers. 
 
  $ chicken-install uri-common
  
- retrieving ...
- resolving alias `kitten-technologies' to: http://chicken.kitten-technologies.co.uk/henrietta.cgi
- connecting to host "chicken.kitten-technologies.co.uk", port 80 ...
- requesting "/henrietta.cgi?name=uri-common&mode=default" ...
- reading response ...
- [...]
- /usr/bin/csc -feature compiling-extension -setup-mode    -s -O2 uri-common.scm -j uri-common
- /usr/bin/csc -feature compiling-extension -setup-mode    -s -O2 uri-common.import.scm
- cp -r uri-common.so /usr/lib/chicken/5/uri-common.so
- chmod a+r /usr/lib/chicken/5/uri-common.so
- cp -r uri-common.import.so /usr/lib/chicken/5/uri-common.import.so
- chmod a+r /usr/lib/chicken/5/uri-common.import.so
- chmod a+r /usr/lib/chicken/5/uri-common.setup-info
-
 {{chicken-install}} connects to a mirror of the egg repository and
 retrieves the egg contents.  If the egg has any uninstalled
@@ -493 +480 @@
 
  #;1> (import uri-common)
- ; loading /usr/lib/chicken/5/uri-common.import.so ...
+ ; loading /usr/lib/chicken/9/uri-common.import.so ...
  ; [... other loaded files omitted for clarity ...]
  
@@ -529 +516 @@
 
  ;;; fib-user.scm
+ (import (chicken format))
+
  #>
    extern int fib(int n);