Commit Graph
1036 Commits
Author SHA1 Message Date
Vadim Zeitlin b5de46c044 Merge branch 'update-contributors'
Update contributors list for 3.2 release.

See #22593.
2022-07-05 01:40:21 +02:00
Vadim ZeitlinandMaarten Bent 6c65510a2c Warn about using find_package(wxWidgets) with older CMake
Provide a link to the latest and working version of this file.

See #22590.

Closes #22594.

Co-Authored-By: Maarten Bent <MaartenBent@users.noreply.github.com>
2022-07-04 01:20:26 +02:00
Vadim Zeitlin 9ad06f4b81 Update contributors list for 3.2.0
Also move some historical contributors to a separate section.
2022-07-02 19:21:56 +02:00
Vadim Zeitlin 976edaf026 Merge branch 'doxygen-css'
Switch to using Doxygen 1.9.1 with custom theme for the documentation.

Closes #18849.
2022-07-02 17:39:06 +02:00
Vadim Zeitlin ba7894fca4 Disable custom Doxygen theme support for CHM generation
Unsurprisingly, this doesn't work at all with CHM, so allow disabling
using the custom theme when doing it by adding more custom variables.

Using (multiple) variables for this is rather ugly, but we already use
them for other options, so it seems better to keep adding them rather
than using some other mechanism.

Adding a different custom header file is even uglier, but it seems to be
the only way to avoid including the theme JS files into CHM.
2022-07-02 17:37:53 +02:00
Vadim Zeitlin 1a53e80bf7 Use Doxygen Awesome CSS theme
Import the theme files into a subdirectory without any changes, even not
removing the trailing whitespace, to facilitate updating them in the
future. Do not add the theme as a submodule as it's surprisingly big
(~12MB) and we don't want to spend extra time on cloning it in each of
our CI builds.

Using this theme gives a nicer appearance and supports the often
requested dark mode.

Remove all colour-related options from the existing custom CSS file as
they don't work well in dark mode.

Also switch to using SVGs with transparent background, rather than PNGs,
for the class diagrams, to avoid background colour mismatch in dark
mode.
2022-07-02 16:57:57 +02:00
Vadim Zeitlin 3c7596f0ff Switch to using Doxygen 1.9.1 for the documentation generation
This fixes the problem with empty descriptions in the annotated class
list and is a prerequisite for using custom CSS theme in the upcoming
commits.

Closes #22288.
2022-07-02 16:10:21 +02:00
Vadim Zeitlin f2e7f6a917 Fix wrong XML fragment syntax highlighting in liblzma docs
Turn off syntax highlighting entirely because using ".xml" here results
in total garbage in output for some reason (while not using any specific
language uses C++ highlighting which is confusing).
2022-07-02 16:06:29 +02:00
Vadim Zeitlin 332e1576a5 Revert "Remove the mention of non-existent translators mailing list"
This reverts commit 155d8546cb as we now
use the translators mailing list again.
2022-07-02 15:18:45 +02:00
Vadim Zeitlin 844e51e672 Revert "Temporarily change the release to 3.2.0-rc1"
This reverts commit 4a286c1868 to set the
version to 3.2.0 again.
2022-06-30 00:21:33 +02:00
Vadim Zeitlin b44b4ee78b Fix size of the requested bitmap bundle in wxToolBar XRC handler
We need to pass the physical size, not scaled by DPI, as the "size"
parameter of GetBitmapBundle(), so that a user-defined art provider
could use it to select one of the available bitmap sizes (which will
then be scaled, if necessary, by wxBitmapBundle itself).

This change is not 100% backwards-compatible because, in theory, bitmap
sizes could be specified using dialog units previously, but this is not
supported any more. However in practice this never happened because it
simply doesn't make sense to use dialog units for the bitmap sizes and
it doesn't seem worth complicating the code by adding another XRC type
of "DPI-independent pixels that can be expressed in dialog units",
especially considering that DUs are DPI-dependent by definition.

See #22584.
2022-06-29 22:32:25 +02:00
Vadim Zeitlin 4a286c1868 Temporarily change the release to 3.2.0-rc1
This commit will be simply reverted before the final 3.2.0 release.
2022-06-27 17:19:35 +02:00
Vadim Zeitlin 2a2308d5ed Update version to 3.2.0 and rebake and rerun autoconf
Update all make/project files to use 3.2.0.
2022-06-21 00:54:26 +02:00
Vadim Zeitlin 03293ae8e2 Update release documents for 3.2.0
The main change is that it's now described as the new stable release and
not a development one any more.
2022-06-21 00:54:26 +02:00
Randalphwa 09b2488577 Add support for empty call size to wxGridBagSizer XRC handler
Add empty_cellsize property.

Closes #22541.
2022-06-20 00:36:47 +02:00
Randalphwa a0bdcc0d0f Support additional wxWizard properties in XRC
Add support for border, bitmap placement, minimum width and background.

Closes #22539.
2022-06-20 00:35:32 +02:00
Randalphwa 385547a946 Add support for SetArtProvider in wxAuiNotebook XRC handler
Allow selecting between the "default" and "simple" providers for now, we
might want to extend this to allow user-defined providers in the future.

Closes #22515.
2022-06-16 12:59:58 +01:00
Vadim Zeitlin 08cd516749 Document that clang is required for building wxOSX
Due to the use of Apple-specific extensions in the SDK headers, gcc
can't be used to compile wxOSX any more.

Closes #22519.
2022-06-15 03:07:11 +02:00
Randalphwa 8083c9440c Minor fixes to XRC format overview
Fix missing option description, wrong handler name in an example.

Closes #22503.
2022-06-10 18:14:35 +02:00
Vadim Zeitlin ddd6b34cf3 Drop support for 32-bit wxOSX/Cocoa build
wxOSX doesn't build in 32 bits since quite some time and it doesn't seem
worth fixing this, so just ensure that we give a clear build error in
this case instead of multiple and less clear errors further down the
build process.

Also remove the now unnecessary checks for __LP64__ from wxOSX code.
2022-06-07 00:46:59 +02:00
Vadim Zeitlin b87ad8a51c Update release documents for 3.1.7 release
Set release date for 2022-06-06, update versions and lists of changes in
various places.
2022-06-05 20:54:21 +02:00
Vadim Zeitlin e13b4f8833 Don't force fractional scale when toolbar bitmap size is given
The old code in wxToolBarBase::AdjustToolBitmapSize() forced the use of
the exact value of the requested bitmap size multiplied by the current
scale factor, which resulted in ugly bitmaps whenever fractional scaling
factor was used. It also used not immediately clear IncTo() call.

Simplify and improve it by handling the cases when we have a requested
bitmap size and we don't have it differently: if we do have it, just use
it directly, but only with an integer scale factor. And if we don't,
then simply use the bitmap size suitable for the current scale factor.

This seems to result in the most expected behaviour and, notably,
doesn't break the toolbar sample where the bitmap size can still be
toggled between small and big bitmaps on both normal and high DPI
monitors.

Also update the documentation: still recommend not to use
SetToolBitmapSize() at all, but don't claim that it forces fractional
scaling, as this is not the case any longer.
2022-06-05 03:23:03 +02:00
Vadim Zeitlin 34fa234f48 Merge branch 'bmpbndl-scaling'
Improve wxBitmapBundle scaling logic by limiting it to integer scaling
factors and ensure it's consistent for files and MSW resources.

See #22481.
2022-06-04 18:36:50 +01:00
Vadim Zeitlin 98635d1ef8 Document some issues involved in adding high DPI support
Notably mention that wxToolBar::SetToolBitmapSize() shouldn't be used.
2022-06-03 01:33:31 +01:00
Randalphwa cb8c0dfb0d Add undetermined state to wxCheckBoxXmlHandler
3-state checkboxes can have their initial value set to checked
or undetermined -- this adds support for the undetermined
state to the handler (only allowed if the style includes wxCHK_3STATE).

Closes #22468.
2022-06-01 16:55:31 +02:00
Randalphwa 080b0f65cb Fix wxCommandLinkButton alphabetical position
The alphabetical order for this handler was wrong, affecting not
only it's placement in the main HTML page, but also the list of
handlers on the right side.

This commit is best viewed with git --color-moved option.

Closes #22478.
2022-06-01 15:51:53 +02:00
Randalphwa addbc940c0 Update wxCommandLinkButtonXmlHandler
Adds missing bitmap specifications, removes unusable button styles.

Closes #22475.
2022-06-01 15:47:03 +02:00
Randalphwa 8f735c695b Support more styles, bitmaps, margins in wxToggleButtonXmlHandler
Add missing styles, bitmaps, and margin property.

Closes #22474.
2022-05-30 23:54:47 +02:00
Randalphwa 6ce81acda8 Add digits property to wxSpinCtrlDoubleXmlHandler
This makes it possible to set the precision of the number
without changing the increment amount.

Closes #22470.
2022-05-30 17:53:43 +02:00
Randalphwa d9f36adc8f Minor fixes to wxRichTextCtrlXmlHandler code and docs
Fix the example showing how to use it in the docs.

Don't use "maxlength" property for this control, as it's ignored by it
anyhow.

Closes #22467.
2022-05-30 17:52:14 +02:00
Randalphwa f2c78e19e4 Fix incorrect coding of "\" in Doxygen comments
This commit fixes a formatting problem with these two files
when built with Doxygen version 1.9.3.

The correct encoding is to escape the quotes and the backslash.
While the older style encoding used to work, it is no longer
supported due to a fix with how a single quote gets handled
by Doxygen. The escaped version works with Doxygen 1.8.17
so this will work fine with the current build version as well as
in more recent versions (tested with 1.9.3).

Closes #22461.
2022-05-27 18:25:49 +02:00
Randalphwa 339282ccab Use @since for wxWidgets version in XRC doc
This is just to make all the version information consistent within this
file. This is primarily for properties that were added in a specific
wxWidgets version.

Closes #22456.
2022-05-27 01:02:07 +02:00
Randalphwa 76d1b3c9a9 Extend wxBitmap XRC handler to support all button attributes
Add support for the missing wxBU_NOTEXT style, bitmaps for the other
than default states (pressed, focus, disabled and current) and margins
to wxBitmapXmlHandler.

Note that the images for the other states were previously already
supported by wxBitmapButton XRC handler, but not by the wxBitmap one,
even though both bitmap classes support them.

Closes #22451.
2022-05-25 15:33:31 +02:00
Vadim Zeitlin 01c8978690 Merge branch 'docs-events' of https://github.com/PBfordev/wxWidgets
Several improvements to the event-related docs.

See #22448.
2022-05-23 22:31:34 +01:00
PB eb5820f93a Correct Events and Event Handling overview
Change "order" to "reverse order" in "... dynamically bound handlers
are searched in order of their registration ...".

Use better check for C++11 in a code example.

Unify whitespace usage in code examples.
2022-05-23 18:40:56 +02:00
taler21 4b9721536c Center the print preview frame after fully creating it
Center the frame correctly in the sample and demonstrate the right way
to do it in the documentation.
2022-05-23 15:07:06 +01:00
Vadim Zeitlin f96789c1fd Don't hardcode wxPreviewFrame size in the documentation
This is a bad idea and it's better to let the frame determine its own
best size.
2022-05-20 23:53:38 +01:00
Vadim Zeitlin f81e73b9b1 Document that wxUSE_NANOSVG is available starting in 3.1.7 only
Don't bother repeating it for wxUSE_NANOSVG_EXTERNAL as it should be
clear enough that this option doesn't make sense without wxUSE_NANOSVG
anyhow.
2022-05-11 02:32:22 +02:00
Maarten Bent ce32faa563 Document the NanoSVG options 2022-05-11 01:55:20 +02:00
Vadim Zeitlin a473a5746a Add Windows 11 to support MSW versions in the documentation
Update (hopefully all) the other enumerations of MSW versions to include
Windows 11 too.
2022-04-19 00:52:40 +02:00
Vadim Zeitlin 0407d74eaa Remove __WXSTUBS__ mention and test
This has never really been a thing and there remained just one (never
used) test for it in the sources, so simply remove it.

No real changes.
2022-04-14 00:40:36 +02:00
Vadim Zeitlin 19e3a47d98 Update version to 3.1.7 and rebake the makefiles
Make it possible to distinguish the latest master from 3.1.6 before
making any changes.

Closes #22282.
2022-04-07 17:40:13 +02:00
Vadim Zeitlin 1990792484 Update the release documents for 3.1.6 release
Update the version, fix the date and update the changes list.

Also zero out the checksums for the release binaries.
2022-04-04 01:16:33 +02:00
Vadim Zeitlin c63de862c4 Actually use WX_HTML_OUTPUT_DIR in Doxyfile
This should have been part of efa1c59141 (Allow setting
WX_HTML_OUTPUT_DIR to override default location, 2022-03-28) but was
forgotten there.
2022-03-30 16:35:45 +02:00
Vadim Zeitlin efa1c59141 Allow setting WX_HTML_OUTPUT_DIR to override default location
This allows to avoid making custom changes when generating the docs on
docs.wxwidgets.org and can be more generally useful too.
2022-03-28 15:43:32 +02:00
Vadim Zeitlin cd4d9011b7 Fix appearance of search results when using server-based search
Use fixed Doxygen PHP search functions to work around Doxygen bug
https://github.com/doxygen/doxygen/issues/7892 which affected our docs
too.

Closes #19276.
2022-03-28 15:29:50 +02:00
Vadim Zeitlin 20b8ba1773 Add extra script to the docs created in GitHub Actions workflow
This was done by the cron job running in docs.wxwidgets.org before, so
keep doing it here.
2022-03-28 11:16:53 +02:00
Vadim Zeitlin 70e119140c Merge branch 'win-transparency'
Improve shaped sample and its documentation.

See #22230.
2022-03-28 00:16:31 +01:00
Vadim Zeitlin c1ee60395a Change supported Doxygen version to 1.8.17
This is the version available in Ubuntu 20.04 which is currently used
both on docs.wxwidgets.org and in GitHub Actions Ubuntu environment, so
it looks like a reasonable choice, even though the latest version is
1.9.3.

Note that the versions earlier than 1.8.14 can't be used any longer
since the changes in the previous commit because "^^" in the aliases
definition don't work in them and result in garbled output.
2022-03-28 00:43:05 +02:00
Vadim Zeitlin 398af094cf Use "^^" instead of "\n" in Doxygen aliases
This is required with any version after 1.8.14.

Closes #2068.
2022-03-28 00:24:44 +02:00