177 lines
5.1 KiB
HTML
177 lines
5.1 KiB
HTML
<HTML>
|
|
<head>
|
|
<title>TinyCOBOL manual - htcobol (1)</title>
|
|
</head>
|
|
<BODY bgcolor="#ffffff" text="#000000" LINK="#006699" VLINK="#cccccc">
|
|
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
<H2>HTCOBOL</H2><PRE>
|
|
COBOL 85 compiler.
|
|
|
|
|
|
</PRE>
|
|
<H2>SYNOPSIS</H2><PRE>
|
|
<B>htcobol</B> [ <I>options</I> ] <I>filename</I>
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
A compiler for the <B>CO</B>mmon <B>B</B>usiness <B>O</B>riented <B>L</B>anguage, <B>COBOL</B>.
|
|
|
|
<I>Htcobol</I> reads from a COBOL source file <I>filename</I> 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 <B>GCC</B> 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 <I>Makefile</I>
|
|
for the assemble and link steps.
|
|
|
|
<! Note that the usage of a I Makefile/I is recommended as currently the
|
|
compiler front end is incomplete and may produce invalid results.>
|
|
|
|
The compiler recognizes several command line options as described below.
|
|
|
|
You can get a help message by invoking htcobol with the <B>-h</B> option.
|
|
|
|
|
|
|
|
</PRE>
|
|
<H2>INITIALIZATION FILES</H2><PRE>
|
|
Many compiler options can be set using the resource file
|
|
and/or command line options.
|
|
|
|
Default resource file name is <I>htcobolrc</I>.
|
|
|
|
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.
|
|
|
|
|
|
</PRE>
|
|
<H2>OPTIONS</H2><PRE>
|
|
<B>Compiler specific options:</B>
|
|
|
|
<B>-h</B> Display help.
|
|
|
|
<B>-a</B> Create static library; Preprocess, compile, assemble and archive
|
|
|
|
<B>-B</B> mode Specify binding mode (static/dynamic)
|
|
|
|
<B>-c</B> Compile to a statically linked object module
|
|
|
|
<B>-e</B> <name>
|
|
Specify entry point name (first program to execute)
|
|
|
|
<B>-E</B> Output preprocessor to standard output only.
|
|
Do not compile, assemble or link.
|
|
|
|
<B>-g</B> Generate compiler debugging output
|
|
|
|
<B>-l</B> <name>
|
|
Add library name to link step
|
|
|
|
<B>-L</B> <path>
|
|
Add directory to library search path
|
|
|
|
<B>-m</B>
|
|
Create shared library; Preprocess, compile, assemble and link
|
|
|
|
<B>-M</B> <option>
|
|
Specify main entry point option (auto | first | none)
|
|
|
|
<B>-n</B>
|
|
Don't actually run any commands; just print them
|
|
|
|
<B>-o</B> <file>
|
|
Specify output file name
|
|
|
|
<B>-S</B> Preprocess, compile (generate assembler code) only;
|
|
do not assemble or link
|
|
|
|
<B>-t</B> Doesn't remove the intermediary files(assembly file,
|
|
pre-processed COBOL file) generated during the compilation
|
|
|
|
<B>-v</B> Generate verbose compiler output
|
|
|
|
<B>-V</B> Display compiler version information and exit
|
|
|
|
<B>-Wl,</B><options>
|
|
Pass comma-separated options on to the linker
|
|
|
|
<B>-x</B> Compile to an executable module
|
|
|
|
<B>-z</B> Generate very verbose compiler output
|
|
|
|
<B>COBOL specific options:</B>
|
|
|
|
<B>-C</B> Make all COBOL calls dynamic
|
|
|
|
<B>-D</B> Include source debugging lines
|
|
|
|
<B>-F</B> Input source is in standard fixed column format
|
|
|
|
<B>-I</B> <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.).
|
|
|
|
<B>-P</B> Generate output listing file
|
|
|
|
<B>-T</B> <num>
|
|
Expand tabs to number of space(s) (default T=8)
|
|
|
|
<B>-X</B> Input source is in free format (default format)
|
|
|
|
|
|
</PRE>
|
|
<H2>FILES</H2><PRE>
|
|
<I>htcobolrc</I> - Compile options file.
|
|
|
|
<I>htrtconf</I> - Run-time options file.
|
|
|
|
|
|
</PRE>
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
|
|
<B>TCOB_OPTIONS_PATH</B>
|
|
Compile options file directory path.
|
|
|
|
<B>TCOBRT_CONFIG_DIR</B>
|
|
Run-time options file directory path.
|
|
|
|
<B>TCOB_LD_LIBRARY_PATH</B> and <B>LD_LIBRARY_PATH</B>
|
|
Dynamically loaded shared libraries search path (excluding Win32).
|
|
|
|
<B>PATH</B>
|
|
Win32 (MinGW) dynamically loaded DLL search path.
|
|
|
|
<B>TEMP</B>
|
|
Temporary files directory path.
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<B>GCC(1)</B>, <B>as(1)</B>, <B>ld(1)</B>, <B>make(1)</B>
|
|
|
|
|
|
|
|
</PRE>
|
|
<HR>
|
|
<ADDRESS>
|
|
Man(1) output converted with
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
</ADDRESS>
|
|
</BODY>
|
|
</HTML>
|