Table of Contents

• The Kawa Scheme language
• 1. Getting and installing Kawa
  • 1.1. Getting Kawa
    • 1.1.1. Getting the development sources using SVN
  • 1.2. Getting and running Java
  • 1.3. Installing and using the binary distribution
  • 1.4. Installing and using the source distribution
    • 1.4.1. Build Kawa using configure and make
    • 1.4.2. Build Kawa using ant
    • 1.4.3. Compiling Kawa to native code with GCJ
    • 1.4.4. Building Kawa under MS-Windows
• 2. Features
  • 2.1. Implemented SRFIs
  • 2.2. Compatibility with standards
• 3. Documentation
  • 3.1. Usage Reference
    • 3.1.1. Command-line arguments
      • 3.1.1.1. General options
      • 3.1.1.2. Options for language selection
      • 3.1.1.3. Options for warnings and errors
      • 3.1.1.4. Options for setting variables
      • 3.1.1.5. Options for controlling output formatting
      • 3.1.1.6. Options for compiling and optimizing
      • 3.1.1.7. Options for debugging
      • 3.1.1.8. Options for web servers
      • 3.1.1.9. Options for the JVM
    • 3.1.2. Running Command Scripts
      • 3.1.2.1. Setting kawa options in the script
      • 3.1.2.2. Other ways to pass options using meta-arg or –script
      • 3.1.2.3. Scripts for compiled code
    • 3.1.3. Running a Command Interpreter in a new Window
    • 3.1.4. Exiting Kawa
    • 3.1.5. Compiling
      • 3.1.5.1. Compiling to a set of .class files
      • 3.1.5.2. Compiling to an archive file
      • 3.1.5.3. Compiling using Ant
      • 3.1.5.4. Compiling to a standalone application
      • 3.1.5.5. Compiling to an applet
      • 3.1.5.6. Compiling to a native executable
  • 3.2. Syntax
    • 3.2.1. Notation
    • 3.2.2. Lexical and datum syntax
    • 3.2.3. Lexical syntax
      • 3.2.3.1. Formal account
      • 3.2.3.2. Line endings
      • 3.2.3.3. Whitespace and comments
      • 3.2.3.4. Identifiers
      • 3.2.3.5. Numbers
    • 3.2.4. Datum syntax
      • 3.2.4.1. Datum labels
      • 3.2.4.2. Abbreviations
    • 3.2.5. Hash-prefixed forms
    • 3.2.6. Primitive expression syntax
      • 3.2.6.1. Literal expressions
      • 3.2.6.2. Variable references
      • 3.2.6.3. Procedure calls
    • 3.2.7. Property access using colon notation
      • 3.2.7.1. Part lookup rules
      • 3.2.7.2. Specific cases
      • 3.2.7.3. Type literal
      • 3.2.7.4. Type cast
      • 3.2.7.5. Type test
      • 3.2.7.6. New object construction
      • 3.2.7.7. Invoking methods
      • 3.2.7.8. Accessing fields
      • 3.2.7.9. Getting array length
    • 3.2.8. Bodies
    • 3.2.9. Syntax and conditional compilation
    • 3.2.10. Macros
      • 3.2.10.1. Identifier predicates
      • 3.2.10.2. Syntax-object and datum conversions
      • 3.2.10.3. Convenience forms
    • 3.2.11. Named quasi-literals
  • 3.3. Program structure
    • 3.3.1. Boolean values
    • 3.3.2. Conditionals
    • 3.3.3. Definitions
    • 3.3.4. Local binding constructs
    • 3.3.5. Lazy evaluation
      • 3.3.5.1. Delayed evaluation
      • 3.3.5.2. Implicit forcing
      • 3.3.5.3. Blank promises
      • 3.3.5.4. Lazy and eager types
    • 3.3.6. Threads
    • 3.3.7. Exception handling
      • 3.3.7.1. Simple error objects
      • 3.3.7.2. Named exceptions
      • 3.3.7.3. Native exception handling
  • 3.4. Multiple values
  • 3.5. Symbols and namespaces
    • 3.5.1. Simple symbols
    • 3.5.2. Namespaces and compound symbols
      • 3.5.2.1. Namespace objects
      • 3.5.2.2. Compound symbols
      • 3.5.2.3. Namespace aliases
    • 3.5.3. Keywords
    • 3.5.4. Special named constants
  • 3.6. Procedures
    • 3.6.1. Procedure properties
    • 3.6.2. Generic (dynamically overloaded) procedures
    • 3.6.3. Extended Formal Arguments List
  • 3.7. Numbers
    • 3.7.1. Arithmetic operations
    • 3.7.2. Quantities and Units
    • 3.7.3. Logical Number Operations
      • 3.7.3.1. SRFI-60 Logical Number Operations
      • 3.7.3.2. Deprecated Logical Number Operations
    • 3.7.4. Performance of numeric operations
  • 3.8. Characters and text
    • 3.8.1. Characters
    • 3.8.2. Character sets
    • 3.8.3. Strings
      • 3.8.3.1. Basic string procedures
      • 3.8.3.2. String Comparisons
      • 3.8.3.3. String Conversions
      • 3.8.3.4. String Cursor API
    • 3.8.4. String literals
      • 3.8.4.1. Simple string literals
      • 3.8.4.2. String templates
      • 3.8.4.3. Special characters
      • 3.8.4.4. Multiline string literals
      • 3.8.4.5. Embedded expressions
      • 3.8.4.6. Formatting
    • 3.8.5. Unicode character classes and conversions
      • 3.8.5.1. Characters
      • 3.8.5.2. Deprecated in-place case modification
    • 3.8.6. Regular expressions
      • 3.8.6.1. Java regular expressions
      • 3.8.6.2. Portable Scheme regular expressions
  • 3.9. Data structures
    • 3.9.1. Sequences
    • 3.9.2. Lists
      • 3.9.2.1. SRFI-1 list library
    • 3.9.3. Vectors
    • 3.9.4. Uniform vectors
      • 3.9.4.1. Relationship with Java arrays
    • 3.9.5. Bytevectors
    • 3.9.6. Streams - lazy lists
    • 3.9.7. Multi-dimensional Arrays
    • 3.9.8. Hash tables
      • 3.9.8.1. R6RS hash tables
      • 3.9.8.2. Procedures
      • 3.9.8.3. Inspection
      • 3.9.8.4. Hash functions
      • 3.9.8.5. SRFI-69 hash tables
      • 3.9.8.6. Type constructors and predicate
      • 3.9.8.7. Reflective queries
      • 3.9.8.8. Dealing with single elements
      • 3.9.8.9. Dealing with the whole contents
      • 3.9.8.10. Hash functions
  • 3.10. Eval and Environments
    • 3.10.1. Locations
    • 3.10.2. Parameter objects
  • 3.11. Debugging
  • 3.12. Input, output, files
    • 3.12.1. Named output formats
    • 3.12.2. Paths - file name, URLs, and URIs
      • 3.12.2.1. Extracting Path components
    • 3.12.3. Resources
    • 3.12.4. File System Interface
    • 3.12.5. Ports
      • 3.12.5.1. String and bytevector ports
      • 3.12.5.2. Input
      • 3.12.5.3. Output
      • 3.12.5.4. Line numbers and other input port properties
      • 3.12.5.5. Miscellaeous
    • 3.12.6. Formatted Output (Common-Lisp-style)
      • 3.12.6.1. Implemented CL Format Control Directives
      • 3.12.6.2. Formatting Integers
      • 3.12.6.3. Formatting real numbers
      • 3.12.6.4. Miscellaneous formatting operators
      • 3.12.6.5. Unimplemented CL Format Control Directives
      • 3.12.6.6. Extended, Replaced and Additional Control Directives
  • 3.13. Types
    • 3.13.1. Standard Types
    • 3.13.2. Parameterized Types
    • 3.13.3. Type tests and conversions
  • 3.14. Object, Classes and Modules
    • 3.14.1. Defining new classes
      • 3.14.1.1. General class properties
      • 3.14.1.2. Declaring fields
      • 3.14.1.3. Declaring methods
      • 3.14.1.4. Example
      • 3.14.1.5. Synchronized methods
    • 3.14.2. Anonymous classes
      • 3.14.2.1. Lambda as shorthand for anonymous class
    • 3.14.3. Enumeration types
    • 3.14.4. Annotations of declarations
    • 3.14.5. Modules and how they are compiled to classes
      • 3.14.5.1. Name visibility
      • 3.14.5.2. How a module becomes a class
      • 3.14.5.3. Static vs non-static modules
      • 3.14.5.4. Module options
      • 3.14.5.5. Requiring (importing) a module
    • 3.14.6. Record types
    • 3.14.7. Creating New Record Types On-the-fly
    • 3.14.8. Calling Java methods from Scheme
      • 3.14.8.1. Calling static methods using colon notation
      • 3.14.8.2. Calling instance methods using colon notation
      • 3.14.8.3. Method names
      • 3.14.8.4. Invoking a method with the invoke function
      • 3.14.8.5. Using a namespace prefix
    • 3.14.9. Allocating objects
    • 3.14.10. Accessing object fields
      • 3.14.10.1. Accessing static fields and properties
      • 3.14.10.2. Accessing instance fields and properties
      • 3.14.10.3. Using field and static-field methods
      • 3.14.10.4. Older colon-dot notation
    • 3.14.11. Mapping Scheme names to Java names
    • 3.14.12. Scheme types in Java
    • 3.14.13. Using Java Arrays
      • 3.14.13.1. Creating new Java arrays
      • 3.14.13.2. Accessing Java array elements
      • 3.14.13.3. Old low-level array macros
    • 3.14.14. Loading Java functions into Scheme
    • 3.14.15. Evaluating Scheme expressions from Java
      • 3.14.15.1. Using javax.script portable Java scripting
  • 3.15. Working with XML and HTML
    • 3.15.1. Formatting XML
    • 3.15.2. Creating HTML nodes
    • 3.15.3. Creating XML nodes
    • 3.15.4. XML literals
      • 3.15.4.1. Element constructors
      • 3.15.4.2. Elements contents (children)
      • 3.15.4.3. Attributes
      • 3.15.4.4. QNames and namespaces
      • 3.15.4.5. Other XML types
      • 3.15.4.6. Processing instructions
      • 3.15.4.7. XML comments
      • 3.15.4.8. CDATA sections
    • 3.15.5. Web page scripts
    • 3.15.6. Self-configuring web page scripts
      • 3.15.6.1. Using the OpenJDK built-in web server
      • 3.15.6.2. Using a servlet container
      • 3.15.6.3. Finding a matching script
      • 3.15.6.4. Determining script language
      • 3.15.6.5. Compilation and caching
    • 3.15.7. Installing web page scripts as Servlets
      • 3.15.7.1. Creating a web application
      • 3.15.7.2. Compiling a web page script to a servlet
      • 3.15.7.3. Installing a servlet under Tomcat
      • 3.15.7.4. Installing a servlet under Glassfish
      • 3.15.7.5. Servlet-specific script functions
    • 3.15.8. Installing Kawa programs as CGI scripts
    • 3.15.9. Functions for accessing HTTP requests
      • 3.15.9.1. Request URL components
      • 3.15.9.2. Request parameters
      • 3.15.9.3. Request headers
      • 3.15.9.4. Request body
      • 3.15.9.5. Request IP addresses and ports
      • 3.15.9.6. Miscellaneous request properties
    • 3.15.10. Generating HTTP responses
    • 3.15.11. Using non-Scheme languages for XML/HTML
      • 3.15.11.1. XQuery language
      • 3.15.11.2. XSL transformations
      • 3.15.11.3. KRL - The Kawa Report Language for generating XML/HTML
      • 3.15.11.4. Differences between KRL and BRL
  • 3.16. Miscellaneous topics
    • 3.16.1. Building JavaFX applications
      • 3.16.1.1. Using JavaFX with JDK 7
    • 3.16.2. Building for Android
      • 3.16.2.1. Downloading and setting up the Android SDK
      • 3.16.2.2. Building Kawa for Android
      • 3.16.2.3. Creating the application
      • 3.16.2.4. Running the application on the Android emulator
      • 3.16.2.5. Running the application on your device
      • 3.16.2.6. Some debugging notes
      • 3.16.2.7. Other resources
    • 3.16.3. Android view construction
      • 3.16.3.1. View object allocation
      • 3.16.3.2. Event handlers
    • 3.16.4. System inquiry
    • 3.16.5. Processes
    • 3.16.6. Time-related functions
    • 3.16.7. Deprecated low-level functions
      • 3.16.7.1. Low-level Method invocation
      • 3.16.7.2. Low-level field operations
      • 3.16.7.3. Old low-level array macros
• 4. Development
  • 4.1. Reporting bugs
  • 4.2. Ideas and tasks for contributing to Kawa
    • 4.2.1. Compiler should use class-file reading instead of reflection
    • 4.2.2. Mutually dependent Java and Scheme modules
    • 4.2.3. Make use of Java-7 MethodHandles
    • 4.2.4. R6RS and R7RS libraries and syntax
    • 4.2.5. Optimize switches (case)
    • 4.2.6. Parameterized types
    • 4.2.7. Function types
    • 4.2.8. Full continuations
    • 4.2.9. Faster tailcalls
    • 4.2.10. TreeList-optimization
    • 4.2.11. Asynchronous evaluation
    • 4.2.12. REPL console and other REPL improvement
    • 4.2.13. XQuery-1.1-functionality
    • 4.2.14. XQuery-updates
    • 4.2.15. Common Lisp support
    • 4.2.16. JEmacs improvements
    • 4.2.17. Improved IDE integration
      • 4.2.17.1. Plugin for NetBeans IDE
      • 4.2.17.2. Plugin for Eclipse IDE
      • 4.2.17.3. Improve Emacs integration
      • 4.2.17.4. Implement javax.tools and code-range support in Kawa compiler
    • 4.2.18. Output formatting and pretty printing
    • 4.2.19. Hop-style web programming
    • 4.2.20. Quaternions
    • 4.2.21. String localization
    • 4.2.22. Data binding
    • 4.2.23. Better dynamic reload
  • 4.3. The Kawa language framework
• 5. The Kawa Community
  • 5.1. General Kawa email and discussion
  • 5.2. Acknowledgements and thanks
  • 5.3. Technical Support
  • 5.4. Projects using Kawa
• 6. About
  • 6.1. Frequently Asked Questions
  • 6.2. License
    • 6.2.1. License for the Kawa software
    • 6.2.2. License for the Kawa manual
• Index
  • Index