The  files in this directory are part of the cvt2ltx project. Compared
with  the  other  examples,  these  files  are far more complex; their
purpose  is  to  show  a  new programming model. The cvt2ltx converter
package  includes  4 LaTeX  converters (but more are already planned),
each  with  many  options.  Usually  all option related stuff would be
scattered  into  many files; if you modify or add an option, you would
have to modify several places, which is an error-prone business.

In  options.lxx,  all  option  related  stuff  (variable declarations,
C code  for evaluation of an option, command line definitions for VMS,
help  files  and documentation) are tied together into one chapter per
option.  So  all the stuff is in only *one* file; if you modify or add
an option, you have to edit only one place.

All  files  in this directory (except options.lxx and copy.lx) are not
the  original  files;  they  are  shortened  to show just the relevant
parts. 

The following files are generated:

The files *_doc.* are documentation for the UNIX CLI:
 %2l_doc.asc    converter documentation, ASCII version
 %2l_doc.html   converter documentation, HTML version  (base file/frame version)
 %2l_doc1.html  converter documentation, HTML version  (version without frames)
 %2l_doc2.html  converter documentation, HTML version  (text/frame version)
 %2l_docc.html  converter documentation, HTML version  (table of contents/frame version)
 %2l_doci.html  converter documentation, HTML version  (index/frame version)
 %2l_doc.tex    converter documentation, LaTeX version

The files *_vms.* are documentation for the VMS CLI:
 %2l_vms.asc    converter documentation, ASCII version
 %2l_vms.html   converter documentation, HTML version (base file/frame version)
 %2l_vms1.html  converter documentation, HTML version (version without frames)
 %2l_vms2.html  converter documentation, HTML version (text/frame version)
 %2l_vmsc.html  converter documentation, HTML version (table of contents/frame version)
 %2l_vmsi.html  converter documentation, HTML version (index/frame version)
 %2l_vms.tex    converter documentation, LaTeX version

Some more VMS specific files:
 *2ltx.hlp         VMS help files (VMS native interface)
 *2ltx_u.hlp       VMS help files (Unix interface)
 *2ltx_cld.cld     VMS Command line definition file (builtin version)
 cvt2ltx_cld.cld   VMS Command line definition (for system tables, VAX version)
 cvt2ltx_cld.cld_x VMS Command line definition (for system tables, Alpha version)

Last some C files:
 cvt2ltx.h         Header file with definitions of usage_txt[] and usage_struct[]
 opts.c            C file for option processing


Another complex example is the makefile in the main directory (makefile.lxx);
but this file uses also some (currently undocumented) lxx commands.
