CHTML(1)CHTML(1)NAMEchtml - compile chunks of html template
SYNOPSISchtml input-filename [:o=output-filename] [-vFLAG] [:undefined=FLAG]
[:p=format] [:sym=name] [:const=const] [:action=parse] [link-object-
files] [:objectify=some] [:c-template=chtml-cmp.c]
DESCRIPTIONchtml parses input-filename, searching for chtml declaration comments.
The resulting file can be loaded by C programs for output in web appli‐
cations.
The output-filename defaults to input-filename-bin.
COMMAND LINE OPTIONS
-vFLAG The FLAG can be 2 to get more verbose output such as line num‐
ber of begining and ending of chtml object sections and final
interface specification parsed. Flag defaults to 01, only
errors are printed.
:undefined=FLAG
The FLAG can be error (the default) or warn or silent, control‐
ling the behavior of the compiler if a BEGIN object name is not
found in the interface file.
:p=format
The format defaults to fasl , the standard machine-architec‐
ture-specific fast-loading format. Other possible values are
faslc , a more compact fasl format not handled by the current C
loader. read which is human readable and portable, but not
handled very well by any of the loaders currently (it is useful
for debugging), c which is suitable for compiling with cc or
gcc, and none which suppresses output.
:sym=name
The name of the external symbol for the procedure defined by C
language code generated by the :p=c output format. Defaults to
the name of the output file with special characters replaced by
underscores.
:const=qualifier
The qualifier defaults to const, the string to output as a type
modifier in order to get constant (read-only) structures.
:action=type
The type defaults to parse, which causes the input file to be
parsed. However, if the action is link then the input file and
any additional link object files specified should have been
previously produced by the chtml compiler in either :p=fasl
(the default) or :p=read mode.
When run as a linker any external name <B>X</B> found in the
first input file is replaced by the first object named <B>X</B>
found in the link object files. Recall that an object is a
sequence of text strings and/or other objects in a file delin‐
eated by a begin-object/end-object pair.
:objectify=what
The what defaults to some, which treats only BEGIN-OBJECT
regions as objects during the link phase. But if specified as
all then repeating object sections are also considered to be
object definitions.
:c-template=filename
The filename defaults to chtml-cmp.c-bin, which is a template C
program. However, you can substitute another template, possi‐
bly in a different programming language.
WEBDOC
http://people.delphi.com/gjc/chtml.html
SEE ALSO
/usr/local/include/chtml.h include file for using the binary loader.
/usr/local/lib/libchtml.a library.
The web documentation details the procedure names and arguments.
AUTHOR
GJC@DELPHI.COM
LOCAL CHTML(1)
