NAME

aescm -- preprocess embedded code in documents


SYNOPSIS

aescm [OPTION] ... FILE ...


DESCRIPTION

Aescm is a multilingual filter program to preprocess code chunks in documents. Here multilingual does not mean "many natural languages" but "many computer languages". Chunks between <?TAG and ?> are evaluated and expressions between <?TAG:d and ?> are replaced with their evaluated value, where TAG is a namespace defined in a configuration file. Its default language is Scheme and the namespace is scm.

Aescm in fact converts a document to a program and makes it executed by a backend interpreter. This mechanism allows us to use aescm with most script languages.

OPTIONS

-E, --no-eval
Preprocess files and convert them into a Scheme program.

-e, --eval=EXPR
Evaluate an expression before processing files. You can use this option upto 16 times.

-i, --interp='PROG ARG ...'
Specify the interpreter with its arguments.

-l, --language LANG
Specify the language configuration file. If the file is not in /home/tagga/share/aescm/lang directory, you should specify the full path or a relative path beginning with ..

--help
Print a short help message.

--version
Print version information.

SCRIPT LANGUAGE VARIABLES

escm_input_file
The name of the file which the tool is currently processing. The value is false if the input is stdin.

escm_interpreter
The backend interpreter and its arguments.

escm_version
The name and the version of this program.

ENVIRONMENT VARIABLES

ESCM_DEFAULT
The default interpreter language's namespace.

ESCM_BACKEND
The default backend interpreter and its arguments.

CONFIGURATION FILES

Language configuration files are in /home/tagga/share/aescm/lang directory.

The format of configuration files is described in /home/tagga/share/doc/aescm/gimmick.html.


CAVEATS


CHANGES

Syntax

The experimental version has adopted the XML syntax for a preprocessor as eguile did and eliminated the archaic one with <?, <?= and !>.

File Arguments

As many files as you specified are to be processed. The stable version processes only the first one.

CGI

CGI features have been removed since aescm version 0.30. Instead, you can use aescm.cgi in the sharp-bang line of CGI scripts or as a handler CGI program.


AUTHOR

  Shiro Kawai  -- the original and stable escm
  TAGA Yoshitaka, tagga@tsuda.ac.jp


SEE ALSO

escm 1.1 (http://www.shiro.dreamhost.com/scheme/vault/escm.html), eguile (http://woozle.org/~neale/src/eguile/), brl (http://brl.sourceforge.net/), scsh (http://scsh.sourceforge.net/), guile, gosh,


SourceForge.net Logo