X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/408ee837a89ba356ca46bcdbc07536c75f2a3ebe..7a36d9c7c1a077ba7e05c248bcf19c4c9bb1356f:/docs/tech/tn0022.txt diff --git a/docs/tech/tn0022.txt b/docs/tech/tn0022.txt index e1e3e11d71..65bfbb1c87 100644 --- a/docs/tech/tn0022.txt +++ b/docs/tech/tn0022.txt @@ -7,6 +7,12 @@ Before making the release Update docs/readme.txt. Please review its contents in addition to just changing the version number. +Put a date on the release line in docs/changes.txt. + +Update the date in the manual (docs/doxygen/mainpages/manual.h). + +Update the release announcement post in docs/publicity/announce.txt. + Creating release files ---------------------- @@ -32,6 +38,18 @@ IMPORTANT NOTE: You *must* run this script from a clean source tree, that is, release. If you have legitimate modifications in the tree that need to be in the release, commit them first. +To generate the windows installer (.exe) and the documentation files (chm and htb formats) +run: + +build\tools\bld_chm_exe.bat + +which depends on the wxwidgets.iss file, and generates output in the %DAILY% directory. It +assumes a clean copy of the wxWidgets source tree in %INNO%. Temporary files will be generated +in the tree from which the batch file is run. It depends on doxygen, a number of gnu +win32 tools and Microsofts htmlhelp compiler. The wxwidgets.iss file should not need +editing, but you will want to check that the bld_chm_exe.bat has the correct version number. + + Alternative non official release scripts ---------------------------------------- @@ -50,9 +68,41 @@ of lines conversions. To use it you need to run Uploading --------- -Upload the files to SourceForge (the simplest is to scp them to -sfusername,wxwindows@frs.sf.net:/home/frs/project/w/wx/wxwindows/x.y.z) and to -ftp.wxwidgets.org (ask Chris to do it). +Upload the files to SourceForge. This can be done via the web interface or just +scp to sfusername,wxwindows@frs.sf.net:/home/frs/project/w/wx/wxwindows/x.y.z +The following files need to be uploaded: + + wxMSW-Setup-2.9.3.exe + wxWidgets-x.y.z.7z + wxWidgets-x.y.z.tar.bz2 + wxWidgets-x.y.z.zip + wxWidgets-x.y.z_Headers.zip + wxWidgets-docs-chm-x.y.z.zip + wxWidgets-docs-html-x.y.z.tar.bz2 + wxWidgets-docs-html-x.y.z.zip + +You will need to use the web interface to mark the latest uploaded files as +being "default downloads" for the appropriate platforms (.zip or .exe for MSW, +.tar.bz2 for everything else) as otherwise SourceForge would continue to suggest +people to download old files. + +Next, update (at least the versions and SHA1 sums, but maybe more) and upload +docs/release_files.mdwn and docs/release_binaries.mdwn files. They need to be +renamed to README.md on SF to be shown when the directory is viewed, i.e. do: + + scp docs/release_files.mdwn \ + sfuser,wxwindows@frs.sf.net:/home/frs/project/w/wx/wxwindows/x.y.z/README.md + scp docs/release_binaries.mdwn \ + sfuser,wxwindows@frs.sf.net:/home/frs/project/w/wx/wxwindows/x.y.z/binaries/README.md + +And upload the change log too: + + scp docs/changes.txt \ + sfuser,wxwindows@frs.sf.net:/home/frs/project/w/wx/wxwindows/x.y.z + + +Also upload the files to the FTP mirror at ftp.wxwidgets.org (ask Chris for +access if you don't have it). Create http://docs.wxwidgets.org/x.y.z/ (ask Bryan to do it if not done yet). @@ -60,13 +110,15 @@ Create http://docs.wxwidgets.org/x.y.z/ (ask Bryan to do it if not done yet). Announcement ------------ -Post announcement at least to wx-announce@googlegroups.com. +Post docs/publicity/announce.txt at least to wx-announce@googlegroups.com. TODO: where else to announce it? Update www.wxwidgets.org, usually a news item is enough but something more can be called for for major releases. +Also update downloads/index.html to mention the new latest release. + Post to wxBlog if necessary. @@ -74,8 +126,8 @@ Version updates --------------- Trac: mark the milestone corresponding to the release as completed and add a -new version for it to allow reporting bugs against it (ask Vadim or Robin to do -it). +new version for it to allow reporting bugs against it and create the next +milestone (ask Vadim or Robin to do it or to get admin password). Run misc/scripts/inc_release to increment micro version, i.e. replace x.y.z with x.y.z+1 (minor or major versions updates require manual intervention).