This file explains how to compile wcd for DOS and Windows with internationalization support.

For Unix compile instructions see file INSTALL.unix.intl.txt

For how to install the program see files INSTALL.dos_windows.intl.txt.


Prerequisites
=============

* gcc      : GNU C compiler
* make     : GNU make
* install  : copy files and set their attributes.
* gettext  : Framework to help GNU packages produce multi-lingual messages.
* libiconv : Character set conversion library.

DOS/Windows
* pdcurses : CRT screen handling and optimization package

Cygwin
* ncurses  : CRT screen handling and optimization package


gcc
===

dos     : DJGPP  : http://www.delorie.com/djgpp/
windows : MINGW  : http://www.mingw.org/
windows : CYGWIN : http://cygwin.com/


make, install, gettext and libiconv
===================================

make, install, gettext and libiconv can be found as packages on the web site of
the gcc compiler.
`install' is part of the `coreutils' package.

DJGPP  : http://www.delorie.com/pub/djgpp/current/v2gnu/
MINGW  : http://sourceforge.net/project/showfiles.php?group_id=2435
CYGWIN : download via the installer program setup.exe.


MINGW, make and sh
If you use the mingw compiler and make, make will try by default to use the
shell `sh.exe' if it is available. Things may not work as expected if you
don't have a proper shell installed.
Instead of installing MINGW MSYS you can also install the native zsh for windows:

http://www.xs4all.nl/~waterlan/zsh-3.0.5-nt-beta-0.75.zip

Copy `zsh.exe' as `sh.exe' somewhere in PATH.


PDCurses
========

To build wcd with PDCurses interface you need to have the PDCurses
library installed. Get PDCurses at http://sourceforge.net/projects/pdcurses/
Compile it and copy the library file into the \lib directory of your
compiler and the curses.h file in the \include directory.

To get support for the original console colours for the windows 32 bit
version you need PDCurses 2.7 or higher.

I reported the following bug on http://sourceforge.net/projects/pdcurses/
*  Bug 1144353: Scroll out of window when screen buffer is large (Windows)
This bug is solved in PDCurses 2.7.


Basic Installation
==================

dos32bit : DOS 32 bit
dos_bash : DOS 32 bit for BASH
win32    : Windows 32 bit console version.
win32zsh : Windows 32 bit zsh version.
cygwin   : Cygwin version.

Change to the appropriate directory `dos32bit', `dos_bash', `win32',
`win32zsh' or `cygwin'.


Build wcd:

  Type `make' to compile the package.

Install wcd:

  Type `make install' to install the package.

  `make install' will also compile the package if it wasn't done yet.

To start clean:

  Type `make clean'



Installation Names
==================

By default `make install' will install the program in /usr/local/bin, the
language files in /usr/local/share/locale and the man file in
/usr/local/share/man. You can specify an installation prefix other than
`/usr/local' by giving `make' the option `PREFIX=PATH'.


Example:

  make clean
  make install PREFIX=/home/waterlan


dos32bit : The default PREFIX is c:/djgpp
dos_bash : The default PREFIX is c:/djgpp
win32    : The default PREFIX is c:/usr/local
win32zsh : The default PREFIX is c:/usr/local
cygwin   : The default PREFIX is /usr


zip package
===========

After installation a zip file can be created that contains
a ready-to-run wcd package.

  Type `make zippackage' to create the .zip file.



tar.gz package
==============

After installation a tar gzip file can be created that contains
a ready-to-run wcd package.

  Type `make tgzpackage' to create the .tar.gz file.

