NAME

       gen-ctl-io - generate C interface code for libctl control files

SYNOPSIS

       gen-ctl-io [OPTION]... [spec-file]

DESCRIPTION

       gen-ctl-io  generates  C code to import/export the input/output variables used in a libctl
       control file.  gen-ctl-io generates files like ctl-io.h and ctl-io.c.  These files  define
       global  variables, data structures, and functions for the input/output variables, classes,
       and function interfaces defined in the  spec-file  argument,  automating  the  interaction
       between C and Guile.

       The  arguments  such  as  --code and --header are used to control whether ctl-io.c or ctl-
       io.h, etcetera, are generated.  If no argument is specified then both of these  files  are
       generated by default, for backwards compatibility.

       libctl  is  a  free  library  to aid in interfacing scientific software with the GNU Guile
       scripting and extension language.  Documentation for it may be found online at the  libctl
       home page: http://ab-initio.mit.edu/libctl

OPTIONS

       --code Generate  C  (or  C++) source code to implement the Guile interface functions.  The
              default output file name is ctl-io.c (in C) or ctl-io.cpp (in C++).

       --header
              Generate the header file declaring the interface  data  types  and  functions.  The
              default output file name is ctl-io.h (in C) or ctl-io.hpp (in C++).

       --swig Generate  a  SWIG interface definition file declaring automatic conversions for the
              various libctl data types.  The default output file name is ctl-io.i.

       --cxx  Generate C++ code instead of C code.

       -o file
              Use file as the output file name instead of the defaults (above).

BUGS

       Send bug reports to S. G. Johnson, stevenj@alum.mit.edu.

AUTHORS

       Written by Steven G. Johnson.