HTCOBOL

       COBOL 85 compiler.


SYNOPSIS

       htcobol [ options ] filename


DESCRIPTION

       A compiler for the COmmon Business Oriented Language, COBOL.  
       
       Htcobol reads from a COBOL source file filename and depending on
       the option, will preprocess, compile, assemble and link to generate 
       an executable binary.

       The compiler generates GNU assembler for the IA32 (x86) platforms.   
       With the aid of the GCC tool set, this intermediate code can then be 
       assembled and linked to create an executable binary.

       A executable binary can be created either directly by the compiler, 
       or by generating intermediate assembler code and using a Makefile 
       for the assemble and link steps.  
       


       The compiler recognizes several command line options as described below.

       You can get a help message by invoking htcobol with the -h option.



INITIALIZATION FILES

       Many compiler options can be set using the resource file
       and/or command line options.
       
       Default resource file name is htcobolrc.

       The precedence of any compiler option is as follows:

         1. Command line options, if available.

         2. Environment variables, if available.

         3. The compile options file, if available.

         4. Compiler default options.


OPTIONS

Compiler specific options:

       -h     Display help.

       -a     Create static library; Preprocess, compile, assemble and archive

       -B     mode Specify binding mode (static/dynamic)

       -c     Compile to a statically linked object module

       -E     Output preprocessor to standard output only. 
              Do not compile, assemble or link.

       -g     Generate compiler debugging output
       
       -l <name>     
              Add library name to link step

       -L <path>
              Add directory to library search path

       -m
              Create shared library; Preprocess, compile, assemble and link

       -n
              Don't actually run any commands; just print them

       -o <file>
              Specify output file name

       -S     Preprocess, compile (generate assembler code) only;
              do not assemble or link

       -t     Doesn't remove the intermediary files(assembly file,
       	      pre-processed COBOL file) generated during the compilation

       -v     Generate verbose compiler output

       -V     Display compiler version information and exit

       -Wl,<options>
              Pass comma-separated options on to the linker

       -x     Compile to an executable module

       -z     Generate very verbose compiler output

COBOL specific options:

       -C     Make all COBOL calls dynamic
       
       -D     Include source debugging lines
       
       -F     Input source is in standard fixed column format

       -I <path>
              Define include (copybooks) search paths.  
              The path may be either a single directory, or a list of 
              directories separated by a `:' (';' on the Win32 platform).
              The default search path is current working directory (-I.).

       -P     Generate output listing file

       -T <num>
              Expand tabs to number of space(s) (default T=8)

       -X     Input source is in free format (default format)


FILES

       htcobolrc - Compile options file.

       htrtconf - Run-time options file.


ENVIRONMENT


       TCOB_OPTIONS_PATH 
            Compile options file directory path.

       TCOBRT_CONFIG_DIR 
            Run-time options file directory path.

       TCOB_LD_LIBRARY_PATH and LD_LIBRARY_PATH
            Dynamically loaded shared libraries search path (excluding Win32).

       PATH
            Win32 (MinGW) dynamically loaded DLL search path.

       TEMP   
            Temporary files directory path.


SEE ALSO

       GCC(1), as(1), ld(1), make(1)




Man(1) output converted with man2html