tinycobol/Readme.cygwin.txt

99 lines
3.5 KiB
Plaintext

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