X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/85d525b1112cfbb110c51439f759420e2e9baea4..65baafba0e8cd74f2264b7e2f7625ff5bea84864:/docs/gtk/install.txt diff --git a/docs/gtk/install.txt b/docs/gtk/install.txt index 93401c727d..7f0b1c8342 100644 --- a/docs/gtk/install.txt +++ b/docs/gtk/install.txt @@ -1,5 +1,5 @@ -wxWidgets 2.5 for GTK installation ----------------------------------- +wxWidgets 2.6 for GTK+ installation +----------------------------------- IMPORTANT NOTE: @@ -11,7 +11,7 @@ IMPORTANT NOTE: When sending bug reports tell us what version of wxWidgets you are using (including the beta) and what compiler on what system. One - example: wxGTK 2.4.0, gcc 2.95.4, Redhat 6.2 + example: wxGTK 2.6.2, gcc 2.95.4, Redhat 6.2 * The simplest case ------------------- @@ -19,65 +19,40 @@ IMPORTANT NOTE: If you compile wxWidgets on Linux for the first time and don't like to read install instructions just do (in the base dir): -> ./configure --with-gtk +> mkdir buildgtk +> cd buildgtk +> ../configure --with-gtk > make > su > make install > ldconfig -> exit +[if you get "ldconfig: command not found", try using "/sbin/ldconfig"] -Afterwards you can continue with - -> make -> su -> make install -> ldconfig -> exit +If you don't do the 'make install' part, you can still use the libraries from +the buildgtk directory, but they may not be available to other users. If you want to remove wxWidgets on Unix you can do this: > su > make uninstall > ldconfig -> exit - -* The GTK+ 2 case ------------------ - -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 -> su -> make install -> ldconfig -> exit - -If you are adventurous, you can install the FcConfig 2.0 package -and the Pango library from CVS (or a very recent snapshot from -the upcoming 1.2 series) and set do "export GDK_USE_XFT=1" so -that the display as well as the printing code will use render -using the same FreeType code even for Far Eastern encodings. -Expect problems. +Note that by default, GTK+ 2.X is used. GTK+ 1.2 can be specified +with --with-gtk=1. * The expert case ----------------- If you want to do some more serious cross-platform programming with wxWidgets, -such as for GTK and Motif, you can now build two complete libraries and use -them concurrently. For this end, you have to create a directory for each build +such as for GTK+ and Motif, you can now build two complete libraries and use +them concurrently. To do this, create a separate directory for each build of wxWidgets - you may also want to create different versions of wxWidgets and test them concurrently. Most typically, this would be a version configured with --enable-debug and one without. Note, that only one build can -currently be installed, so you'd have to use local version of the library for -that purpose. +currently be installed with 'make install', so you'd have to use local version of +the library for that purpose. -For building three versions (one GTK, one Motif and a debug version of the GTK +For building three versions (one GTK+, one Motif and a debug version of the GTK source) you'd do this: md buildmotif @@ -104,9 +79,9 @@ cd .. For any configure errors: please look at config.log file which was generated during configure run, it usually contains some useful information. -configure reports, that you don't have GTK 1.2 installed although you are +configure reports, that you don't have GTK+ 1.2 installed although you are very sure you have. Well, you have installed it, but you also have another -version of the GTK installed, which you may need to remove including other +version of the GTK+ installed, which you may need to remove including other versions of glib (and its headers). Or maybe you installed it in non default location and configure can't find it there, so please check that your PATH variable includes the path to the correct gtk-config. Also check that your @@ -139,30 +114,14 @@ Now create your super-application myfoo.cpp and compile anywhere with g++ myfoo.cpp `wx-config --libs --cxxflags` -o myfoo -* General ---------- - -The Unix variants of wxWidgets use GNU configure. If you have problems with -your make use GNU make instead. - -If you have general problems with installation, read my homepage at - - http://wesley.informatik.uni-freiburg.de/~wxxt/ - -for newest information. If you still don't have any success, please send a bug -report to one of our mailing lists (see my homepage) INCLUDING A DESCRIPTION OF -YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR VERSION OF GTK, WXGTK, WHAT -DISTRIBUTION YOU USE AND WHAT ERROR WAS REPORTED. I know this has no effect, -but I tried... - * GUI libraries --------------- -wxWidgets/GTK requires the GTK+ library to be installed on your system. It has +wxWidgets/GTK+ requires the GTK+ library to be installed on your system. It has to be a stable version, preferably version 1.2.10 (at least 1.2.3 is required, 1.2.7 is strongly recommended). -You can get the newest version of the GTK+ from the GTK homepage at: +You can get the newest version of the GTK+ from the GTK+ homepage at: http://www.gtk.org @@ -278,8 +237,8 @@ you download wxGTK, it will default to --with-gtk etc. But if you use all of our CVS repository you have to choose a toolkit. You must do this by running configure with either of: - --with-gtk Use the GIMP ToolKit (GTK). Default. - + --with-gtk=2 Use the GTK+ 2.0. Default. + --with-gtk=1 Use the GTK+ 1.2. --with-motif Use either Motif or Lesstif Configure will look for both. @@ -300,6 +259,8 @@ The following options handle the kind of library you want to build. such as Sun with gcc 2.8.X which would otherwise produce segvs. + --enable-unicode Enable Unicode support. + --enable-profile Add profiling info to the object files. Currently broken, I think. @@ -465,9 +426,6 @@ minimal.o: minimal.cpp mondrian.xpm clean: rm -f *.o minimal -This is certain to become the standard way unless we decide -to stick to tmake. - If your application uses only some of wxWidgets libraries, you can specify required libraries when running wx-config. For example, `wx-config --libs=html,core` will only output link command to link