aboutsummaryrefslogtreecommitdiffstats
path: root/template
diff options
context:
space:
mode:
authorFrédéric Buclin <LpSolit@gmail.com>2012-11-08 00:50:12 +0100
committerFrédéric Buclin <LpSolit@gmail.com>2012-11-08 00:50:12 +0100
commit1c405dbab89089c11eaa3ef4347f7558805ec87d (patch)
treea50599015a50e093d7e1419099cf93bec00375a6 /template
parentbf910ab5fa181e9ee893b767f290bab4937e05c3 (diff)
downloadbugs-1c405dbab89089c11eaa3ef4347f7558805ec87d.tar
bugs-1c405dbab89089c11eaa3ef4347f7558805ec87d.tar.gz
bugs-1c405dbab89089c11eaa3ef4347f7558805ec87d.tar.bz2
bugs-1c405dbab89089c11eaa3ef4347f7558805ec87d.tar.xz
bugs-1c405dbab89089c11eaa3ef4347f7558805ec87d.zip
Bug 805645: Release notes for Bugzilla 4.4rc1
r=dkl
Diffstat (limited to 'template')
-rw-r--r--template/en/default/pages/release-notes.html.tmpl699
1 files changed, 687 insertions, 12 deletions
diff --git a/template/en/default/pages/release-notes.html.tmpl b/template/en/default/pages/release-notes.html.tmpl
index d767a7a4e..3972723f0 100644
--- a/template/en/default/pages/release-notes.html.tmpl
+++ b/template/en/default/pages/release-notes.html.tmpl
@@ -6,7 +6,7 @@
# defined by the Mozilla Public License, v. 2.0.
#%]
-[% SET title = "$terms.Bugzilla 4.2 Release Notes" %]
+[% SET title = "$terms.Bugzilla 4.4 Release Notes" %]
[% INCLUDE global/header.html.tmpl
title = title
style_urls = ['skins/standard/page.css']
@@ -15,6 +15,471 @@
<h1>[% title FILTER html %]</h1>
<ul class="bz_toc">
+ <li><a href="#v44_introduction">Introduction</a></li>
+ <!-- li><a href="#v44_point">Updates in this 4.4.x Release</a></li -->
+ <li><a href="#v44_req">Minimum Requirements</a></li>
+ <li><a href="#v44_feat">New Features and Improvements</a></li>
+ <li><a href="#v44_issues">Outstanding Issues</a></li>
+ <li><a href="#v44_upgrading">Notes On Upgrading From a Previous Version</a></li>
+ <li><a href="#v44_code_changes">Code Changes Which May Affect
+ Customizations and Extensions</a></li>
+ <li><a href="#v44_previous">Release Notes for Previous Versions</a></li>
+</ul>
+
+<h2 id="v44_introduction">Introduction</h2>
+
+<p>Welcome to [% terms.Bugzilla %] 4.4! It has been almost a year since we
+ released [% terms.Bugzilla %] 4.2 on February 2012, and this new major
+ release comes with several new features and improvements. This release
+ contains major improvements to WebServices, which were our main target in
+ this release, a rewritten tagging system, a real MIME type auto-detection for
+ attachments, improved support for Oracle, performance improvements and lots
+ of other enhancements.</p>
+
+<p>If you're upgrading, make sure to read <a href="#v44_upgrading">Notes On
+ Upgrading From a Previous Version</a>. If you are upgrading from a release
+ before 4.2, make sure to read the release notes for all the
+ <a href="#v44_previous">previous versions</a> in between your version and
+ this one, <strong>particularly the Upgrading section of each version's
+ release notes</strong>.</p>
+
+<!-- h2 id="v44_point">Updates in this 4.4.x Release</h2 -->
+
+
+<h2 id="v44_req">Minimum Requirements</h2>
+
+<p>Any requirements that are new since 4.2 will look like
+ <span class="req_new">this</span>.</p>
+
+<ul>
+ <li><a href="#v44_req_perl">Perl</a></li>
+ <li><a href="#v44_req_mysql">For MySQL Users</a></li>
+ <li><a href="#v44_req_pg">For PostgreSQL Users</a></li>
+ <li><a href="#v44_req_oracle">For Oracle Users</a></li>
+ <li><a href="#v44_req_sqlite">For SQLite Users</a></li>
+ <li><a href="#v44_req_modules">Required Perl Modules</a></li>
+ <li><a href="#v44_req_optional_mod">Optional Perl Modules</a></li>
+ <li><a href="#v44_req_apache">Optional Apache Modules</a></li>
+</ul>
+
+<h3 id="v44_req_perl">Perl</h3>
+
+<p>Perl v5.8.1</p>
+
+<p><strong>IMPORTANT:</strong> This is the last major release to support
+ Perl 5.8.x! The next major release, [% terms.Bugzilla %] 5.0, will require
+ Perl 5.10.1 as a minimum.</p>
+
+[% INCLUDE db_req db='mysql' %]
+
+[% INCLUDE db_req db='pg' dbd_new => 1 %]
+
+[% INCLUDE db_req db='oracle' %]
+
+[% INCLUDE db_req db='sqlite' %]
+
+<h3 id="v44_req_modules">Required Perl Modules</h3>
+
+[% INCLUDE req_table reqs = REQUIRED_MODULES
+ updated = ['TimeDate', 'DBI', 'Email-Send'] %]
+
+<h3 id="v44_req_optional_mod">Optional Perl Modules</h3>
+
+<p>The following perl modules, if installed, enable various
+ features of [% terms.Bugzilla %]:</p>
+
+[% INCLUDE req_table reqs = OPTIONAL_MODULES
+ new = ['Net-SMTP-SSL', 'HTML-FormatText-WithLinks',
+ 'File-MimeInfo', 'IO-stringy']
+ include_feature = 1 %]
+
+<h3 id="v44_req_apache">Optional Apache Modules</h3>
+
+<p>If you are using Apache as your webserver, [% terms.Bugzilla %] can
+ take advantage of some Apache features if you have the below Apache
+ modules installed and enabled. Currently,
+ <a href="#v40_feat_js_css_update">certain [% terms.Bugzilla %] features</a>
+ are enabled only if you have all of the following modules installed
+ and enabled:</p>
+
+<ul>
+ <li>mod_headers</li>
+ <li>mod_expires</li>
+ <li>mod_env</li>
+</ul>
+
+<p>On most systems (but not on Windows), <kbd>checksetup.pl</kbd> is able to
+ tell whether or not you have these modules installed, and it will tell
+ you.</p>
+
+
+<h2 id="v44_feat">New Features and Improvements</h2>
+
+<ul>
+ <li><a href="#v44_feat_bug_tags">Overhaul of the Tagging System</a></li>
+ <li><a href="#v44_feat_mimetype_autodetect">Auto-Detection of the Attachment MIME Type</a></li>
+ <li><a href="#v44_feat_saved_reports">Saving Tabular and Graphical Reports</a></li>
+ <li><a href="#v44_feat_whining">Custom Columns in Whine Emails</a></li>
+ <li><a href="#v44_feat_webservices">Improved WebServices</a></li>
+ <li><a href="#v44_feat_apache_config">New Apache Configuration</a></li>
+ <li><a href="#v44_feat_other">Other Enhancements and Changes</a></li>
+</ul>
+
+<h3 id="v44_feat_bug_tags">Overhaul of the Tagging System</h3>
+
+<p>
+ The old tagging system which was in the footer of all pages had severe design
+ and usability limitations and has been replaced by a shiny new one which lets
+ you tag [% terms.bugs %] from the [% terms.bug %] report directly. Tags now
+ mostly work like keywords, but with two major differences. First of all, they
+ are personal, meaning that tags you set on [% terms.bugs %] are only visible
+ by you, and nobody else is notified nor can see which tags you set. This
+ behavior is the same as the old tagging system and so this feature didn't
+ change. The second major difference is that the list of available tags is
+ unlimited and is in no way hardcoded by administrators. You can type either
+ a new tag of your choice, or you can select one from an auto-generated list
+ of tags which you already used in other [% terms.bugs %]. Again, this feature
+ was already present in the old tagging system, but its usability has been
+ greatly improved. In particular, this means that tags are now displayed in
+ [%+ terms.bug %] reports directly, so that you immediately know which tags
+ you already set for that [% terms.bug %]. This feature is new in this release.
+</p>
+<p>
+ Another new feature is that your personal tags can now be listed in buglists.
+ They can also be used as search criteria in your queries. If you decide to
+ share a saved search which uses tags as criteria, this will work too! Note
+ that when you add a new tag, no saved search based on this tag is created
+ anymore, as you can easily create it yourself if you really need it.
+</p>
+<p>
+ The tags set with the old tagging system are automatically migrated to the
+ new system.
+</p>
+
+<h3 id="v44_feat_mimetype_autodetect">Auto-Detection of the Attachment MIME Type</h3>
+
+<p>
+ When a user uploads a new attachment and lets the "Content Type" field set to
+ "auto-detect", [% terms.Bugzilla %] now does its own MIME type detection
+ if the web browser tells him that the attachment is of type
+ "application/octet-stream", in an attempt to make a better guess than the web
+ browser. In all other cases, [% terms.Bugzilla %] still trusts what the browser
+ tells him.
+</p>
+<p>
+ Check the <a href="#v44_req_optional_mod">list of optional Perl modules</a> to
+ know which modules to install in order to enable MIME type sniffing.
+</p>
+
+<h3 id="v44_feat_saved_reports">Saving Tabular and Graphical Reports</h3>
+
+<p>
+ It is now possible to save tabular and graphical reports in the same way as
+ you save searches. Saved reports will appear in the footer of pages, below
+ saved searches.
+</p>
+<p>
+ Unlike saved searches, it is not yet possible to share saved reports with
+ other users.
+</p>
+
+<h3 id="v44_feat_whining">Custom Columns in Whine Emails</h3>
+
+<p>
+ The list of columns to display in buglists contained in emails sent by the
+ whining system on a regular basis is no longer hardcoded. If the saved
+ search used for whining emails contains a list of columns, these columns are
+ used to be displayed in the emails. If no custom list is found, the default
+ column list is used instead.
+</p>
+<p>
+ This means that depending on the kind of email notifications you want, you
+ can fully customize data to return, on a per saved search basis!
+</p>
+
+<h3 id="v44_feat_webservices">Improved WebServices</h3>
+
+<p>
+ This release got major improvements in its WebServices interface. Many new
+ methods have been implemented to let third-party applications interact with
+ [%+ terms.Bugzilla %] even more closely. For instance, it is now possible to
+ know what parameters are set to using <kbd>B[%%]ugzilla.parameters</kbd>.
+ It is now also possible to update tags, products, groups or user accounts
+ using our API.
+<p>
+<p>
+ Several existing methods have also been improved to return data which
+ weren't available till now, such as [% terms.bug %] and attachment flags
+ using <kbd>B[%%]ug.get</kbd>, <kbd>B[%%]ug.attachments</kbd> or
+ <kbd>Product.get</kbd>. Users can also get their saved searches and reports
+ using <kbd>User.get</kbd>; and much more, see the
+ <a href="#v44_feat_webservices_details">detailed list</a> below.
+</p>
+
+<h3 id="v44_feat_apache_config">New Apache Configuration</h3>
+
+<p>
+ For improved security, [% terms.Bugzilla %] now prevents directory browsing
+ by default. If you run [% terms.Bugzilla %] under Apache (as most people do),
+ you most likely require a <strong>new Apache configuration</strong> for this
+ version of [% terms.Bugzilla %]. See the
+ <a href="#v44_upgrading">Notes On Upgrading From a Previous Version</a>
+ section for details.
+</p>
+
+<h3 id="v44_feat_other">Other Enhancements and Changes</h3>
+
+<h4>Enhancements for Users</h4>
+
+<ul>
+ <li><strong>[% terms.Bugs %]:</strong> It is now possible to add yourself to
+ the CC list when uploading an attachment and when editing an existing one.</li>
+ <li><strong>[% terms.Bugs %]:</strong> There is a new user preference to be
+ automatically added to the CC list of [% terms.bugs %] for which a flag
+ request is addressed to you (the flag has you as the requestee).</li>
+ <li><strong>[% terms.Bugs %]:</strong> Changes to the CC list no longer
+ causes midair collisions.</li>
+ <li><strong>[% terms.Bugs %]:</strong> There is now a <em>(take)</em> link
+ besides the QA Contact field to easily set yourself as QA contact.</li>
+ <li><strong>[% terms.Bugs %]:</strong> [% terms.Bugs %] are no longer
+ reassigned to the default assignee when moving the [% terms.bug %] into
+ another product or component if the current assignee is not the default
+ one. Same goes for the QA contact.</li>
+ <li><strong>[% terms.Bugs %]:</strong> When reporting a new [% terms.bug %],
+ flags which are not available for the selected component and those which
+ the reporter cannot edit are now hidden instead of being disabled. For
+ existing [% terms.bugs %], unset flags are also hidden by default. Clicking
+ the <em>(set flags)</em> or <em>(more flags)</em> link will make them
+ appear.</li>
+ <li><strong>[% terms.Bugs %]:</strong> When viewing [% terms.abug %], the list
+ of duplicated [% terms.bugs %] is now listed near the top of the page.</li>
+ <li><strong>[% terms.Bugs %]:</strong> Private comments now always remain
+ visible to their author. Previously, the author of a comment couldn't see
+ it anymore if the comment was marked private and the author isn't in the
+ insider group.</li>
+ <li><strong>[% terms.Bugs %]:</strong> The See Also field now supports URLs
+ pointing to GitHub by default. If the new MoreBugUrl extension included in
+ this release is enabled, then you can also add URLs pointing to:
+ b[%%]ugs.php.net, RT, appspot.com (Rietveld), Review Board, and
+ getsatisfaction.com.</li>
+ <li><strong>Searches:</strong> The alias of [% terms.bugs %] you cannot see
+ are no longer resolved to their [% terms.bug %] ID, meaning that it is no
+ longer possible to connect an alias with its ID unless you can see the
+ [%+ terms.bug %].</li>
+ <li><strong>Searches:</strong> The <em>changed by</em> operator in boolean
+ charts now accepts pronouns.</li>
+ <li><strong>Searches:</strong> The requester and requestee fields in boolean
+ charts now accept pronouns.</li>
+ <li><strong>Searches:</strong> It is now possible to hide the description of
+ queries appearing at the top of buglists.</li>
+ <li><strong>Requests:</strong> The "My Requests" page now displays an AND/OR
+ radio button to define the interaction between the requester and requestee
+ fields.</li>
+ <li><strong>Email Notifications:</strong> There is a new user preference to
+ not prepend "New:" to the subject of [% terms.bug %]mails when reporting
+ a new [% terms.bug %]. Some email clients couldn't thread emails correctly
+ due to this.</li>
+ <li><strong>Email Notifications:</strong> There is a new email event to get
+ notifications when the product or component of [% terms.abug %] changes.</li>
+ <li><strong>Email Notifications:</strong> All [% terms.bug %]mails now have
+ a <em>X-Bugzilla-Flags</em> email header, listing currently set flags.</li>
+ <li><strong>Whining:</strong> The sort order of the saved search is used to
+ sort [% terms.bugs %] in the emails.</li>
+ <li><strong>User Accounts:</strong> To confirm an email address change, the
+ password is now requested instead of the old email address.</li>
+ <li><strong>Graphical Reports:</strong> The size of graphical reports is now
+ set dynamically to fit within the window of the web browser.
+ The Taller/Thinner/Fatter/Shorter links are now gone.</li>
+ <li><strong>Incoming Emails:</strong> <kbd>email_in.pl</kbd> now accepts
+ HTML-only emails to create and edit [% terms.bugs %] by email.</li>
+ <li><strong>Incoming Emails:</strong> When creating a new [% terms.bug %],
+ <kbd>email_in.pl</kbd> will look at the <em>Importance</em> and
+ <em>X-Priority</em> email headers to increase or decrease the initial
+ priority of the [% terms.bug %], unless the priority is already explicitly
+ set in the email itself.</li>
+</ul>
+
+<h4>Enhancements for Administrators and Developers</h4>
+
+<ul>
+ <li><strong>License:</strong> The [% terms.Bugzilla %] code is now released
+ under the MPL 2.0 license (previously was MPL 1.1).</li>
+ <li><strong>Installation:</strong> On mod_perl, templates now remain in
+ memory for one hour, which can cause an increase in memory requirements.
+ This also means that it can take up to one hour before changes in templates
+ become active (unless you restart Apache).</li>
+ <li><strong>Installation:</strong> Running
+ <kbd>checksetup.pl --make-admin=foo@bar.com</kbd> now automatically
+ re-enables the user account if it was disabled.</li>
+ <li><strong>Configuration:</strong> A new parameter <em>smtp_ssl</em> can be
+ turned on to enable SSL connections to the SMTP server to send email
+ notifications.</li>
+ <li><strong>Administration:</strong> Custom fields now have a new <em>Long
+ description</em> attribute to better describe what the custom field is
+ about. This description then appears as a tooltip when hovering the custom
+ field in [% terms.bug %] reports.</li>
+ <li><strong>Administration:</strong> When creating a new product, the form
+ lets you add a component at the same time.</li>
+ <li><strong>Administration:</strong> When viewing a user account in
+ <kbd>editusers.cgi</kbd>, the date of the last login is displayed. Users
+ who did not log in since you upgraded to 4.4 will have this field empty.</li>
+ <li><strong>Administration:</strong> It is now possible to exclude disabled
+ user accounts when running a query in <kbd>editusers.cgi</kbd>.</li>
+ <li><strong>Administration:</strong> The default CC list is now also displayed
+ when listing components in <kbd>editcomponents.cgi</kbd>.</li>
+ <li><strong>Administration:</strong> Target milestones can now be 64 characters
+ long, for consistency with versions (previously was limited to 20 characters
+ only).</li>
+ <li><strong>Database:</strong> Support for Oracle has been greatly improved.</li>
+ <li><strong>Security:</strong> For improved security, the
+ "X-Content-Type-Options:&nbsp;nosniff" and "X-XSS-Protection:&nbsp;block"
+ headers are now sent with every response.</li>
+ <li><strong>Security:</strong> Tokens are now generated using HMAC SHA-256
+ instead of MD5.</li>
+ <li><strong>Documentation:</strong> The documentation is now generated with
+ <kbd>xmlto</kbd> and <kbd>dblatex</kbd> instead of <kbd>jade</kbd>.</li>
+</ul>
+
+<h4 id="v44_feat_webservices_details">WebService Changes</h4>
+
+<ul>
+ <li>Several new methods have been added: <kbd>B[%%]ug.update_tags</kbd>,
+ <kbd>B[%%]ugzilla.parameters</kbd>, <kbd>B[%%]ugzilla.last_audit_time</kbd>,
+ <kbd>Classification.get</kbd>, <kbd>Group.update</kbd>,
+ <kbd>Product.update</kbd>, <kbd>User.update</kbd>.</li>
+ <li><kbd>B[%%]ug.attachments</kbd> now also returns the <kbd>size</kbd> field
+ containing the size of the attachment.</li>
+ <li><kbd>B[%%]ug.attachments</kbd> and <kbd>B[%%]ug.get</kbd> now return
+ data about flags.</li>
+ <li><kbd>B[%%]ug.comments</kbd> now also returns <kbd>creation_time</kbd>
+ which is exactly the same as <kbd>time</kbd>, but is provided for
+ consistency with <kbd>B[%%]ug.get</kbd> and <kbd>B[%%]ug.attachments</kbd>.
+ The <kbd>time</kbd> field may be deprecated and removed in a future release,
+ so you should use <kbd>creation_time</kbd> instead.</li>
+ <li><kbd>B[%%]ug.comments</kbd> now also returns the <kbd>count</kbd> field
+ containing the comment ID relative to the [% terms.bug %] it belongs to.
+ This is the same comment ID as the one you can see in [% terms.bug %]
+ reports.</li>
+ <li>It is now possible to create new [% terms.bugs %] with a closed status with
+ <kbd>B[%%]ug.create</kbd>.</li>
+ <li>The <kbd>bug_status</kbd> field returned by <kbd>B[%%]ug.fields</kbd> now
+ also includes [% terms.bug %] statuses available on [% terms.bug %] creation.</li>
+ <li><kbd>B[%%]ug.fields</kbd> now also returns keyword descriptions, not only
+ their names.</li>
+ <li><kbd>B[%%]ug.fields</kbd> now also returns the <kbd>is_active</kbd> field
+ for product-specific fields.</li>
+ <li>For users in the timetracking group, <kbd>B[%%]ug.get</kbd> now also
+ returns the <kbd>actual_time</kbd> field with the total number of hours
+ spent in the [% terms.bug %].</li>
+ <li>Field names returned in the <kbd>field_name</kbd> field of the
+ <kbd>B[%%]ug.history</kbd> method have changed to be consistent with other
+ methods.</li>
+ <li><kbd>Product.get</kbd> now also returns the <kbd>flag_types</kbd> field
+ containing all the relevant data for attachment and [% terms.bug %] flag types.</li>
+ <li><kbd>Product.get</kbd> now throws an error if neither <kbd>ids</kbd> nor
+ <kbd>names</kbd> is passed to the method.</li>
+ <li>When requesting data for your own account using <kbd>User.get</kbd>,
+ this method now returns two additional fields: <kbd>saved_searches</kbd>
+ and <kbd>saved_reports</kbd> containing all your saved searches and
+ graphical and tabular reports.</li>
+ <li><kbd>User.get</kbd> now also returns the <kbd>groups</kbd> field
+ containing the list of groups the user belongs to. The list is filtered
+ based on your privileges.</li>
+</ul>
+
+
+<h2 id="v44_issues">Outstanding Issues</h2>
+
+<ul>
+ <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=89822">
+ [%- terms.Bug %] 89822</a>: When changing multiple [% terms.bugs %] at
+ the same time, there is no "mid-air collision" protection.</li>
+ <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=276230">
+ [%- terms.Bug %] 276230</a>: The support for restricting access to
+ particular Categories of New Charts is not complete. You should treat the
+ <em>chartgroup</em> parameter as the only access mechanism available.</li>
+ <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=584742">
+ [%- terms.Bug %] 584742</a>: When viewing [% terms.abug %], WebKit-based
+ browsers can automatically reset a field's selected value when the field
+ has disabled values.</li>
+</ul>
+
+
+<h2 id="v44_upgrading">Notes On Upgrading From a Previous Version</h2>
+
+<h3>IMPORTANT: Apache Configuration Change</h3>
+
+<p>
+ For improved security, [% terms.Bugzilla %] now prevents directory browsing
+ by default. In order to do that, the root <kbd>bugzilla/.htaccess</kbd> file
+ now contains the <kbd>Options -Indexes</kbd> directive. By default, this
+ directive is not allowed in <kbd>.htaccess</kbd> and so you must configure
+ Apache to allow it. To do that, add <kbd>Options</kbd> to the
+ <kbd>AllowOverride</kbd> directive in <kbd>httpd.conf</kbd>. This means you
+ should now have something like this:
+ <p>
+ <kbd>AllowOverride Limit FileInfo Indexes Options</kbd>
+ </p>
+ Check the
+ <a href="http://www.bugzilla.org/docs/4.4/en/html/configuration.html#http-apache">documentation</a>
+ for more information about how to configure Apache.
+</p>
+
+<h2 id="v44_code_changes">Code Changes Which May Affect Customizations and Extensions</h2>
+
+<ul>
+ <li>The <em>usebugaliases</em> parameter has been removed. Aliases are now
+ always available.</li>
+ <li>There is a new code hook <kbd>admin_editusers_action</kbd> to alter the
+ way <kbd>editusers.cgi</kbd> works.</li>
+ <li>There is a new code hook <kbd>buglist_column_joins</kbd> to alter the way
+ tables and columns are joined in queries. In combination with the
+ <kbd>buglist_columns</kbd> hook, this permits to customize the list of
+ columns to display in buglists.</li>
+ <li>There is a new code hook <kbd>bug_url_sub_classes</kbd> to support
+ additional URLs in the See Also field.</li>
+ <li>There is a new code hook <kbd>error_catch</kbd> to catch errors thrown
+ by [% terms.Bugzilla %] and to take the appropriate actions.</li>
+ <li>There is a new code hook <kbd>path_info_whitelist</kbd> to whitelist
+ scripts which should still get the Path-Info information from URLs. By
+ default, Path-Info is now removed before being passed to CGI scripts.</li>
+ <li>It is now illegal to have a product with no components and no versions.
+ Trying to delete the last component or version of a product is now
+ rejected.</li>
+ <li>Quips can no longer exceed 512 characters. Existing quips longer than
+ that are automatically truncated when upgrading.</li>
+ <li>The static <kbd>bugzilla.dtd</kbd> file has been replaced by a dynamic
+ one to take custom fields into account. The old
+ <em>&lt;urlbase&gt;/bugzilla.dtd</em> URL is now
+ <em>&lt;urlbase&gt;/page.cgi?id=bugzilla.dtd</em>.</li>
+ <li>There is a new extension located at <kbd>extensions/MoreBugUrl/</kbd>
+ which permits to add new classes of URLs in the See Also field. It uses
+ the <kbd>bug_url_sub_classes</kbd> hook mentioned above.</li>
+ <li>There is a new <kbd>B[%%]ugzilla->process_cache</kbd> method to store
+ data which should remain available for the lifetime of the worker process,
+ on mod_perl. On mod_cgi, it behaves the same way as
+ <kbd>B[%%]ugzilla->request_cache</kbd>.</li>
+ <li>In the RDF output of <kbd>config.cgi</kbd>, URIs used to identify
+ versions and target milestones have been changed to be unique across
+ products.</li>
+ <li>The RDF output of <kbd>config.cgi</kbd> now also returns data about
+ classifications.</li>
+ <li>It is now legal to call <kbd>B[%%]ugzilla::Version->check({ id => $id })</kbd>
+ and <kbd>B[%%]ugzilla::Milestone->check({ id => $id })</kbd> to validate
+ and get an object using its ID.</li>
+ <li>Rows in the <kbd>dependencies</kbd> DB table are now enforced to be
+ unique.</li>
+ <li>The <kbd>b[%%]ugs_activity</kbd> and <kbd>profiles_activity</kbd> DB
+ tables now have an auto-incremented primary key named <kbd>id</kbd>.</li>
+ <li>A custom <kbd>B[%%]ugzilla.pm</kbd> module has been added into
+ <kbd>contrib/</kbd> to help packagers to package B[%%]ugzilla in their
+ Linux distros.</li>
+</ul>
+
+
+<h1 id="v44_previous">[% terms.Bugzilla %] 4.2 Release Notes</h1>
+
+<ul class="bz_toc">
<li><a href="#v42_introduction">Introduction</a></li>
<li><a href="#v42_point">Updates in this 4.2.x Release</a></li>
<li><a href="#v42_req">Minimum Requirements</a></li>
@@ -186,29 +651,239 @@
<p>Perl v5.8.1</p>
-[% INCLUDE db_req db='mysql' db_new => 1 dbd_new => 1 %]
+<h3 id="v42_req_mysql">For MySQL Users</h3>
-[% INCLUDE db_req db='pg' db_new => 1 %]
+<ul>
+ <li>MySQL <span class="req_new">v5.0.15</span></li>
+ <li><strong>perl module:</strong> DBD::mysql <span class="req_new">v4.001</span></li>
+</ul>
-[% INCLUDE db_req db='oracle' %]
+<h3 id="v42_req_pg">For PostgreSQL Users</h3>
-[% INCLUDE db_req db='sqlite' %]
+<ul>
+ <li>PostgreSQL <span class="req_new">v8.03.0000</span></li>
+ <li><strong>perl module:</strong> DBD::Pg v1.45</li>
+</ul>
+
+<h3 id="v42_req_oracle">For Oracle Users</h3>
+
+<ul>
+ <li>Oracle v10.02.0</li>
+ <li><strong>perl module:</strong> DBD::Oracle v1.19</li>
+</ul>
+
+<h3 id="v42_req_sqlite">For SQLite Users</h3>
+
+<ul>
+ <li>SQLite v3.6.22</li>
+ <li><strong>perl module:</strong> DBD::SQLite v1.29</li>
+</ul>
<h3 id="v42_req_modules">Required Perl Modules</h3>
-[% INCLUDE req_table reqs = REQUIRED_MODULES
- new = ['Math-Random-ISAAC']
- updated = ['URI'] %]
+
+<table class="req_table" border="0" cellpadding="0" cellspacing="0">
+ <tbody>
+ <tr>
+ <th>Module</th>
+ <th>Version</th>
+ </tr>
+ <tr>
+ <td>CGI</td>
+ <td>3.51</td>
+ </tr>
+ <tr>
+ <td>Digest::SHA</td>
+ <td>(Any)</td>
+ </tr>
+ <tr>
+ <td>Date::Format</td>
+ <td>2.21</td>
+ </tr>
+ <tr>
+ <td>DateTime</td>
+ <td>0.28</td>
+ </tr>
+ <tr>
+ <td>DateTime::TimeZone</td>
+ <td>0.71</td>
+ </tr>
+ <tr>
+ <td>DBI</td>
+ <td>1.614</td>
+ </tr>
+ <tr>
+ <td>Template</td>
+ <td>2.22</td>
+ </tr>
+ <tr>
+ <td>Email::Send</td>
+ <td>2.00</td>
+ </tr>
+ <tr>
+ <td>Email::MIME</td>
+ <td>1.904</td>
+ </tr>
+ <tr>
+ <td>URI</td>
+ <td class="req_new">1.37</td>
+ </tr>
+ <tr>
+ <td>List::MoreUtils</td>
+ <td>0.22</td>
+ </tr>
+ <tr>
+ <td class="req_new">Math::Random::ISAAC</td>
+ <td class="req_new">1.0.1</td>
+ </tr>
+ </tbody>
+</table>
<h3 id="v42_req_optional_mod">Optional Perl Modules</h3>
<p>The following perl modules, if installed, enable various
features of [% terms.Bugzilla %]:</p>
-[% INCLUDE req_table reqs = OPTIONAL_MODULES
- new = ['Encode', 'Encode-Detect']
- updated = ['PatchReader', 'Apache-SizeLimit']
- include_feature = 1 %]
+
+<table class="req_table" border="0" cellpadding="0" cellspacing="0">
+ <tbody>
+ <tr>
+ <th>Module</th>
+ <th>Version</th>
+ <th>Enables Feature</th>
+ </tr>
+ <tr>
+ <td>GD</td>
+ <td>1.20</td>
+ <td>Graphical Reports, New Charts, Old Charts</td>
+ </tr>
+ <tr>
+ <td>Chart::Lines</td>
+ <td>2.1</td>
+ <td>New Charts, Old Charts</td>
+ </tr>
+ <tr>
+ <td>Template::Plugin::GD::Image</td>
+ <td>(Any)</td>
+ <td>Graphical Reports</td>
+ </tr>
+ <tr>
+ <td>GD::Text</td>
+ <td>(Any)</td>
+ <td>Graphical Reports</td>
+ </tr>
+ <tr>
+ <td>GD::Graph</td>
+ <td>(Any)</td>
+ <td>Graphical Reports</td>
+ </tr>
+ <tr>
+ <td>MIME::Parser</td>
+ <td>5.406</td>
+ <td>Move [% terms.Bugs %] Between Installations</td>
+ </tr>
+ <tr>
+ <td>LWP::UserAgent</td>
+ <td>(Any)</td>
+ <td>Automatic Update Notifications</td>
+ </tr>
+ <tr>
+ <td>XML::Twig</td>
+ <td>(Any)</td>
+ <td>Move [% terms.Bugs %] Between Installations, Automatic Update Notifications</td>
+ </tr>
+ <tr>
+ <td>PatchReader</td>
+ <td class="req_new">0.9.6</td>
+ <td>Patch Viewer</td>
+ </tr>
+ <tr>
+ <td>Net::LDAP</td>
+ <td>(Any)</td>
+ <td>LDAP Authentication</td>
+ </tr>
+ <tr>
+ <td>Authen::SASL</td>
+ <td>(Any)</td>
+ <td>SMTP Authentication</td>
+ </tr>
+ <tr>
+ <td>Authen::Radius</td>
+ <td>(Any)</td>
+ <td>RADIUS Authentication</td>
+ </tr>
+ <tr>
+ <td>SOAP::Lite</td>
+ <td>0.712</td>
+ <td>XML-RPC Interface</td>
+ </tr>
+ <tr>
+ <td>JSON::RPC</td>
+ <td>(Any)</td>
+ <td>JSON-RPC Interface</td>
+ </tr>
+ <tr>
+ <td>JSON::XS</td>
+ <td>2.0</td>
+ <td>Make JSON-RPC Faster</td>
+ </tr>
+ <tr>
+ <td>Test::Taint</td>
+ <td>(Any)</td>
+ <td>JSON-RPC Interface, XML-RPC Interface</td>
+ </tr>
+ <tr>
+ <td>HTML::Parser</td>
+ <td>3.67</td>
+ <td>More HTML in Product/Group Descriptions</td>
+ </tr>
+ <tr>
+ <td>HTML::Scrubber</td>
+ <td>(Any)</td>
+ <td>More HTML in Product/Group Descriptions</td>
+ </tr>
+ <tr>
+ <td class="req_new">Encode</td>
+ <td class="req_new">2.21</td>
+ <td>Automatic charset detection for text attachments</td>
+ </tr>
+ <tr>
+ <td class="req_new">Encode::Detect</td>
+ <td class="req_new">(Any)</td>
+ <td>Automatic charset detection for text attachments</td>
+ </tr>
+ <tr>
+ <td>Email::MIME::Attachment::Stripper</td>
+ <td>(Any)</td>
+ <td>Inbound Email</td>
+ </tr>
+ <tr>
+ <td>Email::Reply</td>
+ <td>(Any)</td>
+ <td>Inbound Email</td>
+ </tr>
+ <tr>
+ <td>TheSchwartz</td>
+ <td>(Any)</td>
+ <td>Mail Queueing</td>
+ </tr>
+ <tr>
+ <td>Daemon::Generic</td>
+ <td>(Any)</td>
+ <td>Mail Queueing</td>
+ </tr>
+ <tr>
+ <td>mod_perl2</td>
+ <td>1.999022</td>
+ <td>mod_perl</td>
+ </tr>
+ <tr>
+ <td>Apache2::SizeLimit</td>
+ <td class="req_new">0.96</td>
+ <td>mod_perl</td>
+ </tr>
+ </tbody>
+</table>
<h3 id="v42_req_apache">Optional Apache Modules</h3>