Kawa

Kawa evaluates expr, which contains one or more Scheme expressions. Does not cause the ~/.kawarc.scm init file to be run.

Same as ‘-e expr’, except that it does cause the ~/.kawarc.scm init file to be run.

Kawa reads and evaluates expressions from the file named by filename-or-url. If the latter is ‘-’, standard input is read (with no prompting). Otherwise, it is equivalent to evaluating ‘(load "filename-or-url")’. The filename-or-url is interpreted as a URL if it is absolute - it starts with a "URI scheme" like http:.

The global variable ‘command-line-arguments’ is set to the remaining arguments (if any), and an interactive read-eval-print loop is started. This uses the same "console" as where you started up Kawa; use ‘-w’ to get a new window.

The global variable ‘command-line-arguments’ is set to the remaining arguments (if any). Kawa reads and evaluates expressions from the file named by filename-or-url. If script is followed by an integer N, then N lines are skipped first.

Skipping some initial lines is useful if you want to have a non-Kawa preamble before the actual Kawa code. One use for this is for Kawa shell scripts (see Running Command Scripts).

Creates a new top-level window, and runs an interactive read-eval-print in the new window. See Running a Command Interpreter in a new Window. Same as -e (scheme-window #t). You can specify multiple ‘-w’ options, and also use ‘-s’.

Prints out some help.

Prints out the Kawa version number, and then exits.

Start a server listening from connections on the specified portnum. Each connection using the Telnet protocol causes a new read-eval-print-loop to started. This option allows you to connect using any Telnet client program to a remote "Kawa server".

Set the default language to Scheme. (This is the default unless you select another language, or you name a file with a known extension on the command-line.)

Set the default language to Emacs Lisp. (The implementation is quite incomplete.)

Set the default language to CommonLisp. (The implementation is very incomplete.)

Set the default language to KRL. See the section called “KRL - The Kawa Report Language for generating XML/HTML”.

Set the default language to KRL, in BRL-compatibility mode. See the section called “KRL - The Kawa Report Language for generating XML/HTML”.

Set the default language to the draft XML Query language. See the Kawa-XQuery page for more information.

Set the default language to XSLT (XML Stylesheet Language Transformations). (The implementation is very incomplete.) See the Kawa-XSLT page for more information.

Try to follow the approprate language specification to the letter, even in corner cases, and even if it means giving up some Kawa convenience features. This flags so far only affects the XQuery parser, but that will hopefully change.

Set the global variable with the specified name to the given value. The type of the value is currently unspecified; the plan is for it to be like XQuery's untyped atomic which can be coerced as needed.

Set the global variable with the specified namespace uri and namespace-local name to the given value.

Change the default output format to that specified by format. See Named output formats for more information and a list.

The number base (radix) to use by default when printing rational numbers. Must be an integer between 2 and 36, and the default is of course 10. For example the option out:base=16 produces hexadecimal output. Equivalent to setting the *print-base* variable.

If true, prints an indicator of the radix used when printing rational numbers. The default is no. Equivalent to setting the *print-radix* variable.

If out:doctype-system is specified then a DOCTYPE declaration is written before writing a top-level XML element, using the specified system-identifier.

Ignored unless out:doctype-system is also specified, in which case the public-identifier is written as the public identifiers of the DOCTYPE declaration.

Controls whether extra line breaks and indentation are added when printing XML. If kind is always or yes then newlines and appropriate indentation are added before and after each element. If kind is pretty then the pretty-printer is used to only add new lines when an element otherwise won't fit on a single line. If kind is no (the default) then no extra line breaks or indentation are added.

Specifies the maximum number of number of columns in a line when the pretty-printer decides where to break a line. (The two options are equivalent.)

Use a calling convention that supports proper tail recursion.

Use a calling convention that does not support proper tail recursion. Self-tail-recursion (i.e. a recursive call to the current function) is still implemented correctly, assuming that the called function is known at compile time.

Disable inlining of known functions and methods. The generated code runs slower, but you can more reliably trace procedures. Normally Kawa will assume that a procedure fn declared using a (define (fn args) body) form is constant, assuming it isn't modified in the current module. However, it is possible some other module might modify the binding of fn. You can use the --no-inline to disable the assumption that fn is constant.

Normally, when Kawa loads a soyrce file, or evaluates a non-trivial expression, it generates new internal Java classes but does not write them out. This option asks it to write out generated classes in a ‘.zip’ archive whose name has the prefix ‘kawa-zip-dump-’.

Kawa translates source language forms into an internal Expression data structure. This option causes that data structure to be written out in a readable format to the standard output.

Similar to the previous option, but prints out the Expression after various transformations and optimizations have been done, and just before code generation.

Prints a stack trace with any error found during compilation.

Prints a stack trace with any warning found during compilation.