libpayload: Add PDCurses and ncurses' libform/libmenu
[coreboot.git] / payloads / libpayload / curses / PDCurses-3.4 / win32 / README
1 PDCurses for Win32
2 ==================
3
4 This directory contains PDCurses source code files specific to Win32 
5 console mode (Win9x/Me/NT/2k/XP/Vista).
6
7
8 Building
9 --------
10
11 . Choose the appropriate makefile for your compiler:
12
13         bccwin32.mak    - Borland C++ 4.0.2+
14         dmcwin32.mak    - Digital Mars
15         gccwin32.mak    - Cygnus GNU Compiler
16         lccwin32.mak    - LCC-Win32
17         mingwin32.mak   - MinGW
18         vcwin32.mak     - Microsoft Visual C++ 2.0+
19         wccwin32.mak    - Watcom 10.6+
20
21 . Optionally, you can build in a different directory than the platform
22   directory by setting PDCURSES_SRCDIR to point to the directory where
23   you unpacked PDCurses, and changing to your target directory:
24
25         set PDCURSES_SRCDIR=c:\pdcurses
26
27   This won't work with the LCC or Digital Mars makefiles, nor will the
28   options described below.
29
30 . Build it:
31
32         make -f makefilename
33
34   (For Watcom, use "wmake" instead of "make"; for MSVC, "nmake".) You'll
35   get the libraries (pdcurses.lib or .a, depending on your compiler; and
36   panel.lib or .a), the demos (*.exe), and a lot of object files. Note
37   that the panel library is just a copy of the main library, provided
38   for convenience; both panel and curses functions are in the main
39   library.
40
41   You can also give the optional parameter "WIDE=Y", to build the 
42   library with wide-character (Unicode) support:
43
44         make -f mingwin32.mak WIDE=Y
45
46   When built this way, the library is not compatible with Windows 9x,
47   unless you also link with the Microsoft Layer for Unicode (not
48   tested).
49
50   Another option, "UTF8=Y", makes PDCurses ignore the system locale, and 
51   treat all narrow-character strings as UTF-8. This option has no effect 
52   unless WIDE=Y is also set. Use it to get around the poor support for 
53   UTF-8 in the Win32 console:
54
55         make -f mingwin32.mak WIDE=Y UTF8=Y
56
57   You can also use the optional parameter "DLL=Y" with Visual C++,
58   MinGW or Cygwin, to build the library as a DLL:
59
60         nmake -f vcwin32.mak WIDE=Y DLL=Y
61
62   When you build the library as a Windows DLL, you must always define
63   PDCURSES_DLL_BUILD when linking against it. (Or, if you only want to
64   use the DLL, you could add this definition to your curses.h.)
65
66
67 Distribution Status
68 -------------------
69
70 The files in this directory are released to the Public Domain.
71
72
73 Acknowledgements
74 ----------------
75
76 Generic Win32 port was provided by Chris Szurgot <szurgot@itribe.net>