.TH CHTML 1 LOCAL 
.SH NAME
chtml \- compile chunks of html template
.SH SYNOPSIS
.B chtml
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]
.SH DESCRIPTION
.I chtml
parses input-filename, searching for chtml declaration comments.
The resulting file can be loaded by C programs for output
in web applications.

The output-filename defaults to input-filename-bin.

.RE
.SS COMMAND LINE OPTIONS
.TP 8
.BI -vFLAG
The
.I FLAG
can be 2 to get more verbose output such as line number of
begining and ending of chtml object sections and final
interface specification parsed. Flag defaults to 01, only
errors are printed.

.TP 8
.BI :undefined=FLAG
The
.I FLAG
can be error (the default) or warn or silent, controlling
the behavior of the compiler if a BEGIN object name
is not found in the interface file.

.TP 8
.BI :p=format
The
.I format
defaults to 
.I fasl
, the standard machine-architecture-specific
fast-loading format. Other possible values are 
.I faslc
, a more compact fasl format not handled by the current C loader.
.I read
which is human readable and portable, but not handled very well
by any of the loaders currently (it is useful for debugging),
.I c
which is suitable for compiling with cc or gcc, and
.I none
which suppresses output.

.TP 8
.BI :sym=name
The 
.I 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.

.TP 8
.BI :const=qualifier
The 
.I qualifier
defaults to const, the string to output as a type modifier
in order to get constant (read-only) structures.


.TP 8
.BI :action=type
The 
.I 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 delineated by
a begin-object/end-object pair.

.TP 8
.BI :objectify=what
The 
.I 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. 

.TP 8
.BI :c-template=filename
The 
.I filename
defaults to chtml-cmp.c-bin, which is a template C program.
However, you can substitute another template, possibly in
a different programming language.

.SH WEBDOC
http://people.delphi.com/gjc/chtml.html
.SH 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.

.SH AUTHOR
GJC\@DELPHI.COM