wxWidgets/docs/contributing/about-version-numbers.md
Vadim Zeitlin e96b28181c Convert contributors documentation to markdown.
The conversion is very superficial and there are probably many problems in the
Markdown rendering, but this is the first step towards making these documents
more readable when viewing them online.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@76690 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2014-06-11 21:14:09 +00:00

1.7 KiB

All about wxWidgets Version Numbers

Where to update the version numbers

There are several places in the wxWidgets source tree that define the version number for the library.

The script misc/scripts/inc_release can be used for incrementing the release field of the version, i.e. changing 2.8.x to 2.8.x+1 but it does not take care of version.bkl and can't be used for changing the other version components, this needs to be done manually. It also doesn't update version.bkl file which always needs to be updated manually, follow the instructions there.

Here is the list of files that need to be updated:

build/bakefiles/version.bkl {C:R:A}          [NOT UPDATED AUTOMATICALLY]
build/bakefiles/wxpresets/presets/wx.bkl     [NOT UPDATED AUTOMATICALLY]
configure.in
build/osx/wxvers.xcconfig
docs/changes.txt
docs/readme.txt (date needs manual editing)  [NOT UPDATED AUTOMATICALLY]
docs/doxygen/Doxyfile (PROJECT_NUMBER and DOCSET_FEEDNAME)
docs/doxygen/latexdocstart.inc
docs/doxygen/mainpages/manual.h (just date)  [NOT UPDATED AUTOMATICALLY]
docs/msw/install.txt {major release only}
include/wx/version.h
include/wx/osx/config_xcode.h
samples/Info.plist
samples/docview/Info.plist
samples/minimal/Info_carbon.plist
samples/minimal/Info_cocoa.plist
samples/minimal/borland_ide.cpp {major release only}

Do not forget to rebake everything after updating version.bkl!

When to update the version numbers

Version should be updated immediately after releasing the previous version so that the sources in the repository always correspond to the next release and not the past one.

See also binary compatibility notes