Difference between revisions of "Release 2.2.4"

From Lazarus wiki
Jump to navigationJump to search
m (removed)
 
(24 intermediate revisions by 8 users not shown)
Line 39: Line 39:
 
#  Update path and file names in /install/macosx/*.info for the new version
 
#  Update path and file names in /install/macosx/*.info for the new version
 
#  Finish all source file updates
 
#  Finish all source file updates
# convert /html/faq.fp to /install/doc/faq.htm and /install/doc/faq.txt
+
# <s>convert /html/faq.fp to /install/doc/faq.htm and /install/doc/faq.txt</s>
  
 
=== fpc-2.2.4rc1 ===
 
=== fpc-2.2.4rc1 ===
  
#  New directories
+
<s> New directories </s>
 
## <s> Create new directories on ftp (/pub/fpc/beta/X.Y.Z-rcN or /pub/fpc/dist/X.Y.Z and cpu-os under that) </s>
 
## <s> Create new directories on ftp (/pub/fpc/beta/X.Y.Z-rcN or /pub/fpc/dist/X.Y.Z and cpu-os under that) </s>
## Copy the extra files (asld*.zip, gdb*.zip, make*.zip) from previous release (unless updated with new versions)
+
## <s> Copy the extra files (asld*.zip, gdb*.zip, make*.zip) from previous release (unless updated with new versions) </s>
 
#  <s> Add new section for the upcoming build in /install/debian/changelog </s>
 
#  <s> Add new section for the upcoming build in /install/debian/changelog </s>
 
#  <s> Create new branch in SVN (release_X_Y_Z_rcN or release_X_Y_Z) </s>
 
#  <s> Create new branch in SVN (release_X_Y_Z_rcN or release_X_Y_Z) </s>
Line 60: Line 60:
 
## <s> fpcbuild-%{version}.tar.gz </s>
 
## <s> fpcbuild-%{version}.tar.gz </s>
 
#  Create and upload the documentation ([[Release engineering#Documentation building and LaTeX limits|more info]])
 
#  Create and upload the documentation ([[Release engineering#Documentation building and LaTeX limits|more info]])
## doc-pdf.zip
+
## <s> doc-pdf.zip </s>
## doc-html.zip
+
## <s> doc-html.zip </s>
 
## <i>doc-htm.zip</i> (not included)
 
## <i>doc-htm.zip</i> (not included)
## doc-txt.zip
+
## <s> doc-txt.zip </s>
## doc-ps.zip
+
## <s> doc-ps.zip </s>
## doc-pdf.tar.gz
+
## <s> doc-pdf.tar.gz </s>
## doc-html.tar.gz
+
## <s> doc-html.tar.gz </s>
## doc-ps.tar.gz
+
## <s> doc-ps.tar.gz </s>
 
#  Create and upload source zips
 
#  Create and upload source zips
## short name version for binary packages
+
## <s> short name version for binary packages </s>
 
## docs source (including link for short name version)
 
## docs source (including link for short name version)
 
## long name version for binary packages
 
## long name version for binary packages
Line 75: Line 75:
 
#* <s> i386-go32v2/basic zip (just binaries) (Giulio) </s>
 
#* <s> i386-go32v2/basic zip (just binaries) (Giulio) </s>
 
#* <s> i386-go32v2/full zip  (including docs and sources) (Giulio) </s>
 
#* <s> i386-go32v2/full zip  (including docs and sources) (Giulio) </s>
#* i386-os2/basic zip    (just binaries) (Tomas)
+
#* <s> i386-os2/basic zip    (just binaries) (Tomas) </s>
#* i386-os2/full zip    (including docs and sources) (Tomas)
+
#* <s> i386-os2/full zip    (including docs and sources) (Tomas) </s>
 
#* <s> i386-win32/exe </s>
 
#* <s> i386-win32/exe </s>
#* x86_64-win32/exe
+
#* x86_64-win64/exe
 
#* <s> arm-wince/exe (cross-release) </s>
 
#* <s> arm-wince/exe (cross-release) </s>
 
#* i386-freebsd/tgz
 
#* i386-freebsd/tgz
Line 87: Line 87:
 
#* x86_64-linux/deb      ([[Release engineering#Linux|more info]])
 
#* x86_64-linux/deb      ([[Release engineering#Linux|more info]])
 
#* <s> x86_64-linux/rpm      ([[Release engineering#Linux|more info]]) </s>
 
#* <s> x86_64-linux/rpm      ([[Release engineering#Linux|more info]]) </s>
#* powerpc-linux/tar    ([[Release engineering#Linux|more info]])
+
#* <s> powerpc-linux/tar    ([[Release engineering#Linux|more info]]) </s>
 
#* <s> powerpc-macosx/dmg (Jonas) </s>
 
#* <s> powerpc-macosx/dmg (Jonas) </s>
 
#* <s> powerpc-macosx/.info for fink (Mischi) </s>
 
#* <s> powerpc-macosx/.info for fink (Mischi) </s>
 
#* <s> i386-macosx/dmg (Jonas) </s>
 
#* <s> i386-macosx/dmg (Jonas) </s>
 
#* <s> i386-macosx/.info for fink (Mischi) </s>
 
#* <s> i386-macosx/.info for fink (Mischi) </s>
#* powerpc-macos
+
#* <s> powerpc-macos </s>
 
#* powerpc-morphos
 
#* powerpc-morphos
 
#* powerpc-amiga
 
#* powerpc-amiga
 
#* i386-netware
 
#* i386-netware
 
#* i386-netwlibc
 
#* i386-netwlibc
#* sparc-linux/tar      ([[Release engineering#Linux|more info]])
+
#* <s> sparc-linux/tar      ([[Release engineering#Linux|more info]]) </s>
 
#* sparc-sunos/tar
 
#* sparc-sunos/tar
 
#* arm-linux/tar (cross-release)
 
#* arm-linux/tar (cross-release)
Line 104: Line 104:
 
## Consider announcing availability of the new RC in fpc-devel list
 
## Consider announcing availability of the new RC in fpc-devel list
 
# Keep track of testing in [[Testers_2.2.4|the wiki]]
 
# Keep track of testing in [[Testers_2.2.4|the wiki]]
 
=== RC2 ===
 
 
#  Section for new RC on release pages in Wiki
 
## Release procedure
 
## Issue log
 
#  Look at unmerged changes in fpc and fpcbuild since the last RC and consider/ask for necessity of their inclusion in the release
 
  
 
=== Final release ===
 
=== Final release ===
  
#  Look at unmerged changes in fpc and fpcbuild since the last RC and consider/ask for necessity of their inclusion in the release (only cosmetic changes should be included, otherwise a new RC is needed instead of final release)
+
<s>Look at unmerged changes in fpc and fpcbuild since the last RC and consider/ask for necessity of their inclusion in the release (only cosmetic changes should be included, otherwise a new RC is needed instead of final release)</s>
 
+
#  New directories ([[Release engineering#Create_directories_on_ftp|more info]])
-- Template from above
+
## Create new directories on ftp (/pub/fpc/beta/X.Y.Z-rcN or /pub/fpc/dist/X.Y.Z and cpu-os under that)
 +
## <s>Copy the extra files (asld*.zip, gdb*.zip, make*.zip) from previous release (unless updated with new versions)</s>
 +
#  <s>Add new section for the upcoming build in /install/debian/changelog ([[Release engineering#Building_a_deb|more info]])</s>
 +
#  <s>Create new branch in SVN (release_X_Y_Z_rcN or release_X_Y_Z) ([[Release engineering#Tag_version|more info]])</s>
 +
#  <s>Update version number in release branch (and, if necessary also in main branch (trunk or fixes)) ([[Release engineering#Update_the_version-number|more info]])</s>
 +
## <s>/compiler/version.pas</s>
 +
## <s>/install/doc/readme.txt</s>
 +
## <s>/installer/install.dat (header)</s>
 +
## <s>/installer/install.pas (installer version)</s>
 +
## <s>/install/fpc.spec not necessary is done by macro</s>
 +
## <s>/docs/fpc.sty (macro fpcversion) not necessare, version is 2.2</s>
 +
## <s>All Makefile.fpc files containing version=... (plus regenerate all corresponding Makefiles)</s>
 +
## <s>All version-numbers in fpmake.pp files</s>
 +
#  Create and upload exported fpcbuild ([[Release engineering#Create_the_source_zips|more info]])
 +
## fpcbuild-%{version}.zip
 +
## fpcbuild-%{version}.tar.gz
 +
## fpc-%{version}-source.zip
 +
## fpc-%{version}-source.tar.gz
 +
#  Create and upload the documentation ([[Release engineering#Documentation building and LaTeX limits|more info]])
 +
## <s>doc-pdf.zip</s>
 +
## <s>doc-html.zip</s>
 +
## <i>doc-htm.zip</i> (not included)
 +
## <s>doc-txt.zip</s>
 +
## <s>doc-ps.zip</s>
 +
## <s>doc-pdf.tar.gz</s>
 +
## <s>doc-html.tar.gz</s>
 +
## <s>doc-ps.tar.gz</s>
 +
#  Create and upload source zips ([[Release engineering#Create_the_source_zips|more info]])
 +
## <s>short name version for binary packages</s> (done)
 +
## <s>docs source (including link for short name version)</s>
 +
## long name version for binary packages
 +
#  Create and upload binary releases (place the name of the person who aggreed to build a release behind the name of the target below)
 +
#* <s>i386-go32v2/basic zip (just binaries)</s> (done)
 +
#* <s>i386-go32v2/full zip  (including docs and sources)</s> (done)
 +
#* <s>i386-os2/basic zip    (just binaries)</s> (done)
 +
#* <s>i386-os2/full zip    (including docs and sources)</s> (done)
 +
#* i386-win32/exe - Florian
 +
#* x86_64-win64/exe - Florian
 +
#* arm-wince/exe (cross-release) - Florian
 +
#* <s>i386-freebsd/tgz - Marco</s> (done)
 +
#* i386-linux/tar        ([[Release engineering#Linux|more info]]) - Joost
 +
#* <s>i386-linux/deb</s>        ([[Release engineering#Linux|more info]]) - Mazen (done)
 +
#* i386-linux/rpm        ([[Release engineering#Linux|more info]]) - Joost
 +
#* x86_64-linux/tar      ([[Release engineering#Linux|more info]]) - Joost
 +
#* x86_64-linux/deb      ([[Release engineering#Linux|more info]]) - Joost
 +
#* x86_64-linux/rpm      ([[Release engineering#Linux|more info]]) - Joost
 +
#* <s>powerpc-linux/tar</s>    ([[Release engineering#Linux|more info]]) - Thomas (done)
 +
#* <s>powerpc64-linux/tar</s>  ([[Release engineering#Linux|more info]]) - Thomas (done)
 +
#* <s>powerpc-macosx/dmg</s>
 +
#* <s>i386-macosx/dmg</s>
 +
#*<s> powerpc-macosx/.info for fink</s> - Mischi (done)
 +
#*<s> i386-macosx/.info for fink</s> - Mischi (done)
 +
#* <i>powerpc-macos</i> (probably not available)
 +
#* sparc-linux/tar      ([[Release engineering#Linux|more info]])
 +
#* <s>sparc-linux/deb</s>      ([[Release engineering#Linux|more info]]) - Mazen (done)
 +
#* arm-linux/tar (cross-release)
 +
#* powerpc-morphos
 +
#* powerpc-amiga
 +
#* <i>i386-netware</i> (probably not available)
 +
#* <i>i386-netwlibc</i> (probably not available)
 +
#* sparc-sunos/tar
  
 
=== Going public ===
 
=== Going public ===
  
#  Make new version numbers (release plus next odd patch number for continuing fixes) available in bug tracker
+
<s> Make new version numbers (release plus next odd patch number for continuing fixes) available in bug tracker</s> (done)
 
#  Make new version numbers (release plus next odd patch number for continuing fixes) available in testsuite db
 
#  Make new version numbers (release plus next odd patch number for continuing fixes) available in testsuite db
 
#  Make new files on FTP available to wide public
 
#  Make new files on FTP available to wide public
Line 127: Line 180:
 
## upload files to SourceForge.net and add them to new "releases" for individual platforms
 
## upload files to SourceForge.net and add them to new "releases" for individual platforms
 
## make new "releases" on SourceForge.net accessible for users (change status to "active")
 
## make new "releases" on SourceForge.net accessible for users (change status to "active")
## Allow automated notifications on individual SourceForge.net file release pages to be sent
+
## Allow automated notifications on individual SourceForge.net file release pages to be sent <i>(done at least for OS/2 and GO32v2)</i>
#  Submit darwin packages to fink
+
<s>Submit darwin packages to fink</s> (done)
 
#  Update WWW pages
 
#  Update WWW pages
 
## /html/news.fp
 
## /html/news.fp
Line 153: Line 206:
 
#  Revise / update /html/future.fp after major versions (?.?.0)
 
#  Revise / update /html/future.fp after major versions (?.?.0)
 
#  Remove unneeded RC builds from FTP
 
#  Remove unneeded RC builds from FTP
 +
 +
[[Category:FPC release]]

Latest revision as of 20:22, 1 August 2012

Release Issues

The issues page is Issues 2.2.4

Release preparations

  1. Agree on deadline for changes and date for release candidate building
    1. #FPC-2.2.4rc1 deadline : Fri jan 2 2009
    2. #FPC-x.x.x deadline :
  2. Check the Detailed 2.2.4 Todo list for the particular release (should be linked from To Do lists) for status of individual todo items
  3. Check status of bugs assigned to that particular release in the bugtracker
  4. New page in Wiki named "Release_X.Y.Z" for release procedure with steps needed and their status (based on Release Template), at the beginning consisting of (at least) RC1 and final release sections
  5. Create new page in Wiki with issue log for documentation of issues encountered in release candidates and their status ("Issues_X.Y.Z" based on Issues Template)
  6. Ask platform maintainers and external maintainers about including their platforms/builds in the new release
  7. Check and update all .msg files
    1. errore.msg
    2. errord.msg
    3. errorf.msg
    4. errorn.msg
    5. errorr.msg
    6. errorrw.msg
    7. errorues.msg
    8. errores.msg
    9. errorct.msg
    10. errorhe.msg
    11. errorheu.msg
    12. errorptd.msg
    13. errorptw.msg
    14. errorpli.msg
    15. errorpl.msg
    16. errorid.msg
  8. Check tools
    1. Check version of the above mentioned tools (GNU tools, helper DLLs, UPX, etc.), and decide whether it isn't time to update some of these tools
    2. Repackage and upload additional tools where needed
  9. Update whatsnew.txt (/install/doc/whatsnew.txt)
  10. Find testers
    1. Create a testers page in Wiki (based on Testers Template)
    2. Ask in fpc-devel list for volunteers interested in testing the individual platforms / builds and list them on the newly created page (they can add themselves)
  11. Update path and file names in /install/macosx/*.info for the new version
  12. Finish all source file updates
  13. convert /html/faq.fp to /install/doc/faq.htm and /install/doc/faq.txt

fpc-2.2.4rc1

  1. New directories
    1. Create new directories on ftp (/pub/fpc/beta/X.Y.Z-rcN or /pub/fpc/dist/X.Y.Z and cpu-os under that)
    2. Copy the extra files (asld*.zip, gdb*.zip, make*.zip) from previous release (unless updated with new versions)
  2. Add new section for the upcoming build in /install/debian/changelog
  3. Create new branch in SVN (release_X_Y_Z_rcN or release_X_Y_Z)
  4. Update version number in release branch (and, if necessary also in main branch (trunk or fixes))
    1. /compiler/version.pas
    2. /install/doc/readme.txt
    3. /installer/install.dat (header)
    4. /installer/install.pas (installer version)
    5. /install/fpc.spec
    6. /docs/fpc.sty (macro fpcversion)
    7. All Makefile.fpc files containing version=... (plus regenerate all corresponding Makefiles)
  5. Create and upload exported fpcbuild
    1. fpcbuild-%{version}.zip
    2. fpcbuild-%{version}.tar.gz
  6. Create and upload the documentation (more info)
    1. doc-pdf.zip
    2. doc-html.zip
    3. doc-htm.zip (not included)
    4. doc-txt.zip
    5. doc-ps.zip
    6. doc-pdf.tar.gz
    7. doc-html.tar.gz
    8. doc-ps.tar.gz
  7. Create and upload source zips
    1. short name version for binary packages
    2. docs source (including link for short name version)
    3. long name version for binary packages
  8. Create and upload binary releases (place the name of the person who agreed to build a release behind the name of the target below)
    • i386-go32v2/basic zip (just binaries) (Giulio)
    • i386-go32v2/full zip (including docs and sources) (Giulio)
    • i386-os2/basic zip (just binaries) (Tomas)
    • i386-os2/full zip (including docs and sources) (Tomas)
    • i386-win32/exe
    • x86_64-win64/exe
    • arm-wince/exe (cross-release)
    • i386-freebsd/tgz
    • i386-linux/tar (more info)
    • i386-linux/deb (more info)
    • i386-linux/rpm (more info)
    • x86_64-linux/tar (more info)
    • x86_64-linux/deb (more info)
    • x86_64-linux/rpm (more info)
    • powerpc-linux/tar (more info)
    • powerpc-macosx/dmg (Jonas)
    • powerpc-macosx/.info for fink (Mischi)
    • i386-macosx/dmg (Jonas)
    • i386-macosx/.info for fink (Mischi)
    • powerpc-macos
    • powerpc-morphos
    • powerpc-amiga
    • i386-netware
    • i386-netwlibc
    • sparc-linux/tar (more info)
    • sparc-sunos/tar
    • arm-linux/tar (cross-release)
  9. Get it tested
    1. Ask dedicated testers for testing their platforms
    2. Consider announcing availability of the new RC in fpc-devel list
  10. Keep track of testing in the wiki

Final release

  1. Look at unmerged changes in fpc and fpcbuild since the last RC and consider/ask for necessity of their inclusion in the release (only cosmetic changes should be included, otherwise a new RC is needed instead of final release)
  2. New directories (more info)
    1. Create new directories on ftp (/pub/fpc/beta/X.Y.Z-rcN or /pub/fpc/dist/X.Y.Z and cpu-os under that)
    2. Copy the extra files (asld*.zip, gdb*.zip, make*.zip) from previous release (unless updated with new versions)
  3. Add new section for the upcoming build in /install/debian/changelog (more info)
  4. Create new branch in SVN (release_X_Y_Z_rcN or release_X_Y_Z) (more info)
  5. Update version number in release branch (and, if necessary also in main branch (trunk or fixes)) (more info)
    1. /compiler/version.pas
    2. /install/doc/readme.txt
    3. /installer/install.dat (header)
    4. /installer/install.pas (installer version)
    5. /install/fpc.spec not necessary is done by macro
    6. /docs/fpc.sty (macro fpcversion) not necessare, version is 2.2
    7. All Makefile.fpc files containing version=... (plus regenerate all corresponding Makefiles)
    8. All version-numbers in fpmake.pp files
  6. Create and upload exported fpcbuild (more info)
    1. fpcbuild-%{version}.zip
    2. fpcbuild-%{version}.tar.gz
    3. fpc-%{version}-source.zip
    4. fpc-%{version}-source.tar.gz
  7. Create and upload the documentation (more info)
    1. doc-pdf.zip
    2. doc-html.zip
    3. doc-htm.zip (not included)
    4. doc-txt.zip
    5. doc-ps.zip
    6. doc-pdf.tar.gz
    7. doc-html.tar.gz
    8. doc-ps.tar.gz
  8. Create and upload source zips (more info)
    1. short name version for binary packages (done)
    2. docs source (including link for short name version)
    3. long name version for binary packages
  9. Create and upload binary releases (place the name of the person who aggreed to build a release behind the name of the target below)
    • i386-go32v2/basic zip (just binaries) (done)
    • i386-go32v2/full zip (including docs and sources) (done)
    • i386-os2/basic zip (just binaries) (done)
    • i386-os2/full zip (including docs and sources) (done)
    • i386-win32/exe - Florian
    • x86_64-win64/exe - Florian
    • arm-wince/exe (cross-release) - Florian
    • i386-freebsd/tgz - Marco (done)
    • i386-linux/tar (more info) - Joost
    • i386-linux/deb (more info) - Mazen (done)
    • i386-linux/rpm (more info) - Joost
    • x86_64-linux/tar (more info) - Joost
    • x86_64-linux/deb (more info) - Joost
    • x86_64-linux/rpm (more info) - Joost
    • powerpc-linux/tar (more info) - Thomas (done)
    • powerpc64-linux/tar (more info) - Thomas (done)
    • powerpc-macosx/dmg
    • i386-macosx/dmg
    • powerpc-macosx/.info for fink - Mischi (done)
    • i386-macosx/.info for fink - Mischi (done)
    • powerpc-macos (probably not available)
    • sparc-linux/tar (more info)
    • sparc-linux/deb (more info) - Mazen (done)
    • arm-linux/tar (cross-release)
    • powerpc-morphos
    • powerpc-amiga
    • i386-netware (probably not available)
    • i386-netwlibc (probably not available)
    • sparc-sunos/tar

Going public

  1. Make new version numbers (release plus next odd patch number for continuing fixes) available in bug tracker (done)
  2. Make new version numbers (release plus next odd patch number for continuing fixes) available in testsuite db
  3. Make new files on FTP available to wide public
    1. update symlinks (no symlinks any more?)
    2. move the old version to the olddist/<version>
    3. upload files to SourceForge.net and add them to new "releases" for individual platforms
    4. make new "releases" on SourceForge.net accessible for users (change status to "active")
    5. Allow automated notifications on individual SourceForge.net file release pages to be sent (done at least for OS/2 and GO32v2)
  4. Submit darwin packages to fink (done)
  5. Update WWW pages
    1. /html/news.fp
    2. /html/down/* (links to all individual files & file sizes)
    3. /html/download.fp (version number and list of platforms)
    4. /html/fpc.fp
    5. /html/faq.fp (things like "the latest version is ...")
  6. Create new fixes branch (only after a major release - ?.?.0)
    1. Update version number in the trunk branch (only after a major release - ?.?.0)
      1. /compiler/version.pas
      2. All Makefile.fpc files containing "version=..." (plus regenerate the corresponding Makefiles)
  7. Update version number in the fixes branch (increase the patch to next odd number)
    1. /compiler/version.pas
    2. all Makefile.fpc files containing "version=..." (plus regenerate the corresponding Makefiles)
  8. Check the WWW pages
    1. make sure http://www.freepascal.org contains the new version already
    2. read news.html
    3. read fpc.html
    4. read download.html and check links to individual files
  9. Send announcement to our mailing lists
  10. Post announcement on the community site
  11. Post announcement on Sourceforge.net (only "Project Administrators" may do it)
  12. Make sure that all unfixed issues encountered during RC testing and listed on dedicated page in Wiki are documented in bug tracker too
  13. Revise / update /html/future.fp after major versions (?.?.0)
  14. Remove unneeded RC builds from FTP