The Tiny COBOL Project.

Homepage:
http://tiny-cobol.sourceforge.net/

Download:
http://tiny-cobol.sourceforge.net/snapshot/
ftp://tiny-cobol.sourceforge.net/pub/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:
Since this compiler generates GAS compatible assembler code, the final
compilation and linkage is done by GCC.

library db (version db-1.85.4 or later):
This library is used to access indexed files. It is avaiable 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 other 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 rerquired. Used in screen I/O.

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

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

To build:

./configure
Edit htconfig.h and change if neccessary.
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 


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. 

As su, in the root directory type make install.

resource(options) file:
The compiler resource(options) file can be set in htconfig.h.
This file contains installation specific default information.
