NAME¶
ecppc - compiler for ecpp
SYNOPSIS¶
ecppc [
-bhszvtM] [
-s-] [
-o filename]
[
-n name] [
-m mimetype] [
--mimetypes
filename] [
-I dir] [
-l log-category]
filename
ecppc -bb filename...
DESCRIPTION¶
Ecppc is the compiler for the ecpp-language.
Ecpp is a
template-language, which lets the user embed C++-code into HTML for use in
tntnet (8).
Ecppc generates a C++-class from a ecpp-template. It
can also compile binary data into a C++-class, which makes it possible to
integrate them in a tntnet-application.
OPTIONS¶
- -b
- This enables binary-mode. Ecppc does not look for
ecpp-tags, but creates a class, which just copies the data
- -bb
- This enables multi-binary-mode. Every binary-file has some
overhead, when packed into a tntnet-application. This overhead can be
quite significant, when binary-files are small, like small icons in a web
application. To reduce this overhead, multiple binaries can be packed into
a single class, which removes the per-binary overhead completely.
When the component is called, it uses the path-info-parameter (
request.getPathInfo()) from the request, to decide, which binary to
send. If no filename matches the path-info, processing is declined. The
binaries need not be of same mime-type, since the mime-type is looked
automatically from the mime-database by file-extension of the
source-file.
- -I dir
- Search include-files in directory. This option can be
passed multiple times. All specified directories are searched in turn for
include-files.
- -l log-category
- Set log category. Default is
"component.componentname".
- -L
- Disable generation of #line-directives
- -m mimetype
- Set mimetype of output. This is the mimetype, sent by the
component to the browser in the Content-Type-header. Without this
parameter the mimetype is looked up from the mime-database of your system
using the file-extension of the source-file.
- --mimetypes file
- Read mimetypes from file (default: /etc/mime.types).
- -M
- This disables normal processing and prints just the
ecpp-dependencies from this component. The output can be included into a
Makefile. Ecpp-dependencies are introduces by the
<%include>-tag.
- -n name
- Set the name of the component. Normally this is derived
from the source-file-name by removing the path and .ecpp-extension.
- -o filename
- Write the generated file to the specified file instead of
deriving the filename from the source-file-name. The outputfilename is
normally the source-file where the extension is replaced by
.cpp.
- -p
- Keep path name when deriving name of component from input
file name.
- -s
- Generate singleton. Normally ecppc decides
automatically, if the template is suitable for a singleton. This option
force ecppc to generate a singleton.
- -s-
- Do not generate a singleton.
- -v
- Enable verbose mode. This prints additional information
about the processing on the standard-output.
- -z
- Compress the data in the component. Compressed data is
automatically decopressed on first use. This reduces the code-size, but
slightly slows down the first call of the component.
AUTHOR¶
This manual page was written by Tommi Mäkitalo <tommi@tntnet.org>.
SEE ALSO¶
tntnet(1),
ecpp(7),
ecppl(1),
ecppll(1).