From: Gervase Markham Date: Wed, 29 Oct 2014 17:46:13 +0000 (+0000) Subject: Updates from review comments from Ryan. X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=645d58e1763156d24c512c9ecaa0222ef5f4c795;p=thirdparty%2Fbugzilla.git Updates from review comments from Ryan. --- diff --git a/docs/en/rst/upgrading/index.rst b/docs/en/rst/upgrading/index.rst index 937fdaeea3..138c1d260d 100644 --- a/docs/en/rst/upgrading/index.rst +++ b/docs/en/rst/upgrading/index.rst @@ -13,3 +13,4 @@ Upgrading Bugzilla migrating-from-cvs migrating-from-a-tarball upgrading-with-a-tarball + upgrading-customizations diff --git a/docs/en/rst/upgrading/overview.rst b/docs/en/rst/upgrading/overview.rst index e779caf522..c23cd07103 100644 --- a/docs/en/rst/upgrading/overview.rst +++ b/docs/en/rst/upgrading/overview.rst @@ -23,9 +23,9 @@ Before Git, we used to use Bazaar and, before that, CVS. If your installation of Bugzilla consists of a checkout from one of those two systems, you need to upgrade in three steps: -1. upgrade to the latest point release of your current Bugzilla version; -2. move to Git while staying on exactly the same release; -3. upgrade to the latest Bugzilla using the instructions for :ref:`upgrading-with-git`. +1. Upgrade to the latest point release of your current Bugzilla version. +2. Move to Git while staying on exactly the same release. +3. Upgrade to the latest Bugzilla using the instructions for :ref:`upgrading-with-git`. See :ref:`migrating-from-bazaar` or :ref:`migrating-from-cvs` as appropriate. @@ -38,12 +38,15 @@ If you aren't sure which of these categories you fall into, to find out which version control system your copy of Bugzilla recognizes, look for the following subdirectories in your root Bugzilla directory: -* :file:`.git`: you installed using Git - follow :ref:`upgrading-with-git` -* :file:`.bzr`: you installed using Bazaar - follow :ref:`migrating-from-bazaar` -* :file:`CVS`: you installed using CVS - follow :ref:`migrating-from-cvs` -* none of the above: you installed using an old tarball - follow - :ref:`migrating-from-a-tarball` +* :file:`.git`: you installed using Git - follow :ref:`upgrading-with-git`. +* :file:`.bzr`: you installed using Bazaar - follow :ref:`migrating-from-bazaar`. +* :file:`CVS`: you installed using CVS - follow :ref:`migrating-from-cvs`. +* None of the above: you installed using an old tarball - follow + :ref:`migrating-from-a-tarball`. It is also possible, particularly if your server machine does not have and cannot be configured to have access to the public internet, to upgrade using a tarball. See :ref:`upgrading-with-a-tarball`. + +Whichever path you use, you may need help with +:ref:`upgrading-customizations`. diff --git a/docs/en/rst/upgrading/upgrading-customizations.rst b/docs/en/rst/upgrading/upgrading-customizations.rst new file mode 100644 index 0000000000..c99c6a9f7d --- /dev/null +++ b/docs/en/rst/upgrading/upgrading-customizations.rst @@ -0,0 +1,20 @@ +.. _upgrading-customizations: + +Upgrading a Customized or Extended Bugzilla +########################################### + +If your Bugzilla has been customized or uses extensions, you will need to +make your customizations or extensions work with your new version of Bugzilla. +If this is the case, you are particularly strongly recommended to do a test +upgrade on a test system and use that to help you port forward your +customizations. + +If your extension came from a third party, look to see if an updated version +is available for the version of Bugzilla you are upgrading to. If not, and +you want to continue using it, you'll need to port it forward yourself. + +If you are upgrading from a version of Bugzilla earlier than 3.6 and have +extensions for which a newer version is not available from an upstream source, +then you need to convert them. This is because the extension format changed +in version 3.6. There is a file called :file:`extension-convert.pl` in the +:file:`contrib` directory which may be able to help you with that.