The Tiny COBOL Project.

Home page:
http://tiny-cobol.sourceforge.net/

Download:
http://tiny-cobol.sourceforge.net/snapshot/
ftp://tiny-cobol.sourceforge.net/pub/tiny-cobol/
http://download.sourceforge.net/tiny-cobol/

Mailing list:
http://lists.sourceforge.net/mailman/listinfo/tiny-cobol-users

Mailing list archives:
http://www.geocrawler.com/lists/3/SourceForge/586/0/

Old mailing list archives:
http://www.egroups.com/group/gnucobol/

-------------------------------------------------------------------------------

Requirements:

GCC tool set (GCC, AS, LD):
This compiler generates GAS compatible assembler code for the i386 Linux platform.
The the final compilation and linkage can be done by GCC, or by htcobol 
using the -x option.

Library db (version db-1.85.4 or later):
This library is used to access indexed files. It is available on Metalab(1),
or at Sleepycat(2).

Note that later versions of libdb, such as 3.0.55, have a compatibility to
version 1.85 option, when configured with '--enable-compat185' (DB 1.85 
compatibility API). 

The current configure script will try to determine which version of library 
db is been used, assuming the library is called libdb.so*, libdb.a.
It does so by checking for the existence of the headers and library, and then
performs the following tests:
- If header db_185.h is found, it does a test compile with libdb, to ensure 
  that the compatibility to version 1.85 option set.
- If header db_185.h is not found, it searches for header db.h.
- If header db.h is found, it does a test to ensure that the header belongs
  to version 1.85 of libdb, and finally it does a test compile, to ensure 
  it is version 1.85 of libdb.

Note that database file formats are incompatible between version 1.85.4 and 2.xx 
and later. Thus indexed files created by a COBOL program using version 1.85.4 of db, 
will not be readable by any COBOL program using later versions of db.
 

1) Metalab (formerly known as Sunsite)
   http://metalab.unc.edu/pub/linux/libs/db
   db-1.85.4-bin-ELF.tar.gz - shared lib of db 1.85.4
   db-1.85.4-src.tar.gz     - full source tree for db 1.85.4

2) Sleepycat Software
   http://www.sleepycat.com/
   versions 2.xx and later(current 3.0.55)
   
ncurses:
The ncurses library is required. Used in screen I/O.

readline:
The realine library version 2 is optional. Set by WANT_READLINE build option.

-------------------------------------------------------------------------------

To build:

./configure --disable-debug
Edit htconfig.h and change if necessary.
make
make install(su access required)

Note that test programs found in test.code directories, can be compiled
and run without installing htcobol.

configure options:
  --prefix=PREFIX         install architecture-independent files in PREFIX
                          [default=/usr/local]
  --disable-debug         disable debugging compiler options
  --with-readline         use readline library 
  --with-dl               use dynamic loader for RTS libraries 

Note:
The '--disable-debug' configure option will disable the compiler trace 
information generated by the compiler, and used to debug the compiler itself.
It will not disable compiler debug option '-D', which adds debugging data to 
the generated binary.
Unless you are planning to debug the compiler itself, or like to look at 
substantial amounts of trace data, it is recommended that the above configure 
option is used.

To clean:
Type make clean to clean lib and compiler.

Type make cleanall to clean lib, compiler, utils, test.code.

Type make cleandist to clean lib and compiler and config.cache config.status 
config.log Makefiles.

Some test programs can be found in test.code directory.

The utils directory contains some utility programs.

cobpp: 
Converts to/from fixed and free-form COBOL formats.


-------------------------------------------------------------------------------

To install(su access required):

Edit directories and filenames htconfig.h, Makefile in compiler directory, and 
Makefile in lib directory to suit. 

Edit the compiler resource file called cobopt found in the compiler directory.

The compiler resource file name can be set in htconfig.h.
This file contains installation specific default information.

As su, in the root directory type make install.
