home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / wxwin140 / docs / install.txt < prev    next >
Encoding:
Text File  |  1995-05-19  |  7.4 KB  |  179 lines
  1. --------------------------------------
  2. Installation of wxWindows Version 1.40
  3. --------------------------------------
  4.  
  5. ---------
  6. File List
  7. ---------
  8.  
  9. In wxwin140.tar.Z and wxwin140.zip:
  10.  
  11. contrib/*            User contributions
  12.  
  13. docs/classes.tex                Part of LaTeX manual
  14. docs/help.xlp            Introduction to wxHelp in wxHelp format
  15. docs/hytext.xlp            hyText class reference in wxHelp format
  16. docs/files.txt            Full file list
  17. docs/install.txt        This file
  18. docs/manual.tex                 LaTeX manual source
  19. docs/manual.dvi                 LaTeX DVI file
  20. docs/manual.ps                  PostScript manual
  21. docs/readme.txt            Describes wxWindows briefly
  22. docs/tutorial.tex               Very brief tutorial in LaTeX form
  23. docs/tutorial.dvi               LaTeX DVI file
  24. docs/tutorial.ps                PostScript tutorial
  25. docs/wx.xlp            wxWindows class reference in wxHelp format
  26.  
  27. dummy/windows.h                 UNIX-only dummy file needed if
  28.                                 precompiling windows.h under Windows 3
  29.  
  30. include/*.h                     Header files (wx.h is main include file)
  31. include/wx.rc                   Resource file (required for all Win 3 apps)
  32. include/*.cur                   Windows 3 cursors
  33.  
  34. lib/wx.lib                      wxWindows library (Windows 3, large model)
  35. lib/libwx.a                     wxWindows library (XView)
  36.                 (THESE FILES CREATED ON INSTALLATION)
  37.  
  38. src/*.cc                        Source files
  39. src/sb_scrol.c            XView patch (see below)
  40. src/sb_scrol.o            XView patch for SPARCs
  41. src/makefile.unx                UNIX makefile
  42. src/makefile.dos                DOS nmakefile
  43.  
  44. samples/form                    Form demo directory
  45. samples/hello                   Hello demo directory
  46. samples/ipc                     Interprocess comms demo directory
  47. samples/mdi                     Multiple Document Interface demo directory
  48. samples/minimal                 Minimal app demo directory
  49. samples/objects                 Object graphics demo directory
  50.  
  51. utils/hytext                    Hypertext library
  52. utils/hytext/docs               Hypertext library documentation
  53. utils/hytext/src                Hypertext library source
  54.  
  55. utils/wxhelp                    wxHelp help system
  56. utils/wxhelp/docs               wxHelp documentation
  57. utils/wxhelp/src                wxHelp source (requires hytext library)
  58.  
  59. Executables are suffixed with -ol for Open Look and -motif for Motif.
  60.  
  61. The executable UNIX demos are in demo-ol.tar.Z and demo-motif.tar.Z
  62. and the PC demo is in demo.zip, along with the demo sources.
  63.  
  64. ----------------
  65. Installation: PC
  66. ----------------
  67.  
  68. 1) Unzip to an appropriate place on your hard disk with 'unzip -d wxwin140.zip'.
  69. 2) If you have the demo executable (in demo.zip), unzip it and
  70.    install it in the Program  Manager by dragging the HELLO.EXE file from the
  71.    File Manager.
  72. 3) Run demo to check if wxWindows might be for you.
  73.    If not, delete wxWindows. If you're still with us at this point...
  74. 4) Set your INCLUDE variable to point to the wxWindows include directory,
  75.    and the WXHELPFILES variable to point to the docs directory.
  76. 5) If wx.lib is not supplied, alter src/makefile.dos to reflect your
  77.    directory structure, and type 'nmake -f makefile.dos' to make lib/wx.lib.
  78.    If you have a non-Microsoft compiler, you will need to write an appropriate
  79.    makefile or create a project; sorry! (but see the contrib directory
  80.    for some hints for Borland users)
  81. 6) Print tutorial.ps and manual.ps on a PostScript printer. The manual is just
  82.    over 100 pages, the tutorial is about 7.
  83.  
  84. If you wish to use the wxHelp hypertext help system, either for
  85. your own applications or for viewing the wxWindows class library reference,
  86. you will need to do download the binary (in wxhelp14.zip) or make
  87. wxHelp as follows:
  88.  
  89. 7) Edit the makefile in utils/hytext/src and compile the library.
  90. 8) Edit the makefile in utils/wxhelp/src and compile wxhelp.exe.
  91. 9) Copy wxhelp.exe into a directory on your path, and read the
  92.    wxHelp documentation.
  93.  
  94. You may wish to precompile wx.h instead of windows.h, if you know you
  95. won't be tinkering with the wxWindows source code. This will speed up
  96. compilation of your applications.
  97.  
  98. By default, wxWindows is compiled with CodeView debugging information.
  99. To compile without debugging information, specify FINAL=1 on your make
  100. command line. Note that to produce a non-debugging executable you need
  101. only relink your application (or the demo) since any debugging
  102. information in the wxWindows library will be removed by the linker if
  103. the FINAL flag is set to 1.
  104.  
  105. ------------------
  106. Installation: UNIX
  107. ------------------
  108.  
  109. 1) Uncompress wxWindows with 'uncompress wxwin140.tar.Z' and untar with
  110.    'tar -xvf wxwin140.tar'.
  111. 2) If you have the demo executable (in demo-ol.tar.Z or demo-motif.tar.Z),
  112.    uncompress, untar and try running it. You'll need the run-time libraries
  113.    appropriate to the toolkit (XView 3.1 or Motif 1.1).
  114. 3) If you want to use XView and XView 3.1 is not present, install it (it's
  115.    available free on the Net). Your LD_LIBRARY_PATH may need to be altered
  116.    or disabled.
  117. 4) If GCC/G++ is not installed, install it (again, available free). Or you
  118.    could try an alternative compiler (AT&T C++ is known to work with wxWindows).
  119. 5) Alter src/makefile.unx to reflect your directory structure, and type
  120.    'make -f makefile.unx'. With luck, libwx.a should end up in the lib
  121.    directory.
  122. 6) Set the WXHELPFILES environment variable to point to the docs directory.
  123. 7) Edit the demo makefiles and compile (especially the main `hello' example).
  124.  
  125. If you wish to use the wxHelp hypertext help system, either for
  126. your own applications or for viewing the wxWindows class library reference,
  127. you will need to do download the binaries (in wxhelp14.tar.Z) or make
  128. wxHelp as follows:
  129.  
  130. 8)  Edit the makefile in utils/hytext/src and compile the library.
  131. 9)  Edit the makefile in utils/wxhelp/src and compile wxhelp.exe.
  132. 10) Copy wxhelp into a directory on your path, and read the
  133.     wxHelp documentation.
  134.  
  135. If you are likely to be using XView and modal windows, where the flow
  136. of the program is stopped until the user responds, you will need to
  137. link sb_scrol.o with your application. This is an XView patch which
  138. (sort of) fixes listboxes on modal dialogs (i.e. on a window within
  139. xv_window_loop). Listboxes don't scroll without the patch. Other
  140. widgets may be affected by this bug. The object file sb_scrol.o is
  141. supplied for SPARC-based machines; you will need to compile sb_scrol.c
  142. otherwise (type make -f makefile.unx sb_scrol.o).
  143.  
  144. By default, wxWindows is compiled with debugging information.  To
  145. compile without debugging information, specify DEBUG= on your make
  146. command line. Note that under UNIX you need to do this for both the
  147. wxWindows library and your application, to remove all debugging
  148. information.
  149.  
  150. You may find the scripts wxcopy (UNIX) and wxcopy.bat (4DOS)
  151. useful for copying wxWindows between different machines or directories.
  152.  
  153. ------------------------
  154. Notes for AT&T C++ users
  155. ------------------------
  156.  
  157. The following changes need to be made for this compiler:
  158.  
  159. -- in wx_dc.cc, this should be added near the top: #include <sysent.h>
  160. -- an updated version of varargs.h should be used for older versions of the
  161.    compiler.
  162. -- Ignore warnings about wxList::Member and wxStringList::Member in wx_list.cc
  163.  
  164. -------------------------------------------------------
  165. Known platforms and compilers compatible with wxWindows
  166. -------------------------------------------------------
  167.  
  168. (please let me know of any others!)
  169.  
  170. PC 386SX and above
  171. Sun (SPARC)
  172. Linux
  173.  
  174. Gnu GCC 2.1
  175. AT&T C++
  176. Sun C++
  177. Microsoft C/C++ 7
  178. Borland C++ 3.1
  179. Zortech C++