Table of Contents

The Kawa Scheme system, by Per Bothner
1. Features
2. Getting Kawa
3. Building and installing Kawa

3.1 Getting and running Java
3.2 Installing and using the binary distribution
3.3 Installing and using the source distribution

3.3.1 Build Kawa using configure and make
3.3.2 Build Kawa using ant
3.3.3 Using the Jikes compiler
3.3.4 Compiling Kawa to native code with GCJ
3.3.5 Building Kawa under Windows

4. How to start up and run Kawa

4.1 Command-line arguments
4.2 Running a Command Interpreter in a new Window
4.3 Exiting Kawa

5. Features of R5RS not implemented
6. Compiling Scheme code to byte-code or an executable

6.1 Compiling Scheme to an archive file
6.2 Compiling Scheme to a set of .class files
6.3 Compiling Scheme to a standalone application
6.4 Compiling Scheme to an applet
6.5 Compiling Scheme to a native executable

7. Extensions

7.1 Multiple values
7.2 Special named constants
7.3 Keywords
7.4 Procedures

7.4.1 Procedure properties
7.4.2 Generic (dynamically overloaded) procedures
7.4.3 Extended Formal Arguments List

7.5 Quantities
7.6 Logical Number Operations
7.7 Strings
7.8 Uniform vectors
7.9 File System Interface
7.10 Ports
7.11 Formatted Output (Common-Lisp-style)

7.11.1 Implemented CL Format Control Directives
7.11.2 Formatting Integers
7.11.3 Formatting floating-point (real) numbers
7.11.4 Miscellaneous formatting operators
7.11.5 Not Implemented CL Format Control Directives

7.11.5.1 Extended, Replaced and Additional Control Directives

7.12 Signalling and recovering from exceptions
7.13 Locations
7.14 Eval and Environments
7.15 Debugging
7.16 Threads
7.17 Processes
7.18 Miscellaneous

8. Types

8.1 Standard Types
8.2 Declaring Types of Variables

9. Object, Classes and Modules

9.1 Records
9.2 Mapping Scheme names to Java names
9.3 Allocating objects
9.4 Calling Java methods from Scheme
9.5 Accessing fields of Java objects
9.6 Defining new classes
9.7 Anonymous classes
9.8 Modules and how they are compiled to classes

9.8.1 Name visibility
9.8.2 Definitions
9.8.3 How a module becomes a class
9.8.4 Requiring (importing) a module

10. The Scheme-Java interface

10.1 Scheme types in Java
10.2 Low-level Operations on Java Arrays
10.3 Low-level Method invocation
10.4 Low-level Operations on Object Fields
10.5 Loading a ModuleBody
10.6 Evaluating Scheme expressions from Java

11. Tools for working with XML and HTML

11.0.1 Scheme functions
11.0.2 Compiling to a Servlet
11.0.3 xquery language

12. Mailing lists
13. Technical Support for Kawa
14. Projects using Kawa
15. License

15.1 License for the Kawa software
15.2 Copyright for this manual

Index