escm(1)

NAME

escm - Embedded Scheme Processor

SYNOPSIS

escm [-Ecv] [-i interpreter] [-o outfile] [-e expr] [infile]

DESCRIPTION

This manual page documents briefly the escm commands.

escm is a filter program which takes a text with embedded Scheme exressions, copies it to the output with evaluating the Scheme expressions. You can use the power of Scheme to preprocess various text files, including CGI scripts.

OPTIONS

-E

Preprocess only. escm emits Scheme expressions which produce, if evaluated, the desirable output.

-c

CGI mode. In CGI mode, when escm encounters an error in preprocessing the input text, it generates an HTML page to report an error message and exit with zero status. Without this option, escm prints out an error message to stderr and exit with non-zero status, which is not desirable for CGI scripts.

-e expr

Pass the specified Scheme expression expr to the Scheme interpreter to be evaluated before processing the input text. You can give multiple -e options, and the expressions are passed in the order. At the time the expressions are evaluated, the preset variables (such as *escm-input-file*, described below) are already set.

-i interpreter

Specify the alternative Scheme interpreter to be used.

-o outfile

The output is written to outfile instead of stdout.

-v

Print escm version and exit.

USAGE

escm reads a text from infile , or stdin if it is not specified, and copies its contents to the outfile , or stdout if it is not specified. If infile contains the following sequences, escm interpretes them.

<? Scheme expressions ... !>

Evaluate Scheme expressions, and replaces this sequence to whatever the expressions prints out to stdout.

<?= Scheme expressions ... !>

Evaluate Scheme expressions, and replaces this sequence to the result of the last expression (using display).

In the scheme expressions, you can use whatever Scheme expressions the interpreter supports. Besides, the following Scheme variables are set for the convenience.

*escm-version*

A string to show the version of escm

*escm-input-file*

Input file name, if the input is specified in the command line; or #f when input is taken from stdin.

*escm-output-file*

Output file name, if the output is specified in the command line; #f otherwise.

The first few lines of the input may be treated specially.

#!

If the first line of the input begins with #! , the line is removed. This makes it easy to use escm for cgi scripts.

#?

After the above operation, if the next line begins with #? , followed by a string, escm takes the string as a Scheme interpreter to use. This choice of interpreter can be overridden by -i command line option. If #? is not followed by a string, the line is simply removed (this feature allows you to generate an output file which begins with either #! or #? ).

No other fancier functions, like parsing CGI form parameters or generating HTTP headers, are provided by escm; it's beyond the scope of this small (a few hundred lines in C) program. Use the libraries of your own Scheme implementations.

The Scheme expressions needs not be complete inside single <?...!>construct. Rather, they can be mixed with the `literal' part of text freely, although the source may become a bit messy. For example, the following source produces either "FOO is true" or "FOO is not true", depends on the result of the evaluation of "(foo)".

<? (if (foo) (begin !>
FOO is true.
<? ) (begin !>
FOO is not true.
<? )) !>

Note that you need begin , since the literal text part may be translated into several Scheme forms by the preprocessor.

You can see more sample code in escm.esc included this package. (In Debian system, the file will be found in /usr/share/doc/escm/examples/)

SEE ALSO

guile(1). mit-scheme(1), scm(1),

AUTHOR

escm was written by Shiro Kawai <[email protected]>.