]> git.saurik.com Git - wxWidgets.git/commitdiff
updating docs to reflect build system changes
authorVáclav Slavík <vslavik@fastmail.fm>
Tue, 5 Aug 2003 20:33:16 +0000 (20:33 +0000)
committerVáclav Slavík <vslavik@fastmail.fm>
Tue, 5 Aug 2003 20:33:16 +0000 (20:33 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@22613 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

BuildCVS.txt
docs/gtk/install.txt
docs/motif/install.txt
docs/x11/install.txt

index 998a8963888e4f3e8a1b201b0d8af08866522aa9..b7ddba7b44fe2e9b28f7d9a51b4380587905e2ab 100644 (file)
@@ -25,23 +25,27 @@ You can get MinGW from  http://www.mingw.org/
 
 Cygwin is available at  http://sources.redhat.com/cygwin/
 
 
 Cygwin is available at  http://sources.redhat.com/cygwin/
 
-The makefile might have small problems with Cygwin's tools
-so it is recommended to use MinGW and its toolchain instead
-if possible.
+If you are using Cygwin or MinGW together with the MSYS environment, you
+can build the library using configure (see "Unix ports" and
+"Windows using configure" below). You can also
+build wxWindows without configure using native makefile, but only with
+MinGW. Using Cygwin together with Windows makefile is no longer supported.
+
+If building with Mingw without configure:
 
 -> Set your path so that it includes the directory
    where your compiler and tools reside
 
 
 -> Set your path so that it includes the directory
    where your compiler and tools reside
 
--> If your are using an old MinGW version (gcc-2.95 or older),
-   you might need to fix some headers with the patches contained
-   in the wxWin\Mingw32-gcc295.patches file. PLEASE APPLY THESE
-   PATCHES BY HAND! There are apparently a few different versions
-   of the headers floating around. Note that these patches are
-   not needed if you are using MinGW gcc-2.95.2 or newer.
-  
--> Edit wx/src/makeg95.env and set the MINGW32 variable at the top of
-   the file to either 1 (you have MinGW) or 0 (you have Cygwin).
-   Also set the MINGW32VERSION variable appropiately.
+-> Make sure you have GNU Make installed. It must be Windows native version.
+   Download it from http://www.mingw.org, the executable will be called
+   mingw32-make.exe.
+
+-> Modern version of MinGW is required; preferably MinGW 2.0 (with gcc3),
+   but MinGW with gcc-2.95.3 will suffice. If you are using 2.95, you will
+   have to change variable GCC_VERSION in config.gcc (see msw/install.txt
+   for details).
+
+If using configure, Unix instructions apply.
 
 
 c) Build instructions
 
 
 c) Build instructions
@@ -56,10 +60,10 @@ c) Build instructions
    and std iostreams are disabled with
    #define wxUSE_STD_IOSTREAM   0
  
    and std iostreams are disabled with
    #define wxUSE_STD_IOSTREAM   0
  
--> type: cd c:\wxWin\src\msw
--> type: set WXWIN=c:\wxWin
--> type: make -f makefile.g95  (if using GNU tools)
+-> type: cd c:\wxWin\build\win32
+-> type: make -f makefile.gcc  (if using GNU tools)
 or type: nmake -f makefile.vc   (if using MS VC++)
 or type: nmake -f makefile.vc   (if using MS VC++)
+etc.
 
    See also docs/msw/install.txt for additional compilation options.
 
 
    See also docs/msw/install.txt for additional compilation options.
 
@@ -68,9 +72,12 @@ d) Borland (including free command line tools)
    
    See docs/msw/install.txt for details; in brief
 
    
    See docs/msw/install.txt for details; in brief
 
--> type set WXWIN=c:\wxwindows
--> type cd %WXWIN%\src\msw
--> type make -f makefile.b32
+-> type cd %WXWIN%\build\win32
+-> type make -f makefile.bcc
+
+You can customize many things in the build process, detailed description is
+in docs/msw/install.txt.
+
 
 II) Unix ports
 --------------
 
 II) Unix ports
 --------------
@@ -81,10 +88,11 @@ that works without libtool and automake, using only
 configure to create what is needed.
 
 In order to create configure, you need to have the
 configure to create what is needed.
 
 In order to create configure, you need to have the
-GNU autoconf package (version 2.13 or 2.14) installed
+GNU autoconf package (version > 2.54) installed
 on your system and type run "autoconf" in the base
 directory (or run the autogen.sh script in the same
 on your system and type run "autoconf" in the base
 directory (or run the autogen.sh script in the same
-directory, which just calls autoconf).
+directory, which just calls autoconf). Note that you usually don't
+need to do this because configure is included in cVS.
 
 Set WXWIN environment variable to the base directory such
 as ~/wxWindows (this is actually not really needed).
 
 Set WXWIN environment variable to the base directory such
 as ~/wxWindows (this is actually not really needed).
@@ -141,7 +149,7 @@ you will need to register at the Apple Developer web site (this is a free
 registration) in order to download the Developer Tools installer.
 
 In order to create configure, you need to have the
 registration) in order to download the Developer Tools installer.
 
 In order to create configure, you need to have the
-GNU autoconf package (version 2.13 or 2.14) installed
+GNU autoconf package (version >= 2.54) installed
 on your system and type run "autoconf" in the base
 directory (or run the autogen.sh script in the same
 directory, which just calls autoconf).
 on your system and type run "autoconf" in the base
 directory (or run the autogen.sh script in the same
 directory, which just calls autoconf).
index 2999a2995e6b8643bec68c542b84b867b16aaebc..487ce0bdabf220f5df54e73409e692eb65e1c61d 100644 (file)
@@ -1,4 +1,4 @@
-wxWindows 2.4 for GTK installation
+wxWindows 2.5 for GTK installation
 ----------------------------------
 
 IMPORTANT NOTE:
 ----------------------------------
 
 IMPORTANT NOTE:
@@ -44,11 +44,11 @@ If you want to remove wxWindows on Unix you can do this:
 * The GTK+ 2 case
 -----------------
 
 * The GTK+ 2 case
 -----------------
 
-wxGTK 2.4.0 has support for the new version 2.0.X of GTK+. This means
-that wxGTK apps can now make use Unicode as the underlying encoding
-for all text operations. This is a very fundamental change and will
-need time to stabilize, so be careful. Anyways, after installing a
-recent version of GTK+ 2.0, do this
+wxGTK has support for the new version 2.0.X of GTK+ since version 2.4.0.
+This means that wxGTK apps can now make use Unicode as the underlying encoding
+for all text operations. This is a very fundamental change and will need time
+to stabilize, so be careful. Anyways, after installing a recent version of GTK+
+2.0, do this
 
 > ./configure --with-gtk --enable-gtk2 --enable-unicode
 > make
 
 > ./configure --with-gtk --enable-gtk2 --enable-unicode
 > make
@@ -175,14 +175,8 @@ at my homepage.
 wxWindows/Gtk requires a thread library and X libraries known to work with
 threads.  This is the case on all commercial Unix-Variants and all
 Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
 wxWindows/Gtk requires a thread library and X libraries known to work with
 threads.  This is the case on all commercial Unix-Variants and all
 Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
-many aspects. As of writing this, these Linux distributions have correct glibc
-2 support:
-
- - RedHat 5.1
- - Debian 2.0 and 3.0
- - Stampede
- - DLD 6.0
- - SuSE 6.0
+many aspects. As of writing this, virtually all Linux distributions have
+correct glibc 2 support.
 
 You can disable thread support by running
 
 
 You can disable thread support by running
 
@@ -296,6 +290,10 @@ The following options handle the kind of library you want to build.
     --disable-shared        Do not create shared libraries, but
                             build static libraries instead.
 
     --disable-shared        Do not create shared libraries, but
                             build static libraries instead.
 
+    --enable-monolithic     Build wxWindows as single library instead
+                            of as several smaller libraries (which is
+                            the default since wxWindows 2.5.0).
+
     --disable-optimise      Do not optimise the code. Can
                             sometimes be useful for debugging
                             and is required on some architectures
     --disable-optimise      Do not optimise the code. Can
                             sometimes be useful for debugging
                             and is required on some architectures
@@ -367,6 +365,8 @@ are
 
     --without-libtiff       Disables TIFF image format code.
 
 
     --without-libtiff       Disables TIFF image format code.
 
+    --without-expat         Disable XML classes based on Expat parser.
+
     --disable-pnm           Disables PNM image format code.
 
     --disable-gif           Disables GIF image format code.
     --disable-pnm           Disables PNM image format code.
 
     --disable-gif           Disables GIF image format code.
@@ -403,6 +403,10 @@ Apart from disabling certain features you can very often "strip"
 the program of its debugging information resulting in a significant
 reduction in size.
 
 the program of its debugging information resulting in a significant
 reduction in size.
 
+Please see the output of "./configure --help" for comprehensive list
+of all configurable options.
+
+
 * Compiling
 -----------
 
 * Compiling
 -----------
 
@@ -464,6 +468,12 @@ clean:
 This is certain to become the standard way unless we decide
 to stick to tmake.
 
 This is certain to become the standard way unless we decide
 to stick to tmake.
 
+If your application uses only some of wxWindows libraries, you can
+specify required libraries when running wx-config. For example,
+`wx-config --libs=html,core` will only output link command to link
+with libraries required by core GUI classes and wxHTML classes. See
+the manual for more information on the libraries.
+
 2) The other way creates a project within the source code
 directories of wxWindows. For this endeavour, you'll need
 GNU autoconf version 2.14 and add an entry to your Makefile.in
 2) The other way creates a project within the source code
 directories of wxWindows. For this endeavour, you'll need
 GNU autoconf version 2.14 and add an entry to your Makefile.in
index 8962f5c76292ddd9810214fe42998f17f114df3a..65bad2c5f8582dc1033cad43f9ca2b727af1f164 100644 (file)
@@ -156,15 +156,9 @@ You can get the newest version of the Lesstif from the lesstif homepage at:
 wxWindows/Motif requires a thread library and X libraries known to work with
 threads.  This is the case on all commercial Unix-Variants and all
 Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
 wxWindows/Motif requires a thread library and X libraries known to work with
 threads.  This is the case on all commercial Unix-Variants and all
 Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
-many aspects. As of writing this, these Linux distributions have correct glibc
-2 support:
-
- - RedHat 5.1
- - Debian 2.0 and 3.0
- - Stampede
- - DLD 6.0
- - SuSE 6.0
+many aspects. As of writing this, virtually all Linux distributions have
+correct glibc 2 support.
+
 You can disable thread support by running 
 
 ./configure --disable-threads
 You can disable thread support by running 
 
 ./configure --disable-threads
@@ -286,15 +280,19 @@ The following options handle the kind of library you want to build.
 
        --disable-threads       Compile without thread support. Threads
                                support is also required for the
 
        --disable-threads       Compile without thread support. Threads
                                support is also required for the
-                               socket code to work.
+                            socket code to work.
 
        --disable-shared        Do not create shared libraries.
 
 
        --disable-shared        Do not create shared libraries.
 
-       --disable-optimise      Do not optimise the code. Can
+    --enable-monolithic     Build wxWindows as single library instead
+                            of as several smaller libraries (which is
+                            the default since wxWindows 2.5.0).
+
+       --disable-optimise      Do not optimise the code. Can
                                sometimes be useful for debugging
                                sometimes be useful for debugging
-                               and is required on some architectures
-                               such as Sun with gcc 2.8.X which
-                               would otherwise produce segvs.
+                            and is required on some architectures
+                            such as Sun with gcc 2.8.X which
+                            would otherwise produce segvs.
 
        --enable-profile        Add profiling info to the object 
                                files. Currently broken, I think.
 
        --enable-profile        Add profiling info to the object 
                                files. Currently broken, I think.
@@ -355,6 +353,10 @@ are
        --without-libjpeg       Disables JPEG image format code.
        
        --without-odbc          Disables ODBC code.
        --without-libjpeg       Disables JPEG image format code.
        
        --without-odbc          Disables ODBC code.
+   
+    --without-libtiff       Disables TIFF image format code.
+    --without-expat         Disable XML classes based on Expat parser.
        
        --disable-threads       Disables threads. Will also
                                disable sockets.
        
        --disable-threads       Disables threads. Will also
                                disable sockets.
@@ -381,6 +383,10 @@ Apart from disabling certain features you can very often "strip"
 the program of its debugging information resulting in a significant
 reduction in size.
 
 the program of its debugging information resulting in a significant
 reduction in size.
 
+Please see the output of "./configure --help" for comprehensive list
+of all configurable options.
+
+
 * Compiling
 -----------
 
 * Compiling
 -----------
 
@@ -442,6 +448,12 @@ clean:
 This is certain to become the standard way unless we decide
 to stick to tmake.
 
 This is certain to become the standard way unless we decide
 to stick to tmake.
 
+If your application uses only some of wxWindows libraries, you can
+specify required libraries when running wx-config. For example,
+`wx-config --libs=html,core` will only output link command to link
+with libraries required by core GUI classes and wxHTML classes. See
+the manual for more information on the libraries.
+
 2) The other way creates a project within the source code 
 directories of wxWindows. For this endeavour, you'll need
 GNU autoconf version 2.14 and add an entry to your Makefile.in
 2) The other way creates a project within the source code 
 directories of wxWindows. For this endeavour, you'll need
 GNU autoconf version 2.14 and add an entry to your Makefile.in
index b9d30f03aef41415fe06ce22803cee3cc57cc41e..b17a6c10d7324c7772c829d8fd85d803287d257a 100644 (file)
@@ -145,15 +145,9 @@ wxWindows/X11 requires the X11 library to be installed on your system.
 wxWindows/X11 requires a thread library and X libraries known to work with
 threads.  This is the case on all commercial Unix-Variants and all
 Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
 wxWindows/X11 requires a thread library and X libraries known to work with
 threads.  This is the case on all commercial Unix-Variants and all
 Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
-many aspects. As of writing this, these Linux distributions have correct glibc
-2 support:
-
- - RedHat 5.1
- - Debian 2.0 and 3.0
- - Stampede
- - DLD 6.0
- - SuSE 6.0
+many aspects.  As of writing this, virtually all Linux distributions have
++correct glibc 2 support.
+
 You can disable thread support by running 
 
 ./configure --disable-threads
 You can disable thread support by running 
 
 ./configure --disable-threads
@@ -274,6 +268,10 @@ The following options handle the kind of library you want to build.
 
        --disable-shared        Do not create shared libraries.
 
 
        --disable-shared        Do not create shared libraries.
 
+    --enable-monolithic     Build wxWindows as single library instead
+                            of as several smaller libraries (which is
+                            the default since wxWindows 2.5.0).
+
        --disable-optimise      Do not optimise the code. Can
                                sometimes be useful for debugging
                                and is required on some architectures
        --disable-optimise      Do not optimise the code. Can
                                sometimes be useful for debugging
                                and is required on some architectures
@@ -336,6 +334,8 @@ are
        --without-libjpeg       Disables JPEG image format code.
        
 {      --without-odbc          Disables ODBC code. Not yet. }
        --without-libjpeg       Disables JPEG image format code.
        
 {      --without-odbc          Disables ODBC code. Not yet. }
+
+    --without-expat         Disable XML classes based on Expat parser.
        
         --disable-resources     Disables the use of *.wxr type
                                resources.
        
         --disable-resources     Disables the use of *.wxr type
                                resources.
@@ -367,6 +367,10 @@ Apart from disabling certain features you can very often "strip"
 the program of its debugging information resulting in a significant
 reduction in size.
 
 the program of its debugging information resulting in a significant
 reduction in size.
 
+Please see the output of "./configure --help" for comprehensive list
+of all configurable options.
+
+
 * Compiling
 -----------
 
 * Compiling
 -----------
 
@@ -428,6 +432,12 @@ clean:
 This is certain to become the standard way unless we decide
 to stick to tmake.
 
 This is certain to become the standard way unless we decide
 to stick to tmake.
 
+If your application uses only some of wxWindows libraries, you can
+specify required libraries when running wx-config. For example,
+`wx-config --libs=html,core` will only output link command to link
+with libraries required by core GUI classes and wxHTML classes. See
+the manual for more information on the libraries.
+
 2) The other way creates a project within the source code 
 directories of wxWindows. For this endeavour, you'll need
 GNU autoconf version 2.14 and add an entry to your Makefile.in
 2) The other way creates a project within the source code 
 directories of wxWindows. For this endeavour, you'll need
 GNU autoconf version 2.14 and add an entry to your Makefile.in