DragonFly On-Line Manual Pages

Search: Section:  

CHTML(1)               DragonFly General Commands Manual              CHTML(1)


NAME

       chtml - compile chunks of html template


SYNOPSIS

       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]


DESCRIPTION

       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.

   COMMAND LINE OPTIONS
       -vFLAG  The 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.

       :undefined=FLAG
               The 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.

       :p=format
               The format defaults to fasl , the standard machine-
               architecture-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
               delineated 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,
               possibly 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)

Search: Section: