Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update some documentation to reflect change of default GTK version for configure

Browse Source 
Make some other feeble attempts to update these very outdated files, including
dropping '+' from GTK, and most references to GTK 1.
This commit is contained in:
Paul Cornett
2020-04-25 08:39:42 -07:00
parent c385676610
commit 9f3ad89ba9
2 changed files with 23 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/doxygen/mainpages/platdetails.h
View File

@@ -23,34 +23,26 @@ platforms and ports.
@section page_port_wxgtk wxGTK @section page_port_wxgtk wxGTK
wxGTK is a port of wxWidgets using the GTK+ library. It makes use of GTK+'s wxGTK is a port of wxWidgets using the GTK library. It makes use of GTK's
native widgets wherever possible and uses wxWidgets' generic controls when native widgets wherever possible and uses wxWidgets' generic controls when
needed. GTK+ itself has been ported to a number of systems, but so far only the needed.
original X11 version is supported. Support for other GTK+ backends is planned,
such as the new DirectFB backend.
All work is being done on GTK+ version 2.0 and above. Support for GTK+ 1.2 will You will need GTK 2.6 or higher which is available from:
be deprecated in a later release.
You will need GTK+ 2.6 or higher which is available from:
http://www.gtk.org http://www.gtk.org
The newer version of GTK+ you use, the more native widgets and features will be The newer version of GTK you use, the more native widgets and features will be
utilized. We have gone to great lengths to allow compiling wxWidgets utilized. We have gone to great lengths to allow compiling wxWidgets
applications with the latest version of GTK+, with the resulting binary working applications with the latest version of GTK, with the resulting binary working
on systems even with a much earlier version of GTK+. You will have to ensure on systems even with a much earlier version of GTK. You will have to ensure
that the application is launched with lazy symbol binding for that. that the application is launched with lazy symbol binding for that.
In order to configure wxWidgets to compile wxGTK you will need use the In order to configure wxWidgets to compile wxGTK you will need to use the
@c \--with-gtk argument to the @c configure script. This is the default for many @c \--with-gtk argument to the @c configure script. This is the default for many
systems. systems.
GTK+ 1.2 can still be used, albeit discouraged. For that you can pass Support for GTK 3 is available starting with wxWidgets 2.9.4, and is the default
@c \--with-gtk=1 to the @c configure script. starting with 3.1.4. Use @c configure option @c \--with-gtk=2 to use GTK 2.
Support for GTK+ 3 is available starting with wxWidgets 2.9.4, use @c configure
option @c \--with-gtk=3 to enable it.
@subpage plat_gtk_install "Build and Install Instructions" @subpage plat_gtk_install "Build and Install Instructions"

34
docs/gtk/install.md
View File

@@ -1,4 +1,4 @@
wxWidgets for GTK+ installation {#plat_gtk_install} wxWidgets for GTK installation {#plat_gtk_install}
------------------------------- -------------------------------
[TOC] [TOC]
@@ -13,7 +13,7 @@ IMPORTANT NOTE:
When sending bug reports tell us what version of wxWidgets you are When sending bug reports tell us what version of wxWidgets you are
using (including the beta) and what compiler on what system. One using (including the beta) and what compiler on what system. One
example: wxGTK 3.0.0, GCC 4.8.1, Fedora 19 example: wxGTK 3.0.5, GCC 9.3.1, Fedora 31
Installation {#gtk_install} Installation {#gtk_install}
============ ============
@@ -44,20 +44,20 @@ If you want to remove wxWidgets on Unix you can do this:
> make uninstall > make uninstall
> ldconfig > ldconfig
Note that by default, GTK+ 2.x is used. GTK+ 3 can be specified Note that by default, GTK 3 is used. GTK 2 can be specified
with --with-gtk=3. with --with-gtk=2.
The expert case {#gtk_expert} The expert case {#gtk_expert}
----------------- -----------------
If you want to do some more serious cross-platform programming with wxWidgets, 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 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 them concurrently. To do this, create a separate directory for each build
of wxWidgets - you may also want to create different versions of wxWidgets of wxWidgets - you may also want to create different versions of wxWidgets
and test them concurrently. Most typically, this would be a version configured and test them concurrently. Most typically, this would be a version configured
with --enable-debug and one without. with --enable-debug and one without.
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: source) you'd do this:
mkdir buildmotif mkdir buildmotif
@@ -87,13 +87,13 @@ The simplest errors {#gtk_errors_simple}
For any configure errors: please look at config.log file which was generated For any configure errors: please look at config.log file which was generated
during configure run, it usually contains some useful information. during configure run, it usually contains some useful information.
configure reports, that you don't have GTK+ 1.2/2.0/3.0 installed although you configure reports, that you don't have GTK 1.2/2.0/3.0 installed although you
are very sure you have. Well, you have installed it, but you also have another 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 a non-default versions of glib (and its headers). Or maybe you installed it in a non-default
location and configure can't find it there, so please check that your PATH location and configure can't find it there, so please check that your PATH
variable includes the path to the correct gtk-config/pkg-config. Also check variable includes the path to the correct gtk-config/pkg-config. Also check
that your LD_LIBRARY_PATH or equivalent variable contains the path to GTK+ that your LD_LIBRARY_PATH or equivalent variable contains the path to GTK
libraries if they were installed in a non-default location. libraries if they were installed in a non-default location.
You get errors from make: please use GNU make instead of the native make You get errors from make: please use GNU make instead of the native make
@@ -122,18 +122,12 @@ Now create your super-application myfoo.cpp and compile anywhere with
GUI libraries {#gtk_libs_gui} GUI libraries {#gtk_libs_gui}
--------------- ---------------
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.
to be a stable version, preferably GTK+ 2.x.y, where x is an even number.
GTK+ version 1.2 is highly discouraged, but if you decide to still use it,
please use 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 GTK from the GTK homepage at:
http://www.gtk.org http://www.gtk.org
We also mirror GTK+ at my ftp site. You'll find information about downloading
at my homepage.
Additional libraries {#gtk_libs_misc} Additional libraries {#gtk_libs_misc}
---------------------- ----------------------
@@ -202,9 +196,9 @@ you download wxGTK, it will default to --with-gtk etc. But
if you use the git repository you have to choose a toolkit. if you use the git repository you have to choose a toolkit.
You must do this by running configure with either of: You must do this by running configure with either of:
--with-gtk=2 Use the GTK+ 2.0. Default. --with-gtk=3 Use GTK 3. Default.
--with-gtk=3 Use the GTK+ 3. --with-gtk=2 Use GTK 2.
--with-gtk=1 Use the GTK+ 1.2. --with-gtk=1 Use GTK 1.2.
The following options handle the kind of library you want to build. The following options handle the kind of library you want to build.