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.