TinyCOBOL Cygwin (POSIX/UN*X emulation layer) edition for Win32

How to install and setup TinyCOBOL Cygwin edition using the binary distribution
-----------------------------------------------------------------------------

To run TinyCOBOL Cygwin edition the following must be installed on your system:
- The Cygwin POSIX emulation layer from Cygnus.
- GCC Cygwin version.
- The Curses library (ncurses) Cygwin version.
  Required by the SCREEN SECTION and some types of DISPLAY statements.
- Berkeley's DB library (version db-1.85.4 or later) Cygwin version. 
  Required for all file I/O.

How to install the TinyCOBOL Cygwin binary:
- Install the binary files using one of the methods below.
  Use the 'setup.exe' program, included with the Cygwin distribution,   
  and select the TinyCOBOL binary to install.
  OR 
  Open a Cygwin command line and install the TinyCOBOL binaries using
  the tar utility.
  Example:
  cd /
  tar -xvzf tinycobol-x.xx-x.cygwin.tar.gz


- Edit the compiler resource file 'htcobolrc'.
  Example (set your paths):
  LD_PATH: -L/usr/lib -L/usr/local/lib 
- Set the TinyCOBOL environment variables.
  Example (DOS or CMD window):
  set TCOB_OPTIONS_PATH=C:\cygwin\usr\local\share\htcobol
  set TCOBRT_CONFIG_DIR=C:\cygwin\usr\local\share\htcobol
  Example (shell resource file):
  export TCOB_OPTIONS_PATH=/usr/local/share/htcobol
  export TCOBRT_CONFIG_DIR=/usr/local/share/htcobol


How to build and install the TinyCOBOL Cygwin edition from the source code
-----------------------------------------------------------------------------
- The Cygwin POSIX emulation layer from Cygnus.
- GCC Cygwin version.
- make (make).
- flex (flex). 
- Bison or Berkeley's YACC (byacc) version 1.9.3.
  Earlier versions of Berkeley's YACC will not work.
- The Curses library (ncurses) Cygwin version.
  Required by the SCREEN SECTION and some types of DISPLAY statements.
- Berkeley's DB library (version db-1.85.4 or later) Cygwin version. 
  Required for all file I/O.

How to configure and compile TinyCOBOL Cygwin edition.
- Extract 'tinycobol-x.xx-x' TAR/GZIP archive.
- Run the configure script 'configure' (1).
- Type 'make' to compile the compiler and run-time (2).

How to install TinyCOBOL Cygwin edition.
- Configure and compile TinyCOBOL Cygwin edition.
- Type 'make install' to install the compiler and run-time.

Example:
 ./configure
 make
 make install

Notes:
1)
 Use these variables to override the choices made by `configure' or to help
 it to find libraries and programs with nonstandard names/locations.
 Some influential environment variables:
  LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
              nonstandard directory <lib dir>
  CPPFLAGS    C/C++ preprocessor flags, e.g. -I<include dir> if you have
              headers in a nonstandard directory <include dir>
2)
 To build shared libraries (DLL) use 'make devel'. 
 Note that this has not been tested for the Cygwin platform
 and will require manual modifications to the make file
 in the 'lib' directory. 


Release notes
-----------------------------------------------------------------------------
To run the TinyCOBOL regression test suite for the Win32 MinGW release 
requires the following to be installed on your system.
- Perl 5.x

Binaries for BDB can be downloaded from the TinyCOBOL(1) page.

The following are not included in binary distribution.
- Regression test suite sources.
- Utility programs binaries. 
- Sample COBOL code sources.

Links
-----------------------------------------------------------------------------
1) TinyCOBOL
http://tiny-cobol.sourceforge.net/download.html