NeoOffice 2.1 Release Tasks

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 17:26, 16 March 2007 (edit)
( | contribs)
(Update X11 dependency tasks)
← Previous diff
Revision as of 19:34, 16 March 2007 (edit) (undo)
( | contribs)
(Fill out steps in update of DicOOo/FontOOo task)
Next diff →
Line 83: Line 83:
<td> <td>
<p>Verify that none of the Intel build's executables or libraries link to any X11 libraries.</p> <p>Verify that none of the Intel build's executables or libraries link to any X11 libraries.</p>
- <p>Note: to do this step, install your latest NeoOffice build and, in a terminal, execute the following commands:</p>+ <p>Note: to do this task, install your latest NeoOffice build and, in a terminal, execute the following commands:</p>
<pre> <pre>
sh sh
Line 128: Line 128:
</tr> </tr>
- <tr bgcolor="pink">+ <tr>
<td> <td>
<p>Get latest version of <tt>DicOOo.sxw</tt> and <tt>FontOOo.sxw</tt> files, replace all references to the Control key with the Command key, and commit files in <tt>etc/share/dict/ooo</tt>.</p> <p>Get latest version of <tt>DicOOo.sxw</tt> and <tt>FontOOo.sxw</tt> files, replace all references to the Control key with the Command key, and commit files in <tt>etc/share/dict/ooo</tt>.</p>
- <p>'''TODO: Fill in detail steps that I performed'''</p>+ <p>Note: to do this task, do the following steps:</p>
 + <ul>
 + <li>Download the latest <tt>DicOOo.sxw</tt> file from [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/dicooo/DicOOo.sxw here]</li>
 + <li>Create a new directory and in that directory, unzip the downloaded file using the <tt>zip</tt> command.</li>
 + <li>Change all of the Windows carriage returns in the unzipped files to Unix newlines and ensure that the files end with a Unix newline by executing the following command:</li>
 +<pre>
 +sh
 +for i in `find /path/to/first/directory -name content.xml -o -name "Translation*.xml"`; do
 +( cat $i ; echo ) | tr '\r' '\n' > $i.tmp
 +mv -f $i.tmp $i
 +done
 +</pre>
 + <li>Replace all known references to the Control key with the Command key and replace OpenOffice.org with NeoOffice in the first directory by executing the following command:</li>
 +<pre>
 +sh
 +for i in `find /path/to/first/directory -name content.xml -o -name "Translation*.xml"`; do
 +cat $i | \
 +sed 's#\[CTRL\]#[Command]#g' | \
 +sed 's#\[Ctrl\]#[Command]#g' | \
 +sed 's#\[ctrl\]#[Command]#g' | \
 +sed 's#\[Strg\]#[Command]#g' | \
 +sed 's# CTRL #[Command]#g' | \
 +sed 's#\(Ctrl\)#[Command]#g' | \
 +sed 's#«Ctrl»#[Command]#g' | \
 +sed 's#OpenOffice\.org#NeoOffice#g' | \
 +sed 's#OpenOffice#NeoOffice#g' | \
 +sed 's#/NeoOfffice/#/OpenOffice.org/#g' > $i.tmp
 +mv -f $i.tmp $i
 +done
 +</pre>
 + <li>Replace the <tt>etc/share/dict/ooo/DicOOo.sxw</tt> file by executing the following commands:</li>
 +<pre>
 +sh
 +cd /path/to/first/directory
 +zip -r /path/to/etc/share/dict/ooo/DicOOo.sxw .
 +</pre>
 + <li>Copy your <tt>etc/share/dict/ooo/DicOOo.sxw</tt> into your latest NeoOffice installation and run the wizard to verify that the modified file actually works and that the text has been properly changed before commiting the modified file.</li>
 + <li>Download the latest <tt>FontOOo.sxw</tt> file from [http://oooconv.free.fr/fontooo/FontOOo.sxw here] and repeat the above steps by replacing "DicOOo" with "FontOOo".</li>
 + </ul>
</td> </td>
- <td>03/16/07</td><td></td><td></td>+ <td>03/16/07</td><td>pluby</td><td>Done</td>
</tr> </tr>

Revision as of 19:34, 16 March 2007

This page is an attempt to document all of the tasks required to release NeoOffice 2.1. This page is by no means comprehensive, but hopefully as we work through the release process, we will leave behind enough details to make future releases simpler and less error prone.

Here is what the colors mean:

Not yet assigned
Assigned but not yet due


Contents

Builds

In this release, there is no change in the OpenOffice.org tag that we are using so this build is far simpler than the NeoOffice 2.1 Early Access build. However, in order to fix a few ooo-build bugs found in NeoOffice 2.1 Early Access, we need to upgrade to a newer ooo-build tag. Also, we are going to bundle the latest Akua icon set. These two changes will mean that in this release, there will not be a patch that upgrades a NeoOffice 2.1 Early Access installation.

TaskDue DateAssignedStatus

Create NeoOffice-2_1_Early_Access_branch branch from the HEAD branch for NeoOffice 2.1 Early Access so that we can continue to do bug fixes and release Patches while we aer working on this release.

Note: After creating the branch, I invoked the following command in my NeoOffice 2.1 Early Access workspace to ensure that I don't accidently pull NeoOffice 2.1 changes into my build: cvs update -r NeoOffice-2_1_Early_Access_branch

03/13/07plubyDone

Perform a clean checkout of the HEAD branch and set build to build with a new version and NeoOffice trademarked product name.

This includes the following steps:

  • Perform a clean checkout of the HEAD branch
  • Copy custom.neo.mk file to custom.mk so that the clean checkout will build with the trademarked product name
  • In makefile, change the following macros to the respective values:

    PRODUCT_VERSION=2.1
    PRODUCT_DIR_VERSION=2.1
    PRODUCT_PATCH_VERSION=Patch 0
    PRODUCT_DIR_PATCH_VERSION=Patch-0
    NEO_TAG:=-rHEAD
    
  • In this release, there will not be a patch that upgrades a NeoOffice 2.1 Early Access installation so reduce the size of future patches by removing any libraries other than libvcl*.dylib from the build.patch_package target in the makefile
  • Commit makefile changes and invoke make build.oo_checkout to checkout the OpenOffice.org code
03/14/07plubyDone

Upgrade the build to use ooo-build's newer OOO_BUILD_2_1_7 tag.

TODO: Fill in detail steps that I performed

03/14/07plubyDone

Perform a clean checkout and build of the HEAD branch on Mac OS X 10.4 Intel with gcc 4.0.1.

Note: don't forget to copy custom.neo.mk file to custom.mk so that the clean checkout will build with the trademarked product name

03/14/07plubyDone

Perform a clean checkout and build of the HEAD branch on Mac OS X 10.4 PowerPC with gcc 3.3.

Note: don't forget to copy custom.neo.mk file to custom.mk so that the clean checkout will build with the trademarked product name

03/16/07OPENSTEP

Verify that none of the Intel build's executables or libraries link to any X11 libraries.

Note: to do this task, install your latest NeoOffice build and, in a terminal, execute the following commands:

sh
cd /Applications/NeoOffice.app/Contents/MacOS
for i in `find . -type f`; do echo $i ; otool -L $i 2>&1 | grep X11; done

If none of the binaries link to any X11 libraries, the above commands will only print a list of files. However, if you see any lines that look similar to the following, the file listed just before this type of line is linked to an X11 library and this must be correct before the NeoOffice binaries can be released.

/usr/X11R6/lib/libX11.6.dylib (compatibility version 6.2.0, current version 6.2.0)
03/16/07plubyDone

Verify that none of the PowerPC build's executables or libraries link to any X11 libraries.

Note: Use the same steps as used for the matching Intel task.

03/16/07OPENSTEP

Modify and test bin/installutils* sripts to not treat NeoOffice 2.1 Early Access as a match.

In this release, we do not want the installer to preserve the Early Access language pack resource files as some are incompatible with this build and will show as blank text. Also, we don't want the language pack or patch installer to upgrade an Early Access installation as it corrupt that installation.

Note: I tested this code by building the installer, language packs, and patch installer and then doing the following steps:

  • Install the patch installer and verify that it does not upgrade my NeoOffice 2.1 Early Access installation.
  • Install a NeoOffice 2.1 Early Access language pack, change my machine's preferred language to match the installed language pack, run NeoOffice 2.1 Early Access, and verify that the menus are not English.
  • With the same preferred language set in the previous step, install NeoOffice 2.1, and verify that the menus are in English.
  • Install a NeoOffice 2.1 language pack, change my machine's preferred language to match the installed language pack, run NeoOffice 2.1, and verify that the menus are not in English and verify that bug 2201 no longer occurs.
03/15/07plubyDone

Commit and test updated icon files in etc/package.

TODO: Fill in detail steps that I performed

03/16/07

Get latest version of DicOOo.sxw and FontOOo.sxw files, replace all references to the Control key with the Command key, and commit files in etc/share/dict/ooo.

Note: to do this task, do the following steps:

  • Download the latest DicOOo.sxw file from here
  • Create a new directory and in that directory, unzip the downloaded file using the zip command.
  • Change all of the Windows carriage returns in the unzipped files to Unix newlines and ensure that the files end with a Unix newline by executing the following command:
  • sh
    for i in `find /path/to/first/directory -name content.xml -o -name "Translation*.xml"`; do
    ( cat $i ; echo ) | tr '\r' '\n' > $i.tmp
    mv -f $i.tmp $i
    done
    
  • Replace all known references to the Control key with the Command key and replace OpenOffice.org with NeoOffice in the first directory by executing the following command:
  • sh
    for i in `find /path/to/first/directory -name content.xml -o -name "Translation*.xml"`; do
    cat $i | \
    sed 's#\[CTRL\]#[Command]#g' | \
    sed 's#\[Ctrl\]#[Command]#g' | \
    sed 's#\[ctrl\]#[Command]#g' | \
    sed 's#\[Strg\]#[Command]#g' | \
    sed 's# CTRL #[Command]#g' | \
    sed 's#\(Ctrl\)#[Command]#g' | \
    sed 's#«Ctrl»#[Command]#g' | \
    sed 's#OpenOffice\.org#NeoOffice#g' | \
    sed 's#OpenOffice#NeoOffice#g' | \
    sed 's#/NeoOfffice/#/OpenOffice.org/#g' > $i.tmp
    mv -f $i.tmp $i
    done
    
  • Replace the etc/share/dict/ooo/DicOOo.sxw file by executing the following commands:
  • sh
    cd /path/to/first/directory
    zip -r /path/to/etc/share/dict/ooo/DicOOo.sxw .
    
  • Copy your etc/share/dict/ooo/DicOOo.sxw into your latest NeoOffice installation and run the wizard to verify that the modified file actually works and that the text has been properly changed before commiting the modified file.
  • Download the latest FontOOo.sxw file from here and repeat the above steps by replacing "DicOOo" with "FontOOo".
03/16/07plubyDone

Merge any NeoOffice 2.1 Early Access bug fixes committed to the NeoOffice-2_1_Early_Access_branch branch.

Note: As of 03/15/2007, I have already merged the fixes included in NeoOffice 2.1 Early Access Patch 2 Test 1

03/18/07pluby

Tag the code in the HEAD branch with the NeoOffice-2_1 tag.

Note: Because the installer build checks out source code from the anoncvs.neooffice.org server, the following steps must be done to complete this task properly:

  • Do a cvs update -Ad to ensure that you have the latest code in your workspace, verify that none of the files are marked as updated, patched, modified, or have conflicts, and verify that the latest code actually builds through the installer.
  • In the makefile, set the NEO_TAG macro to NEO_TAG:=-rNeoOffice-2_1 and commit the makefile.
  • Tag all files in your workspace by invoking cvs tag NeoOffice-2_1.
  • On the cvs.neooffice.org server, run the script to synchronize the anoncvs.neooffice.org server.
  • Verify that the installer still builds by deleting the build.source_zip file and invoking make NOLANGPACKS=true.
  • If there are any build errors, fix and commit them, retag the changed files by invoking cvs tag -F NeoOffice-2_1, and repeating the previous two steps.
03/18/07OPENSTEP

Create releasable NeoOffice 2.1 build for Intel.

Note: the following steps are overkill, but they ensure that all recent changes to the NeoOffice custom code has been built:

  • Do a cvs update -d -rNeoOffice-2_1 and verify that none of the files are marked as updated, patched, modified, or have conflicts. If any such errors appear, the previous task (tagging of the workspace) has not been done properly and it needs to done properly before you can proceed with this task.
  • Do a cvs update -Ad so that you can do bug fixing and release patches after you create your releasable build
  • Delete all build.neo-* and build.odf-converter* files. This will force the installer to rebuild the odf-converter code and all of the NeoOffice custom code without causing any of the OpenOffice.org or ooo-build code to be rebuilt.
  • Invoke make to create the releasable installer and language packs.
03/19/07pluby

Create releasable NeoOffice 2.1 build for PowerPC.

Note: Use the same steps as used for the matching Intel task.

03/19/07OPENSTEP

Website

Mirrors

NeoOffice's rsync server is hosted by HeapSys and our volunteer mirrors obtain the NeoOffice binaries by nightly runs of the following command on their mirrors:

rsync -r --delete rsync://www.heapsys.com/ftp/ /path/to/NeoOffice/mirror/directory
TaskDue DateAssignedStatus
Notify rsync server and mirrors that we will be pushing new binaries out to them a few days before the 27 March 2007 release date so that they can prepare for the huge surge in bandwidth usage that their servers will get in the first month or so after reelease. 03/12/07plubyDone
Provide list of URLs of binaries and their respective file sizes to the rsync server so that the rsync server can copy them to the rsync server. 03/21/07pluby
Verify that the binaries are available from the rsync server and verify that each of the mirrors has synched them to their site. Try to contact any mirrors that have not synched to see if their is any problem or if the site can no longer be a mirror. 03/23/07pluby

Release

Personal tools