How to build PDCurses===================== Unpack the source archive, then go to the appropriate section below, for native console, X11 or SDL. DOS, OS/2, or Windows console----------------------------- . In the subdirectory for each OS, you'll find a number of ".mak" files, one for each supported compiler: DOS: bccdos.mak - Borland C++ 3.0+ gccdos.mak - DJGPP V2 mscdos.mak - Microsoft C wccdos16.mak - Watcom 10.6+ (16-bit) wccdos4g.mak - Watcom 10.6+ (32-bit) OS/2: bccos2.mak - Borland C++ 2.0 gccos2.mak - EMX 0.9b+ iccos2.mak - C Set/2 wccos2.mak - Watcom 10.6+ (32-bit) Windows: bccwin32.mak - Borland C++ 4.0.2+ dmcwin32.mak - Digital Mars gccwin32.mak - Cygnus GNU Compiler lccwin32.mak - LCC-Win32 mingwin32.mak - MinGW vcwin32.mak - Microsoft Visual C++ 2.0+ wccwin32.mak - Watcom 10.6+ . For 16-bit compilers, you can change the memory MODEL in the makefile. (Large model is the default, and recommended.) . Optionally, you can build in a different directory than the platform directory by setting PDCURSES_SRCDIR to point to the directory where you unpacked PDCurses, and changing to your target directory: set PDCURSES_SRCDIR=c:\pdcurses This step is no longer required when building in the platform directory, and won't work with the LCC or Digital Mars makefiles. . Build it: make -f makefilename (For Watcom, use "wmake" instead of "make"; for MSVC or C Set/2, "nmake".) You'll get the libraries (pdcurses.lib or .a, depending on your compiler; and panel.lib or .a), the demos (*.exe), and a lot of object files. Note that the panel library is now (as of 3.2) just a copy of the main library, provided for convenience; both panel and curses functions are in the main library. For Windows (except with LCC or Digital Mars), you can also give the optional parameter "WIDE=Y", to build the library with wide-character (Unicode) support: make -f mingwin32.mak WIDE=Y When built this way, the library is not compatible with Windows 9x, unless you also link with the Microsoft Layer for Unicode (not tested). Another option for Windows, "UTF8=Y", makes PDCurses ignore the system locale, and treat all narrow-character strings as UTF-8. This option has no effect unless WIDE=Y is also set. Use it to get around the poor support for UTF-8 in the Win32 console: make -f mingwin32.mak WIDE=Y UTF8=Y You can also use the optional parameter "DLL=Y" with Visual C++, MinGW, Cygwin or EMX, to build the library as a DLL: nmake -f vcwin32.mak WIDE=Y DLL=Y When you build the library as a Windows DLL, you must always define PDCURSES_DLL_BUILD when linking against it. (Or, if you only want to use the DLL, you could add this definition to your curses.h.) This is not true for OS/2. X11--- . Run "./configure" in the PDCurses-x.x directory. To build the wide-character version of the library, specify "--enable-widec" as a parameter. To use X Input Methods, add "--enable-xim". I recommend these options, but I haven't yet made them the defaults, for the sake of backwards compatibility and due to their new and relatively untested status. If your system is lacking in UTF-8 support, you can force the use of UTF-8 instead of the system locale via "--enable-force-utf8". This is generally more useful in Windows. If configure can't find your X include files or X libraries, you can specify the paths with the arguments "--x-includes=inc_path" and/or "--x-libraries=lib_path". By default, the library and demo programs are built with the optimizer switch -O2. You can turn this off, and turn on debugging (-g), by adding "--with-debug" to the configure command. . Run "make". This should build libXCurses and all the demo programs. . Optionally, run "make install". curses.h and panel.h will be renamed when installed (to xcurses.h and xpanel.h), to avoid conflicts with any existing curses installations. Unrenamed copies of curses.h and panel.h are installed in (by default) /usr/local/include/xcurses. As of 3.2, libXpanel is just a symlink to libXCurses. Both curses and panel functions are in the main library. SDL--- . On *nix (including Linux and Mac OS X), run "make" in the sdl1 directory. There is no configure script (yet?) for this port. This assumes a working sdl-config, and GNU make. It builds the library libpdcurses.a (dynamic lib not implemented). With MinGW, run "make -f Makefile.mng". This assumes SDL is installed in the standard directories. The MinGW makefile accepts the optional parameters "DLL=Y" and "DEBUG=Y", as with the console version. (Wide- character support is not yet implemented for SDL.) Both makefiles recognize the optional PDCURSES_SRCDIR environment variable, as with the console ports. Makefile.mng builds libpdcurses.a, along with pdcurses.dll, if specified.
How to build PDCurses
=====================
Unpack the source archive, then go to the appropriate section below, for
native console, X11 or SDL.
DOS, OS/2, or Windows console
-----------------------------
. In the subdirectory for each OS, you'll find a number of ".mak"
files, one for each supported compiler:
DOS:
bccdos.mak - Borland C++ 3.0+
gccdos.mak - DJGPP V2
mscdos.mak - Microsoft C
wccdos16.mak - Watcom 10.6+ (16-bit)
wccdos4g.mak - Watcom 10.6+ (32-bit)
OS/2:
bccos2.mak - Borland C++ 2.0
gccos2.mak - EMX 0.9b+
iccos2.mak - C Set/2
wccos2.mak - Watcom 10.6+ (32-bit)
Windows:
bccwin32.mak - Borland C++ 4.0.2+
dmcwin32.mak - Digital Mars
gccwin32.mak - Cygnus GNU Compiler
lccwin32.mak - LCC-Win32
mingwin32.mak - MinGW
vcwin32.mak - Microsoft Visual C++ 2.0+
wccwin32.mak - Watcom 10.6+
. For 16-bit compilers, you can change the memory MODEL in the makefile.
(Large model is the default, and recommended.)
. Optionally, you can build in a different directory than the platform
directory by setting PDCURSES_SRCDIR to point to the directory where
you unpacked PDCurses, and changing to your target directory:
set PDCURSES_SRCDIR=c:\pdcurses
This step is no longer required when building in the platform
directory, and won't work with the LCC or Digital Mars makefiles.
. Build it:
make -f makefilename
(For Watcom, use "wmake" instead of "make"; for MSVC or C Set/2,
"nmake".) You'll get the libraries (pdcurses.lib or .a, depending on
your compiler; and panel.lib or .a), the demos (*.exe), and a lot of
object files. Note that the panel library is now (as of 3.2) just a
copy of the main library, provided for convenience; both panel and
curses functions are in the main library.
For Windows (except with LCC or Digital Mars), you can also give the
optional parameter "WIDE=Y", to build the library with wide-character
(Unicode) support:
make -f mingwin32.mak WIDE=Y
When built this way, the library is not compatible with Windows 9x,
unless you also link with the Microsoft Layer for Unicode (not
tested).
Another option for Windows, "UTF8=Y", makes PDCurses ignore the
system locale, and treat all narrow-character strings as UTF-8. This
option has no effect unless WIDE=Y is also set. Use it to get around
the poor support for UTF-8 in the Win32 console:
make -f mingwin32.mak WIDE=Y UTF8=Y
You can also use the optional parameter "DLL=Y" with Visual C++,
MinGW, Cygwin or EMX, to build the library as a DLL:
nmake -f vcwin32.mak WIDE=Y DLL=Y
When you build the library as a Windows DLL, you must always define
PDCURSES_DLL_BUILD when linking against it. (Or, if you only want to
use the DLL, you could add this definition to your curses.h.) This is
not true for OS/2.
X11
---
. Run "./configure" in the PDCurses-x.x directory.
To build the wide-character version of the library, specify
"--enable-widec" as a parameter. To use X Input Methods, add
"--enable-xim". I recommend these options, but I haven't yet made
them the defaults, for the sake of backwards compatibility and due to
their new and relatively untested status.
If your system is lacking in UTF-8 support, you can force the use of
UTF-8 instead of the system locale via "--enable-force-utf8". This is
generally more useful in Windows.
If configure can't find your X include files or X libraries, you can
specify the paths with the arguments "--x-includes=inc_path" and/or
"--x-libraries=lib_path".
By default, the library and demo programs are built with the optimizer
switch -O2. You can turn this off, and turn on debugging (-g), by
adding "--with-debug" to the configure command.
. Run "make". This should build libXCurses and all the demo programs.
. Optionally, run "make install". curses.h and panel.h will be renamed
when installed (to xcurses.h and xpanel.h), to avoid conflicts with
any existing curses installations. Unrenamed copies of curses.h and
panel.h are installed in (by default) /usr/local/include/xcurses.
As of 3.2, libXpanel is just a symlink to libXCurses. Both curses and
panel functions are in the main library.
SDL
---
. On *nix (including Linux and Mac OS X), run "make" in the sdl1
directory. There is no configure script (yet?) for this port. This
assumes a working sdl-config, and GNU make. It builds the library
libpdcurses.a (dynamic lib not implemented).
With MinGW, run "make -f Makefile.mng". This assumes SDL is installed
in the standard directories. The MinGW makefile accepts the optional
parameters "DLL=Y" and "DEBUG=Y", as with the console version. (Wide-
character support is not yet implemented for SDL.) Both makefiles
recognize the optional PDCURSES_SRCDIR environment variable, as with
the console ports. Makefile.mng builds libpdcurses.a, along with
pdcurses.dll, if specified.