NAME

       ecppc - 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 ...

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.

       -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)