From 415f16b22e490026e0ff9d5ae0f3661c6a532330 Mon Sep 17 00:00:00 2001 From: PB Date: Tue, 8 Dec 2020 15:57:54 +0100 Subject: [PATCH 1/4] Update Platform Details overview Remove information that is no longer relevant or important. Replace "http" with "https" everywhere. --- docs/doxygen/mainpages/platdetails.h | 33 ++++++++++++---------------- 1 file changed, 14 insertions(+), 19 deletions(-) diff --git a/docs/doxygen/mainpages/platdetails.h b/docs/doxygen/mainpages/platdetails.h index ff217348a0..f1d0dd66bd 100644 --- a/docs/doxygen/mainpages/platdetails.h +++ b/docs/doxygen/mainpages/platdetails.h @@ -29,7 +29,7 @@ needed. You will need GTK 2.6 or higher which is available from: -http://www.gtk.org +https://www.gtk.org 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 @@ -41,8 +41,8 @@ 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 systems. -Support for GTK 3 is available starting with wxWidgets 2.9.4, and is the default -starting with 3.1.4. Use @c configure option @c \--with-gtk=2 to use GTK 2. +GTK 3 is the default starting with wxWidgets 3.1.4. +Use @c configure option @c \--with-gtk=2 to use GTK 2. @subpage plat_gtk_install "Build and Install Instructions" @@ -73,16 +73,11 @@ In order to configure wxWidgets to compile wxX11 you will need to type: @subpage plat_x11_install "Build Instructions" -There is also a page on the use of wxWidgets for embedded -applications on the wxWidgets web site. - @section page_port_wxmotif wxMotif -wxMotif is a port of wxWidgets for X11 systems using Motif libraries. Motif -libraries provide a clean and fast user interface at the expense of the beauty -and candy of newer interfaces like GTK. +wxMotif is a port of wxWidgets for X11 systems using Motif libraries. @subpage plat_motif_install "Build Instructions" @@ -93,9 +88,9 @@ and candy of newer interfaces like GTK. wxMSW is a port of wxWidgets for the Windows platforms (Windows XP and later are supported). wxMSW provides native look and feel for each Windows version. -This port can be compiled with several compilers including Microsoft Studio -VC++ 2003 or later, MinGW32, Cygwin as well as cross-compilation with a -Linux-hosted MinGW32 tool chain. +This port can be compiled with several compilers including Microsoft +VC++ 2003 or later, MinGW, Cygwin as well as cross-compilation with a +Linux-hosted MinGW tool chain. @subpage plat_msw_install "Build and Install Instructions" @@ -180,13 +175,13 @@ used by wxWidgets to e.g. use toolkit-specific features. In such case (or when you want to e.g. write a port-specific patch) it can be necessary to use the underlying toolkit API directly: -- wxMSW port uses win32 API: see MSDN docs at http://msdn2.microsoft.com/en-us/library/ms649779.aspx +- wxMSW port uses Win32 API: see MSDN docs at https://msdn2.microsoft.com/en-us/library/ms649779.aspx - wxGTK port uses GTK+ and other lower-level libraries; see - - GTK+ docs at http://library.gnome.org/devel/gtk/unstable/ - - GDK docs at http://library.gnome.org/devel/gdk/unstable/ - - GLib docs at http://library.gnome.org/devel/glib/unstable/ - - GObject docs at http://library.gnome.org/devel/gobject/unstable/ - - Pango docs at http://library.gnome.org/devel/pango/unstable/ -- wxOSX port uses the Cocoa API: see Cocoa docs at http://developer.apple.com/cocoa + - GTK+ docs at https://library.gnome.org/devel/gtk/unstable/ + - GDK docs at https://library.gnome.org/devel/gdk/unstable/ + - GLib docs at https://library.gnome.org/devel/glib/unstable/ + - GObject docs at https://library.gnome.org/devel/gobject/unstable/ + - Pango docs at https://library.gnome.org/devel/pango/unstable/ +- wxOSX port uses the Cocoa API: see Cocoa docs at https://developer.apple.com/cocoa */ From d4b84dbb3516b6aaf4d868fc809060090fac720f Mon Sep 17 00:00:00 2001 From: PB Date: Tue, 8 Dec 2020 17:24:53 +0100 Subject: [PATCH 2/4] Update as requested in review --- docs/doxygen/mainpages/platdetails.h | 46 +++------------------------- 1 file changed, 4 insertions(+), 42 deletions(-) diff --git a/docs/doxygen/mainpages/platdetails.h b/docs/doxygen/mainpages/platdetails.h index f1d0dd66bd..512fa8fda0 100644 --- a/docs/doxygen/mainpages/platdetails.h +++ b/docs/doxygen/mainpages/platdetails.h @@ -52,7 +52,7 @@ Use @c configure option @c \--with-gtk=2 to use GTK 2. wxOSX/Cocoa is the port of wxWidgets for the macOS platform. It requires a minimum SDK 10.11, Xcode 7.2.1 or greater (runs under 10.10.5 and higher), -and fully supports 64 bit builds and deploying under 10.10. +and fully supports amd64 as well ARM builds and deploying under 10.10. @subpage plat_osx_install "Build and Install Instructions" @@ -78,6 +78,7 @@ In order to configure wxWidgets to compile wxX11 you will need to type: @section page_port_wxmotif wxMotif wxMotif is a port of wxWidgets for X11 systems using Motif libraries. +It is no longer actively maintained and by now rather obsolete. @subpage plat_motif_install "Build Instructions" @@ -113,45 +114,6 @@ avoid this, ensure that the icon which is meant to be used as the main application icon has a name preceding "wxICON" in alphabetical order. -@subsection page_port_wxmsw_themedborders Themed Borders - -Starting with wxWidgets 2.8.5, you can specify the @c wxBORDER_THEME style to -have wxWidgets use a themed border. Using the default XP theme, this is a thin -1-pixel blue border, with an extra 1-pixel border in the window client -background colour (usually white) to separate the client area's scrollbars from -the border. - -If you don't specify a border style for a wxTextCtrl in rich edit mode, -wxWidgets now gives the control themed borders automatically, where previously -they would take the sunken border style. Other native controls such -as wxTextCtrl in non-rich edit mode, and wxComboBox already paint themed -borders where appropriate. To use themed borders on other windows, such as -wxPanel, pass the @c wxBORDER_THEME style, or (apart from wxPanel) pass no -border style. - -In general, specifying @c wxBORDER_THEME will cause a border of some kind to be -used, chosen by the platform and control class. To leave the border decision -entirely to wxWidgets, pass @c wxBORDER_DEFAULT. This is not to be confused -with specifying @c wxBORDER_NONE, which says that there should definitely be -@e no border. - -@subsubsection page_port_wxmsw_themedborders_details Internal Border Implementation - -The way that wxMSW decides whether to apply a themed border is as follows. The -theming code calls wxWindow::GetBorder() to obtain a border. If no border style -has been passed to the window constructor, GetBorder() calls GetDefaultBorder() -for this window. If wxBORDER_THEME was passed to the window constructor, -GetBorder() calls GetDefaultBorderForControl(). - -The implementation of wxWindow::GetDefaultBorder() on wxMSW calls -wxWindow::CanApplyThemeBorder() which is a virtual function that tells -wxWidgets whether a control can have a theme applied explicitly (some native -controls already paint a theme in which case we should not apply it ourselves). -Note that wxPanel is an exception to this rule because in many cases we wish to -create a window with no border (for example, notebook pages). So wxPanel -overrides GetDefaultBorder() in order to call the generic -wxWindowBase::GetDefaultBorder(), returning wxBORDER_NONE. - @section page_port_wxQt wxQt wxQt is a port of wxWidgets using Qt libraries. It requires Qt 5 or later. @@ -175,9 +137,9 @@ used by wxWidgets to e.g. use toolkit-specific features. In such case (or when you want to e.g. write a port-specific patch) it can be necessary to use the underlying toolkit API directly: -- wxMSW port uses Win32 API: see MSDN docs at https://msdn2.microsoft.com/en-us/library/ms649779.aspx +- wxMSW port uses Win32 API: see MSDN docs at https://docs.microsoft.com/en-us/windows/win32/controls/window-controls - wxGTK port uses GTK+ and other lower-level libraries; see - - GTK+ docs at https://library.gnome.org/devel/gtk/unstable/ + - GTK+ docs at https://developer.gnome.org/gtk/ - GDK docs at https://library.gnome.org/devel/gdk/unstable/ - GLib docs at https://library.gnome.org/devel/glib/unstable/ - GObject docs at https://library.gnome.org/devel/gobject/unstable/ From 688baa10973948d876722986e1def46c90928a7e Mon Sep 17 00:00:00 2001 From: PB Date: Tue, 8 Dec 2020 17:32:39 +0100 Subject: [PATCH 3/4] Remove the '+' from "GTK+" everywhere --- docs/doxygen/mainpages/platdetails.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/doxygen/mainpages/platdetails.h b/docs/doxygen/mainpages/platdetails.h index 512fa8fda0..6a9c602e6b 100644 --- a/docs/doxygen/mainpages/platdetails.h +++ b/docs/doxygen/mainpages/platdetails.h @@ -138,8 +138,8 @@ In such case (or when you want to e.g. write a port-specific patch) it can be necessary to use the underlying toolkit API directly: - wxMSW port uses Win32 API: see MSDN docs at https://docs.microsoft.com/en-us/windows/win32/controls/window-controls -- wxGTK port uses GTK+ and other lower-level libraries; see - - GTK+ docs at https://developer.gnome.org/gtk/ +- wxGTK port uses GTK and other lower-level libraries; see + - GTK docs at https://developer.gnome.org/gtk/ - GDK docs at https://library.gnome.org/devel/gdk/unstable/ - GLib docs at https://library.gnome.org/devel/glib/unstable/ - GObject docs at https://library.gnome.org/devel/gobject/unstable/ From 143142c045c33a51a660566deec9befd4c8e1353 Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Tue, 8 Dec 2020 23:26:52 +0100 Subject: [PATCH 4/4] Simplify links to all the other GTK libraries too There is no good reason to point to the latest unstable version. --- docs/doxygen/mainpages/platdetails.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/doxygen/mainpages/platdetails.h b/docs/doxygen/mainpages/platdetails.h index 6a9c602e6b..77a95e200c 100644 --- a/docs/doxygen/mainpages/platdetails.h +++ b/docs/doxygen/mainpages/platdetails.h @@ -140,10 +140,10 @@ necessary to use the underlying toolkit API directly: - wxMSW port uses Win32 API: see MSDN docs at https://docs.microsoft.com/en-us/windows/win32/controls/window-controls - wxGTK port uses GTK and other lower-level libraries; see - GTK docs at https://developer.gnome.org/gtk/ - - GDK docs at https://library.gnome.org/devel/gdk/unstable/ - - GLib docs at https://library.gnome.org/devel/glib/unstable/ - - GObject docs at https://library.gnome.org/devel/gobject/unstable/ - - Pango docs at https://library.gnome.org/devel/pango/unstable/ + - GDK docs at https://library.gnome.org/devel/gdk/ + - GLib docs at https://library.gnome.org/devel/glib/ + - GObject docs at https://library.gnome.org/devel/gobject/ + - Pango docs at https://library.gnome.org/devel/pango/ - wxOSX port uses the Cocoa API: see Cocoa docs at https://developer.apple.com/cocoa */