From 5080ecd2f4c2711b228127e1c12647906d37f3bd Mon Sep 17 00:00:00 2001 From: Max Kanat-Alexander Date: Sun, 28 Feb 2010 16:07:51 -0800 Subject: Bug 547466: Release Notes for Bugzilla 3.6rc1 r=LpSolit, r=gerv --- Bugzilla/Template.pm | 9 +- template/en/default/pages/release-notes.html.tmpl | 727 +++++++++++++++++++++- 2 files changed, 716 insertions(+), 20 deletions(-) diff --git a/Bugzilla/Template.pm b/Bugzilla/Template.pm index b623bd6d5..44282e4bc 100644 --- a/Bugzilla/Template.pm +++ b/Bugzilla/Template.pm @@ -770,8 +770,13 @@ sub create { \&Bugzilla::Install::Requirements::REQUIRED_MODULES, OPTIONAL_MODULES => sub { my @optional = @{OPTIONAL_MODULES()}; - @optional = sort {$a->{feature} cmp $b->{feature}} - @optional; + foreach my $item (@optional) { + my @features; + foreach my $feat_id (@{ $item->{feature} }) { + push(@features, install_string("feature_$feat_id")); + } + $item->{feature} = \@features; + } return \@optional; }, }, diff --git a/template/en/default/pages/release-notes.html.tmpl b/template/en/default/pages/release-notes.html.tmpl index 35b8df3d2..37840c128 100644 --- a/template/en/default/pages/release-notes.html.tmpl +++ b/template/en/default/pages/release-notes.html.tmpl @@ -19,12 +19,531 @@ [% PROCESS global/variables.none.tmpl %] [% INCLUDE global/header.html.tmpl - title = "$terms.Bugzilla 3.4 Release Notes" + title = "$terms.Bugzilla 3.6 Release Notes" style_urls = ['skins/standard/page.css'] %]

Table of Contents

+ + +

Introduction

+ +

Welcome to [% terms.Bugzilla %] 3.6! The focus of the 3.6 release is + on improving usability and "polishing up" all our features (by adding + some pieces that were "missing" or always wanted), although we + also have a few great new features for you, as well!

+ +

If you're upgrading, make sure to read Notes + On Upgrading From a Previous Version. If you are upgrading from a release + before 3.4, make sure to read the release notes for all the + previous versions in between your version + and this one, particularly the Upgrading section of each + version's release notes.

+ +

We would like to thank Canonical + Ltd., ITA Software, + the IBM Linux Technology Center, + Red Hat, and + Novell for funding the development + of various features and improvements in this release of + [%+ terms.Bugzilla %].

+ +

Minimum Requirements

+ +

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

+ + + + +

Perl

+ +

Perl v5.8.1

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

Required Perl Modules

+ +[% INCLUDE req_table reqs = REQUIRED_MODULES + new = [] updated = [] %] + +

Optional Perl Modules

+ +

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

+ +[% INCLUDE req_table reqs = OPTIONAL_MODULES + new = ['JSON-RPC', 'Test-Taint'] + updated = ['Chart'] + include_feature = 1 %] + +

New Features and Improvements

+ + + +

General Usability Improvements

+ +

A scientific + usability study was done on [% terms.Bugzilla %] by researchers + from Carnegie-Mellon University. As a result of this study, + several + usability issues were prioritized to be fixed, based on specific data + from the study.

+ +

As a result, you will see many small improvements in [% terms.Bugzilla %]'s + usability, such as using Javascript to validate certain forms before + they are submitted, standardizing the words that we use in the user interface, + being clearer about what [% terms.Bugzilla %] needs from the user, + and other changes, all of which are also listed individually in this New + Features section.

+ +

Work continues on improving usability for the next release of + [%+ terms.Bugzilla %], but the results of the research have already + had an impact on this 3.6 release.

+ +

New Extensions System

+ +

[% terms.Bugzilla %] has a brand-new Extensions system. The system is + consistent, fast, and + fully + documented. It makes it possible to easily extend [% terms.Bugzilla %]'s + code and user interface to add new features or change existing features. + There's even + a + script that will create the basic layout of an extension for you, to + help you get started. For more information about the new system, see the + Extensions + documentation.

+ +

If you had written any extensions using [% terms.Bugzilla %]'s previous + extensions system, there is + a + script to help convert old extensions into the new format.

+ +

Improved Quicksearch

+ +

The "quicksearch" box that appears on the front page of + [%+ terms.Bugzilla %] and in the header/footer of every page + is now simplified and made more powerful. There is a + [?] link next to the box that will take you to + the simplified Quicksearch Help, + which describes every single feature of the system in a simple layout, + including new features such as the ability to use partial field names + when searching.

+ +

Quicksearch should also be much faster than it was before, particularly + on large installations.

+ +

Note that in order to implement the new quicksearch, certain old + and rarely-used features had to be removed: + +

+ +

Simple "Browse" Interface

+ +

There is now a "Browse" link in the header of each [% terms.Bugzilla %] + page that presents a very basic interface that allows users to simply + browse through all open [% terms.bugs %] in particular components.

+ +

SUExec Support

+ +

[% terms.Bugzilla %] can now be run in Apache's "SUExec" mode, + which is what control panel software like cPanel and Plesk use + (so [% terms.Bugzilla %] should now be much easier to install + on shared hosting). SUExec support shows up as an option + in the localconfig file during installation.

+ +

Experimental mod_perl Support on Windows

+ +

There is now experimental support for running [% terms.Bugzilla %] + under mod_perl on Windows, for a significant performance enhancement + (in exchange for using more memory).

+ +

Send Attachments by Email

+ +

The email_in + script now supports attaching multiple attachments to [% terms.abug %] + by email, both when filing and when updating [% terms.abug %].

+ +

JSON-RPC Interface

+ +

[% terms.Bugzilla %] now has support for the + JSON-RPC WebServices protocol via + jsonrpc.cgi. + The JSON-RPC interface is experimental in this release--if you want any + fundamental changes in how it works, + let us + know, for the next release of [% terms.Bugzilla %].

+ +

Migration From Other [% terms.Bug %]-Trackers

+ +

[% terms.Bugzilla %] 3.6 comes with a new script, + migrate.pl, + which allows migration from other [% terms.bug %]-tracking systems. + Among the various features of the migration system are:

+ + + +

The first migrator that has been implemented is for the GNATS + [%+ terms.bug %]-tracking system. We'd love to see migrators for + other systems! If you want to contribute a new migrator, see our + development + process for details on how to get code into [% terms.Bugzilla %].

+ +

Thanks to Lambda Research for + funding the initial development of this feature.

+ +

Other Enhancements and Changes

+ +

Enhancements for Users

+ + + +

Enhancements for Administrators and Developers

+ + + +

WebService Changes

+ + + +

Outstanding Issues

+ + + +

Notes On Upgrading From a Previous Version

+ +

When upgrading to 3.6, checksetup.pl will create foreign keys + for many columns in the database. Before doing this, it will check the + database for consistency. If there are an unresolvable consistency + problems, it will tell you what table and column in the database contain + the bad values, and which values are bad. If you don't know what else to do, + you can always delete the database records which contain the bad values by + logging in to your database and running the following command:

+ +

DELETE FROM table WHERE column IN + (1, 2, 3, 4)

+ +

Just replace "table" and "column" with the name of the table + and column that checksetup.pl mentions, and "1, 2, 3, 4" + with the invalid values that checksetup.pl prints out.

+ +

Remember that you should always back up your database before doing + an upgrade.

+ +

Code Changes Which May Affect Customizations

+ + + + +

[% terms.Bugzilla %] 3.4 Release Notes

+