_      _ _
                             /_\  __| (_)_ __  ___
                            / _ \/ _` | | '  \/ -_)
                           /_/ \_\__,_|_|_|_|_\___|

                           Allegro Dialogs Made Easy

                    Installation Notes for Windows/BCC32

                               by Sven Sandberg



==============================================
======== Basic Installation Procedure ========
==============================================

Run the following commands in the DOS shell:

   fix bcc32
   make all BCC32DIR=<bcc32dir>
   make installall BCC32DIR=<bcc32dir>

Here, <bcc32dir> is the directory where you installed BCC32, e.g.,
c:\program\borland\bcc55.

(The first command tells the installation program that you use
BCC32. The second compiles the library, examples and
documentation. The third copies essential files to common
directories.)



======================================
======== Installation Options ========
======================================

The basic installation procedure compiles both the optimized library
(for releasing your program) and the debugging library (for developing
your program). The Borland port provides only static linking at the
moment.

Compiling only the optimized library:
   Run "make" and "make install" instead of "make all" and "make
   installall", respectively.

Compiling only the debugging library:
   Add "DEBUGMODE=1" to the command line. Do it both for "make" and
   for "make install".

Compressing the dll's and exe's:
   To recover some disk space, run
   "make compress UPX_PROGRAM=<program>". Here, <program> is the
   location of upx.exe, e.g., c:\tools\upx.exe. This will use UPX (see
   http://upx.sf.net) to compress the example's executable files and
   the optimized dll. Note that you have to do this before "make
   install" if you want the compressed dll to be copied to the windows
   directory: if Adime's dll already is there, the new one will not be
   copied.



=======================
======== Usage ========
=======================

Including the header files:
   #include <adime.h>

Linking (command line):
   Add adime.lib to the library part of the command line, that is,
   after the third comma.

   Use adimed.lib instead of adime.lib if you want to link with the
   debugging library.

Viewing the documentation:
   Open docs/html/adime.html in your favourite browser, or
   docs/chm/adime.chm in windows help viewer.