X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e306597309a120f2ae91385c731a5cb2722c52aa..8a0d4cf6c5e9fe357ca3e873b81c0fda10e4b217:/docs/msw/install.txt diff --git a/docs/msw/install.txt b/docs/msw/install.txt index ee25d87c26..6659a1680e 100644 --- a/docs/msw/install.txt +++ b/docs/msw/install.txt @@ -2,6 +2,12 @@ Installing wxWindows 2.0 ------------------------ +IMPORTANT NOTE: If you experience problems installing, please +re-read this instructions and other related files (todo.txt, +bugs.txt etc.) carefully before mailing wxwin-users or +the author. Preferably, try to fix the problem first and +then send a patch to the author. + Unarchiving ----------- @@ -20,10 +26,10 @@ wx200pdf.zip Acrobat PDF documentation wx200htm.zip HTML documentation wx200vc.zip MS VC++ 5.0 project files wx200cw.zip Metrowerks CodeWarrior project files +wx200bc.zip BC++ 5 project files Unarchive the required files plus any optional documentation -files into a suitable directory such as c:\wx. Alter your -WXWIN environment variable to point to this directory. +files into a suitable directory such as c:\wx. Other add-on packages are available from the wxWindows Web site, such as: @@ -32,13 +38,21 @@ Other add-on packages are available from the wxWindows Web site, such as: - tex2rtf3.zip. Tex2RTF: create Windows Help, HTML, and Word RTF files from the same document source. +General installation notes +-------------------------- + +Alter your WXWIN environment variable to point to this directory. +For Cygwin or Mingw32 compilation, make sure WXWIN contains only +forward slashes. + +If installing from the CVS server, copy include/wx/msw/setup0.h to +include/wx/msw/setup.h. + Compilation ----------- -At present, wxWindows compiles with VC++ 4.0/5.0/6.0, -BC++ 4.5/5.0, Cygwin b19/b20, and Mingw32. It may compile -with 16-bit compilers (BC++ and VC++ 1.5) but this hasn't -been tested lately. +The following sections explain how to compile wxWindows with each supported +compiler. Visual C++ 4.0/5.0/6.0 compilation ---------------------------------- @@ -47,7 +61,10 @@ Using project files: 1. Unarchive wx200vc.zip, the VC++ 5 project makefiles. 2. Open src/wxvc.dsp, set Debug or Release configuration, and - compile. This will produce lib/wxvc.lib or lib/wxvc_debug.lib. + compile. This will produce src/Debug/wxvc.lib or + src/Release/wxvc.lib. The project file src/wxvc_dll.dsp + will make a DLL version of wxWindow, which will go in + src/DebugDLL/wxvc.[lib,dll] and src/ReleaseDLL/wxvc.[lib,dll]. 3. Open a sample project file, choose a configuration, and compile. The project files don't use precompiled headers, to save space, but you can switch PCH compiling on for greater speed. @@ -55,33 +72,71 @@ Using project files: Using makefiles: 1. Make sure your WXWIN variable is set. -2. Change directory to wx\src\msw. Type 'nmake -f makefile.vc' to - make the wxWindows core library. +2. Change directory to wx\src\msw. Type: + + 'nmake -f makefile.vc' + + to make the wxWindows core library with debug information + (wx\lib\wx_d.lib), or + + 'nmake -f makefile.vc FINAL=1' + + to make the wxWindows core library without debug information + (wx\lib\wx.lib). + 3. Change directory to wx\samples and type 'nmake -f makefile.vc' to make all the samples. You can also make them individually. -To build the release version using makefiles, add FINAL=1 to your -nmake invocation, both when building the library and for samples. +Notes: -Use the 'clean' target to clean all objects, libraries and -executables. + Use the 'clean' target to clean all objects, libraries and + executables. + + To build the release version using makefiles, add FINAL=1 to your + nmake invocation, both when building the library and for samples. + + Note that the wxWindows core library allows you to have debug + and release libraries available simultaneously, by compiling the + objects in different subdirectories, whereas samples must be + cleaned and re-made to build a different configuration. This + may be changed in later versions of wxWindows. To build the DLL version using makefiles: 1. Change directory to wx\src\msw. Type 'nmake -f makefile.vc dll pch' to make both a suitable DLL and import library, and to build a suitable precompiled header file for compiling applications. -2. Invoke a sample makefile with 'nmake -f makefile.vc WXUSINGDLL=1'. + The resulting libraries are called: + + wx\lib\wx200_d.lib(dll) (debug version) + wx\lib\wx200.lib(dll) (release version, using FINAL=1) + +2. Invoke a sample makefile with 'nmake -f makefile.vc WXUSINGDLL=1' + (or edit src\makeprog.vc to set WXUSINGDLL to 1 for all + applications). Note (1): if you wish to use templates, please edit include\wx\msw\setup.h and set wxUSE_DEBUG_NEW_ALWAYS to 0. Without this, the redefinition of 'new' will cause problems in the headers. Alternatively, #undef new before including template headers. +You will also need to set wxUSE_IOSTREAMH to 0 if you will be +using templates, to avoid the non-template stream files being included +within wxWindows. Note (2): libraries and applications generated with makefiles and project files are unlikely to be compatible, so use one method or the other. +Note (3): VC++ 5's optimization code seems to be broken and can +cause problems: this can be seen when deleting an object Dialog +Editor, in Release mode with optimizations on. If in doubt, +switch off optimisations, although this will result in much +larger executables. It seems possible that the library can be created with +strong optimization, so long as the application is not strongly +optimized. For example, in wxWindows project, set to 'Minimum +Size'. In Dialog Editor project, set to 'Customize: Favor Small +Code' (and no others). This will then work. + Visual C++ 1.5 compilation -------------------------- @@ -101,6 +156,8 @@ executables. Borland C++ 4.5/5.0 compilation ------------------------------- +Compiling using the makefiles: + 1. Make sure your WXWIN variable is set, and uses the FAT (short name) form if doing a 16-bit compile. 2. Change directory to wx\src\msw. Type 'make -f makefile.b32' to @@ -117,6 +174,27 @@ Note: the wxWindows library and (some) samples compile in 16-bit mode using makefile.bcc, but at present the wxWindows resource system is switched off in this mode. See issues.txt for details. +Compiling using the IDE files: + +1. Load src\bc32.ide (or src\bc32d.ide for a debugging version). +2. Go to Options|Project... and specify the correct BC++ include and lib path for + your file structure. +3. Press F9 to compile the wxWindows library. +4. Load samples\bc32.ide. +5. Go to Options|Project... and specify the correct BC++ include and lib path for + your file structure. +6. Press F9 to compile the samples. + +Note that to make the png, xpm and zlib libraries (needed for +some samples) you need to compile with bc32.ide. bc32d.ide only +makes the wxWindows library (lib\wx32d.lib). + +The debug version of the wxWindows library is about 37 MB, and the +release version is around 3 MB. + +See also the file bc_ide.txt for further instructions and details +of how to create your own project files. + Borland C++Builder compilation ------------------------------ @@ -128,8 +206,8 @@ supplied. Watcom C++ 10.6 compilation --------------------------- -1. Make sure your WXWIN variable is set, and uses the FAT (short - name) form. +1. Make sure your WXWIN variable is set, and uses the DOS short + name form. 2. Change directory to wx\src\msw. Type 'wmake -f makefile.wat' to make the wxWindows core library. 3. Change directory to wx\samples\minimal and type 'wmake -f makefile.wat' @@ -146,9 +224,7 @@ Metrowerks CodeWarrior compilation NOTES: -(a) Unfortunately CodeWarrior support is broken in this -release. Stefan Csomor (csomor@advancedconcepts.ch) will rectify this shortly. -(b) You need CodeWarrior Pro 4 plus the patches to 4.1 from the +You need CodeWarrior Pro 4 plus the patches to 4.1 from the Metrowerks Web site. Symantec C++ compilation @@ -232,6 +308,9 @@ Here are the steps required: - Mingw32 may not support winsock.h, so comment out socket-related files in src/msw/makefile.g95. +- Set your WXWIN variable to where wxWindows is installed. + For Cygwin/Mingw32, use forward slashes in the path, not backslashes. + - Use the makefile.g95 files for compiling wxWindows and samples, e.g.: > cd c:\wx\src\msw @@ -239,6 +318,8 @@ Here are the steps required: > cd c:\wx\samples\minimal > make -f makefile.g95 + Ignore the warning about the default entry point. + - Use the 'strip' command to reduce executable size. - With Cygnus Cygwin, you can invoke gdb --nw myfile.exe to @@ -251,15 +332,29 @@ Here are the steps required: All targets have 'clean' targets to allow removal of object files and other intermediate compiler files. -Gotchas: +Notes: - libwx.a is 48 MB or more - but much less if compiled with no debug info (-g0) and level 4 optimization (-O4). + - install.exe doesn't have built-in decompression because lzexpand.lib isn't available with Cygwin. However, you can use it with external decompression utilities. + - Doesn't compile src/msw/ole files, so no drag and drop. +- There's a bug in the Mingw32 headers for some distributions. + + in include/windows32/defines.h, where it says: + + #define LPSTR_TEXTCALLBACKA (LPSTR)-1L) + + it should say: + + #define LPSTR_TEXTCALLBACKA ((LPSTR)-1L) + + (a missing bracket). + References: - The GNU-WIN32 site is at