version 0.73.0
This commit is contained in:
@@ -0,0 +1,176 @@
|
||||
<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>
|
||||
Reference in New Issue
Block a user