• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• SCRIPT LANGUAGE VARIABLES
• ENVIRONMENT VARIABLES
• CONFIGURATION FILES
• CAVEATS
• CHANGES
• Syntax
• File Arguments
• CGI
• AUTHOR
• SEE ALSO

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

• Aescm is developers' version of escm. The stable version is still escm 1.1.
  
• Aescm may generate a very long string. Make it sure that your interpreter might not have buffer overflow bugs.
  
• A document written in a multibyte character set may not be correctly processed by an interpreter which may convert character sets.
  

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,