From bea9199267de2fe96c3214f17b4119ae87dd6a26 Mon Sep 17 00:00:00 2001 From: "mkanat%bugzilla.org" <> Date: Thu, 7 Aug 2008 04:34:14 +0000 Subject: Bug 432331: Release Notes for Bugzilla 3.2 Patch By Max Kanat-Alexander r=LpSolit, a=LpSolit --- template/en/default/pages/release-notes.html.tmpl | 646 +++++++++++++++++++++- 1 file changed, 630 insertions(+), 16 deletions(-) (limited to 'template') diff --git a/template/en/default/pages/release-notes.html.tmpl b/template/en/default/pages/release-notes.html.tmpl index 1ecb3eb3d..7858d1d15 100644 --- a/template/en/default/pages/release-notes.html.tmpl +++ b/template/en/default/pages/release-notes.html.tmpl @@ -19,12 +19,492 @@ [% PROCESS global/variables.none.tmpl %] [% INCLUDE global/header.html.tmpl - title = "$terms.Bugzilla 3.0.4 Release Notes" + title = "$terms.Bugzilla 3.2 Release Notes" style_urls = ['skins/standard/release-notes.css'] %]

Table of Contents

+ + +

Introduction

+ +

Welcome to [% terms.Bugzilla %] 3.2! This is our first major feature + release since [% terms.Bugzilla %] 3.0, and it brings a lot of great + improvements and polish to the [% terms.Bugzilla %] experience.

+ +

If you're upgrading, make sure to read How to + Upgrade From An Older Version. If you are upgrading from a release + before 3.0, make sure to read the release notes for all the + previous versions in between your version + and this one, particularly the "Notes For Upgraders" section of each + version's release notes.

+ +

Minimum Requirements

+ +

Any requirements that are new since 3.0.5 will look like + this.

+ + + +

Perl

+ +

Perl v5.8.1

+ +[% INCLUDE db_req db='mysql' dbd_new = 1 %] + +[% INCLUDE db_req db='pg' %] + +[% INCLUDE db_req db='oracle' %] + +

Required Perl Modules

+ +[% INCLUDE req_table reqs = REQUIRED_MODULES + new = [] + updated = ['Template-Toolkit', 'Email-MIME', + 'Email-MIME-Modifier'] %] + +

Optional Perl Modules

+ +

The following perl modules, if installed, enable various + features of [% terms.Bugzilla %]:

+ +[% INCLUDE req_table reqs = OPTIONAL_MODULES + new = ['SASL-Authen', 'RadiusPerl'] + updated = [] + include_feature = 1 %] + +

New Features and Improvements

+ + + +

Major UI Improvements

+ +

[% terms.Bugzilla %] 3.2 has had some UI assistance from the NASA + Human-Computer Interaction department and the new + [% terms.Bugzilla %] + User Interface Team.

+ +

In particular, you will notice a massively redesigned [% terms.bug %] + editing form, in addition to our new skin.

+ +

New Default Skin: Dusk

+ +

[% terms.Bugzilla %] 3.2 now ships with a skin called "Dusk" that is + a bit more colorful than old default "Classic" skin.

+ +

Upgrading installations will still default to the "Classic" + skin--administrators can change the default in the Default Preferences + control panel. Users can also choose to use the old skin in their + Preferences (or using the View :: Page Style menu in Firefox).

+ +

The changes that [% terms.Bugzilla %] required for Dusk made + [%+ terms.Bugzilla %] much easier to skin. See the + Addons page + for additional skins, or try making your own!

+ +

Custom Status Workflow

+ +

You can now customize the list of statuses in [% terms.Bugzilla %], + and transitions between them.

+ +

You can also specify that a comment must be made on certain transitions.

+ +

New Custom Field Types

+ +

[% terms.Bugzilla %] 3.2 has support for three new types of + custom fields:

+ + + +

Easier Installation

+ +

[% terms.Bugzilla %] now comes with a script called + install-module.pl that can automatically download + and install all of the required Perl modules for [% terms.Bugzilla %]. + It stores them in a directory inside your [% terms.Bugzilla %] + installation, so you can use it even if you don't have administrator-level + access to your machine, and without modifying your main Perl install.

+ +

checksetup.pl will print out instructions for using + install-module.pl, or you can read its + documentation.

+ +

Experimental Oracle Support

+ +

[% terms.Bugzilla %] 3.2 contains experimental support for using + Oracle as its database. Some features of [% terms.Bugzilla %] are known + to be broken on Oracle, but hopefully will be working by our next major + release.

+ +

The [% terms.Bugzilla %] Project, as an open-source project, of course + does not recommend the use of proprietary database solutions. However, + if your organization requires that you use Oracle, this will allow + you to use [% terms.Bugzilla %]!

+ +

The [% terms.Bugzilla %] Project thanks Oracle Corp. for their extensive + development contributions to [% terms.Bugzilla %] which allowed this to + happen!

+ +

Improved UTF-8 Support

+ +

[% terms.Bugzilla %] 3.2 now has advanced UTF-8 support in its code, + including correct handling for truncating and wrapping multi-byte + languages. Major issues with multi-byte or unusual languages + are now resolved, and [% terms.Bugzilla %] should now be usable + by users in every country with little (or at least much less) + customization.

+ +

Group Icons

+ +

Administrators can now specify that users who are in certain groups + should have an icon appear next to their name whenever they comment. + This is particularly useful for distinguishing developers from + [%+ terms.bug %] reporters.

+ +

Other Enhancements and Changes

+ +

These are either minor enhancements, or enhancements that have + very short descriptions. Some of these are very useful, though!

+ +

Enhancements For Users

+ + + +

Enhancements For Administrators

+ + + +

Enhancements for Localizers (or Localized Installations)

+ + + +

Outstanding Issues

+ + + +

How to Upgrade From An Older Version

+ +

Notes For Upgraders

+ + + +

Steps For Upgrading

+ +
    +
  1. Read these entire Release Notes, particularly the "Notes for + Upgraders" section above.
    2. + +
  2. View the Sanity Check page on your + installation before upgrading. Attempt to fix all warnings that + the page produces before you go any further, or you may experience + problems during your upgrade.
    3. + +
  3. Make a backup of the [% terms.Bugzilla %] database before you upgrade, + perhaps by using mysqldump. THIS IS VERY + IMPORTANT. If anything goes wrong during the upgrade, your + installation can be corrupted beyond recovery. Having a backup keeps you + safe. + +

    Example: mysqldump -u root -p bu[%# trick filter %]gs > + bu[%# trick filter %]gs-db.sql

    4. + +
  4. Replace the files in your installation with the new version of + [% terms.Bugzilla %], or you can try to use CVS to upgrade. + +

    You can also use a brand-new [% terms.Bugzilla %] directory, as long + as you copy over the old data/ directory and the + localconfig file to the new installation.

    5. + +
  5. Now follow the standard + + [%- terms.Bugzilla %] installation process.
    6. + +
  6. Run checksetup.pl after you install the new version.
    7. + +
  7. View the Sanity Check page again after + you run checksetup.pl.
    8. + +
  8. It is recommended that, if possible, you fix any problems you find + immediately. Failure to do this may mean that [% terms.Bugzilla %] will + not work correctly. Be aware that if the sanity check page contains more + errors after an upgrade, it doesn't necessarily mean there are more + errors in your database than there were before, as additional tests + are added to the sanity check over time, and it is possible that those + errors weren't being checked for in the old version.
    9. +
+ +

Code Changes Which May Affect + Customizations

+ + + +

More Hooks!

+ +

There are more code hooks in 3.2 than there were in 3.0. See the + documentation of Bugzilla::Hook + for more details.

+ +

Search.pm Rearchitecture

+ +

Bugzilla/Search.pm has been heavily modified, to be much + easier to read and use. It contains mostly the same code as it did in + 3.0, but it has been moved around and reorganized significantly.

+ +

lib Directory

+ +

As part of implementing install-module.pl, + [%+ terms.Bugzilla %] was given a local lib directory which + it searches for modules, in addition to the standard system path.

+ +

This means that all [% terms.Bugzilla %] scripts now start with + use lib qw(. lib); as one of the first lines.

+ +

Other Changes

+ + + +

Release Notes For Previous Versions

+ +

[% terms.Bugzilla %] 3.0.x Release Notes

+ +

Table of Contents

+ -[% PROCESS db_req db='mysql' %] +

For MySQL Users

-[% PROCESS db_req db='pg' %] + + +

For PostgreSQL Users

+ +

Required Perl Modules

-[% INCLUDE req_table reqs = REQUIRED_MODULES - new = ['Email-MIME-Modifier', 'Email-Send'] - updated = ['DBI'] %] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Module Version
CGI 2.93
Date::Format 2.21
DBI1.41
File::Spec 0.84
Template 2.12
Email::Send2.00
Email::MIME1.861
Email::MIME::Modifier1.442

Optional Perl Modules

The following perl modules, if installed, enable various features of [% terms.Bugzilla %]:

-[% INCLUDE req_table reqs = OPTIONAL_MODULES - new = ['libwww-perl', 'SOAP-Lite', 'mod_perl', - 'Apache-DBI', 'Email-MIME-Attachment-Stripper', - 'Email-Reply'] - updated = ['CGI'] - include_feature = 1 %] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Module VersionEnables Feature
LWP::UserAgent(Any)Automatic Update Notifications
Template::Plugin::GD::Image(Any)Graphical Reports
GD::Graph(Any)Graphical Reports
GD::Text(Any)Graphical Reports
GD1.20Graphical Reports, New Charts, Old Charts
Email::MIME::Attachment::Stripper(Any)Inbound Email
Email::Reply(Any)Inbound Email
Net::LDAP(Any)LDAP Authentication
HTML::Parser3.40More HTML in Product/Group Descriptions
HTML::Scrubber(Any)More HTML in Product/Group Descriptions
XML::Twig(Any)Move [% terms.Bugs %] Between Installations
MIME::Parser5.406Move [% terms.Bugs %] Between Installations
Chart::Base1.0New Charts, Old Charts
Image::Magick(Any)Optionally Convert BMP Attachments to PNGs
PatchReader0.9.4Patch Viewer
SOAP::Lite(Any)XML-RPC Interface
mod_perl21.999022mod_perl
CGI3.11mod_perl

New Features and Improvements

@@ -687,7 +1296,7 @@

How to Upgrade From An Older Version

-

Notes For Upgraders

+

Notes For Upgraders