ecppc - Man Page
compiler for ecpp(7)
Synopsis
ecppc
[-bhszvtM
] [-s-
] [-o
filename] [-n
name] [-m
mimetype] [--mimetypes
filename] [-I
dir] [-l
log-category] filename
ecppc -bb
filename ...
ecppc
[OPTION
]
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 filename
In multi binary mode (option
-bb
) filenames can be read from the file
specified with this option. This can be useful when the command line gets too
long or just for convenience.- -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.- -C, --cmake
Prints ecpp dependencies in a syntax, which
cmake
understands.- -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.- -h, --help
display this information
- -V, --version
display program version
Author
This manual page was written by Tommi Mäkitalo ⟨tommi@tntnet.org⟩.
See Also
Referenced By
ecpp(7), tntnet(8), tntnet-defcomp(1), tntnet.xml(7).