Commit 37a5dd2d authored by Per Cederqvist's avatar Per Cederqvist

Imported Bugzilla 4.4.6.

parent 99e9f226
No preview for this file type
737bc170933d5c02bf4636103782e8e46a31d96b
\ No newline at end of file
21ce812db962edd79e62fa8ba0fd19672fff88a5
\ No newline at end of file
......@@ -911,12 +911,6 @@ sub update {
join(', ', @added_names)];
}
# Flags
my ($removed, $added) = Bugzilla::Flag->update_flags($self, $old_bug, $delta_ts);
if ($removed || $added) {
$changes->{'flagtypes.name'} = [$removed, $added];
}
# Comments
foreach my $comment (@{$self->{added_comments} || []}) {
# Override the Comment's timestamp to be identical to the update
......@@ -939,6 +933,9 @@ sub update {
Bugzilla->user->id, $delta_ts, $comment->id);
}
# Clear the cache of comments
delete $self->{comments};
# Insert the values into the multiselect value tables
my @multi_selects = grep {$_->type == FIELD_TYPE_MULTI_SELECT}
Bugzilla->active_custom_fields;
......@@ -971,6 +968,12 @@ sub update {
join(', ', map { $_->name } @$added_see)];
}
# Flags
my ($removed, $added) = Bugzilla::Flag->update_flags($self, $old_bug, $delta_ts);
if ($removed || $added) {
$changes->{'flagtypes.name'} = [$removed, $added];
}
$_->update foreach @{ $self->{_update_ref_bugs} || [] };
delete $self->{_update_ref_bugs};
......
......@@ -94,10 +94,9 @@ sub init {
if ($self->{'datefrom'} && $self->{'dateto'} &&
$self->{'datefrom'} > $self->{'dateto'})
{
ThrowUserError("misarranged_dates",
{'datefrom' => $cgi->param('datefrom'),
'dateto' => $cgi->param('dateto')});
}
ThrowUserError('misarranged_dates', { 'datefrom' => scalar $cgi->param('datefrom'),
'dateto' => scalar $cgi->param('dateto') });
}
}
# Alter Chart so that the selected series are added to it.
......
......@@ -182,8 +182,7 @@ use Memoize;
# CONSTANTS
#
# Bugzilla version
use constant BUGZILLA_VERSION => "4.4.5";
use constant BUGZILLA_VERSION => "4.4.6";
# Location of the remote and local XML files to track new releases.
use constant REMOTE_FILE => 'http://updates.bugzilla.org/bugzilla-update.xml';
......
......@@ -70,17 +70,18 @@ sub new {
$self->{private_bz_dsn} = $dsn;
bless ($self, $class);
# Bug 321645 - disable MySQL strict mode, if set
# Check for MySQL modes.
my ($var, $sql_mode) = $self->selectrow_array(
"SHOW VARIABLES LIKE 'sql\\_mode'");
# Disable ANSI and strict modes, else Bugzilla will crash.
if ($sql_mode) {
# STRICT_TRANS_TABLE or STRICT_ALL_TABLES enable MySQL strict mode,
# causing bug 321645. TRADITIONAL sets these modes (among others) as
# well, so it has to be stipped as well
my $new_sql_mode =
join(",", grep {$_ !~ /^STRICT_(?:TRANS|ALL)_TABLES|TRADITIONAL$/}
join(",", grep {$_ !~ /^(?:ANSI|STRICT_(?:TRANS|ALL)_TABLES|TRADITIONAL)$/}
split(/,/, $sql_mode));
if ($sql_mode ne $new_sql_mode) {
......
......@@ -455,14 +455,15 @@ sub create {
sub update {
my $self = shift;
my $dbh = Bugzilla->dbh;
my $timestamp = shift || $dbh->selectrow_array('SELECT NOW()');
my $timestamp = shift || $dbh->selectrow_array('SELECT LOCALTIMESTAMP(0)');
my $changes = $self->SUPER::update(@_);
if (scalar(keys %$changes)) {
$dbh->do('UPDATE flags SET modification_date = ? WHERE id = ?',
undef, ($timestamp, $self->id));
$self->{'modification_date'} = format_time($timestamp, '%Y.%m.%d %T');
$self->{'modification_date'} =
format_time($timestamp, '%Y.%m.%d %T', Bugzilla->local_timezone);
}
return $changes;
}
......@@ -1006,18 +1007,32 @@ sub notify {
$default_lang = Bugzilla::User->new()->setting('lang');
}
# Get comments on the bug
my $all_comments = $bug->comments({ after => $bug->lastdiffed });
@$all_comments = grep { $_->type || $_->body =~ /\S/ } @$all_comments;
# Get public only comments
my $public_comments = [ grep { !$_->is_private } @$all_comments ];
foreach my $to (keys %recipients) {
# Add threadingmarker to allow flag notification emails to be the
# threaded similar to normal bug change emails.
my $thread_user_id = $recipients{$to} ? $recipients{$to}->id : 0;
my $vars = { 'flag' => $flag,
'old_flag' => $old_flag,
'to' => $to,
'date' => $timestamp,
'bug' => $bug,
'attachment' => $attachment,
'threadingmarker' => build_thread_marker($bug->id, $thread_user_id) };
# We only want to show private comments to users in the is_insider group
my $comments = $recipients{$to} && $recipients{$to}->is_insider
? $all_comments : $public_comments;
my $vars = {
flag => $flag,
old_flag => $old_flag,
to => $to,
date => $timestamp,
bug => $bug,
attachment => $attachment,
threadingmarker => build_thread_marker($bug->id, $thread_user_id),
new_comments => $comments,
};
my $lang = $recipients{$to} ?
$recipients{$to}->setting('lang') : $default_lang;
......
......@@ -53,7 +53,7 @@ use constant UPDATE_COLUMNS => qw(
# Parameters that are lists of groups.
use constant GROUP_PARAMS => qw(chartgroup insidergroup timetrackinggroup
querysharegroup);
querysharegroup debug_group);
###############################
#### Accessors ######
......
......@@ -711,10 +711,12 @@ sub create {
},
# In CSV, quotes are doubled, and any value containing a quote or a
# comma is enclosed in quotes.
# comma is enclosed in quotes. If a field starts with an equals
# sign, it is proceed by a space.
csv => sub
{
my ($var) = @_;
$var = ' ' . $var if substr($var, 0, 1) eq '=';
$var =~ s/\"/\"\"/g;
if ($var !~ /^-?(\d+\.)?\d*$/) {
$var = "\"$var\"";
......
......@@ -569,10 +569,14 @@ sub datetime_from {
return undef if !@time;
# strptime() counts years from 1900, and months from 0 (January).
# We have to fix both values.
# strptime() counts years from 1900, except if they are older than 1901
# in which case it returns the full year (so 1890 -> 1890, but 1984 -> 84,
# and 3790 -> 1890). We make a guess and assume that 1100 <= year < 3000.
$time[5] += 1900 if $time[5] < 1100;
my %args = (
year => $time[5] + 1900,
year => $time[5],
# Months start from 0 (January).
month => $time[4] + 1,
day => $time[3],
hour => $time[2],
......
......@@ -269,7 +269,7 @@ hashes.
Some RPC calls support specifying sub fields. If an RPC call states that
it support sub field restrictions, you can restrict what information is
returned within the first field. For example, if you call Products.get
returned within the first field. For example, if you call Product.get
with an include_fields of components.name, then only the component name
would be returned (and nothing else). You can include the main field,
and exclude a sub field.
......
......@@ -205,8 +205,9 @@ sub validateContext
{
my $context = $cgi->param('context') || "patch";
if ($context ne "file" && $context ne "patch") {
detaint_natural($context)
|| ThrowUserError("invalid_context", { context => $cgi->param('context') });
my $orig_context = $context;
detaint_natural($context)
|| ThrowUserError("invalid_context", { context => $orig_context });
}
return $context;
......@@ -524,13 +525,14 @@ sub insert {
# Get the filehandle of the attachment.
my $data_fh = $cgi->upload('data');
my $attach_text = $cgi->param('attach_text');
my $attachment = Bugzilla::Attachment->create(
{bug => $bug,
creation_ts => $timestamp,
data => scalar $cgi->param('attach_text') || $data_fh,
data => $attach_text || $data_fh,
description => scalar $cgi->param('description'),
filename => $cgi->param('attach_text') ? "file_$bugid.txt" : scalar $cgi->upload('data'),
filename => $attach_text ? "file_$bugid.txt" : $data_fh,
ispatch => scalar $cgi->param('ispatch'),
isprivate => scalar $cgi->param('isprivate'),
mimetype => $content_type,
......
......@@ -916,7 +916,7 @@ if (scalar(@products) == 1) {
# This is used in the "Zarroo Boogs" case.
elsif (my @product_input = $cgi->param('product')) {
if (scalar(@product_input) == 1 and $product_input[0] ne '') {
$one_product = new Bugzilla::Product({ name => $cgi->param('product') });
$one_product = new Bugzilla::Product({ name => $product_input[0] });
}
}
# We only want the template to use it if the user can actually
......
<!ENTITY bz-ver "4.4.5">
<!ENTITY bz-date "2014-07-24">
<!ENTITY bz-ver "4.4.6">
<!ENTITY bz-date "2014-10-06">
<!ENTITY current-year "2014">
<!ENTITY min-perl-ver "5.8.1">
<!ENTITY landfillbase "http://landfill.bugzilla.org/bugzilla-4.4-branch/">
<!ENTITY bzg-bugs "http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation">
......
<!ENTITY bz-ver "4.4.5">
<!ENTITY bz-date "2014-07-24">
<!ENTITY bz-ver "4.4.6">
<!ENTITY bz-date "2014-10-06">
<!ENTITY current-year "2014">
<!ENTITY min-perl-ver "5.8.1">
<!ENTITY landfillbase "http://landfill.bugzilla.org/bugzilla-4.4-branch/">
<!ENTITY bzg-bugs "http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla;component=Documentation">
This diff is collapsed.
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. About This Guide</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="prev" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="next" href="copyright.html" title="1.1. Copyright Information"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. About This Guide</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="copyright.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="about"></a>Chapter 1. About This Guide</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="copyright.html">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="disclaimer.html">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="newversions.html">1.3. New Versions</a></span></dt><dt><span class="section"><a href="credits.html">1.4. Credits</a></span></dt><dt><span class="section"><a href="conventions.html">1.5. Document Conventions</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="copyright.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Bugzilla Guide - 4.4.5
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. About This Guide</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="prev" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="next" href="copyright.html" title="1.1. Copyright Information"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. About This Guide</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="copyright.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="about"></a>Chapter 1. About This Guide</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="copyright.html">1.1. Copyright Information</a></span></dt><dt><span class="section"><a href="disclaimer.html">1.2. Disclaimer</a></span></dt><dt><span class="section"><a href="newversions.html">1.3. New Versions</a></span></dt><dt><span class="section"><a href="credits.html">1.4. Credits</a></span></dt><dt><span class="section"><a href="conventions.html">1.5. Document Conventions</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="copyright.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Bugzilla Guide - 4.4.6
Release </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.1. Copyright Information</td></tr></table></div></body></html>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 3. Administering Bugzilla</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="prev" href="upgrade.html" title="2.7. Upgrading to New Releases"><link rel="next" href="parameters.html" title="3.1. Bugzilla Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Administering Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="parameters.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="administration"></a>Chapter 3. Administering Bugzilla</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="parameters.html">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="parameters.html#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="parameters.html#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="parameters.html#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="parameters.html#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="parameters.html#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="parameters.html#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="parameters.html#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="parameters.html#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="parameters.html#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="useradmin.html">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="useradmin.html#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="useradmin.html#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="classifications.html">3.3. Classifications</a></span></dt><dt><span class="section"><a href="products.html">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="products.html#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="products.html#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="products.html#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="products.html#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="components.html">3.5. Components</a></span></dt><dt><span class="section"><a href="versions.html">3.6. Versions</a></span></dt><dt><span class="section"><a href="milestones.html">3.7. Milestones</a></span></dt><dt><span class="section"><a href="flags-overview.html">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="flags-overview.html#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="keywords.html">3.9. Keywords</a></span></dt><dt><span class="section"><a href="custom-fields.html">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="custom-fields.html#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="edit-values.html">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="edit-values.html#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="edit-values.html#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="bug_status_workflow.html">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="voting.html">3.13. Voting</a></span></dt><dt><span class="section"><a href="quips.html">3.14. Quips</a></span></dt><dt><span class="section"><a href="groups.html">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="groups.html#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="groups.html#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="groups.html#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="groups.html#idm140031056057600">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="sanitycheck.html">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="parameters.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.7. Upgrading to New Releases </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.1. Bugzilla Configuration</td></tr></table></div></body></html>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 3. Administering Bugzilla</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="prev" href="upgrade.html" title="2.7. Upgrading to New Releases"><link rel="next" href="parameters.html" title="3.1. Bugzilla Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Administering Bugzilla</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="parameters.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="administration"></a>Chapter 3. Administering Bugzilla</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="parameters.html">3.1. Bugzilla Configuration</a></span></dt><dd><dl><dt><span class="section"><a href="parameters.html#param-requiredsettings">3.1.1. Required Settings</a></span></dt><dt><span class="section"><a href="parameters.html#param-admin-policies">3.1.2. Administrative Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-user-authentication">3.1.3. User Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-attachments">3.1.4. Attachments</a></span></dt><dt><span class="section"><a href="parameters.html#param-bug-change-policies">3.1.5. Bug Change Policies</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugfields">3.1.6. Bug Fields</a></span></dt><dt><span class="section"><a href="parameters.html#param-bugmoving">3.1.7. Bug Moving</a></span></dt><dt><span class="section"><a href="parameters.html#param-dependency-graphs">3.1.8. Dependency Graphs</a></span></dt><dt><span class="section"><a href="parameters.html#param-group-security">3.1.9. Group Security</a></span></dt><dt><span class="section"><a href="parameters.html#bzldap">3.1.10. LDAP Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#bzradius">3.1.11. RADIUS Authentication</a></span></dt><dt><span class="section"><a href="parameters.html#param-email">3.1.12. Email</a></span></dt><dt><span class="section"><a href="parameters.html#param-patchviewer">3.1.13. Patch Viewer</a></span></dt><dt><span class="section"><a href="parameters.html#param-querydefaults">3.1.14. Query Defaults</a></span></dt><dt><span class="section"><a href="parameters.html#param-shadowdatabase">3.1.15. Shadow Database</a></span></dt><dt><span class="section"><a href="parameters.html#admin-usermatching">3.1.16. User Matching</a></span></dt></dl></dd><dt><span class="section"><a href="useradmin.html">3.2. User Administration</a></span></dt><dd><dl><dt><span class="section"><a href="useradmin.html#defaultuser">3.2.1. Creating the Default User</a></span></dt><dt><span class="section"><a href="useradmin.html#manageusers">3.2.2. Managing Other Users</a></span></dt></dl></dd><dt><span class="section"><a href="classifications.html">3.3. Classifications</a></span></dt><dt><span class="section"><a href="products.html">3.4. Products</a></span></dt><dd><dl><dt><span class="section"><a href="products.html#create-product">3.4.1. Creating New Products</a></span></dt><dt><span class="section"><a href="products.html#edit-products">3.4.2. Editing Products</a></span></dt><dt><span class="section"><a href="products.html#comps-vers-miles-products">3.4.3. Adding or Editing Components, Versions and Target Milestones</a></span></dt><dt><span class="section"><a href="products.html#product-group-controls">3.4.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="components.html">3.5. Components</a></span></dt><dt><span class="section"><a href="versions.html">3.6. Versions</a></span></dt><dt><span class="section"><a href="milestones.html">3.7. Milestones</a></span></dt><dt><span class="section"><a href="flags-overview.html">3.8. Flags</a></span></dt><dd><dl><dt><span class="section"><a href="flags-overview.html#flags-simpleexample">3.8.1. A Simple Example</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-about">3.8.2. About Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-askto">3.8.3. Using flag requests</a></span></dt><dt><span class="section"><a href="flags-overview.html#flag-types">3.8.4. Two Types of Flags</a></span></dt><dt><span class="section"><a href="flags-overview.html#flags-admin">3.8.5. Administering Flags</a></span></dt></dl></dd><dt><span class="section"><a href="keywords.html">3.9. Keywords</a></span></dt><dt><span class="section"><a href="custom-fields.html">3.10. Custom Fields</a></span></dt><dd><dl><dt><span class="section"><a href="custom-fields.html#add-custom-fields">3.10.1. Adding Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#edit-custom-fields">3.10.2. Editing Custom Fields</a></span></dt><dt><span class="section"><a href="custom-fields.html#delete-custom-fields">3.10.3. Deleting Custom Fields</a></span></dt></dl></dd><dt><span class="section"><a href="edit-values.html">3.11. Legal Values</a></span></dt><dd><dl><dt><span class="section"><a href="edit-values.html#edit-values-list">3.11.1. Viewing/Editing legal values</a></span></dt><dt><span class="section"><a href="edit-values.html#edit-values-delete">3.11.2. Deleting legal values</a></span></dt></dl></dd><dt><span class="section"><a href="bug_status_workflow.html">3.12. Bug Status Workflow</a></span></dt><dt><span class="section"><a href="voting.html">3.13. Voting</a></span></dt><dt><span class="section"><a href="quips.html">3.14. Quips</a></span></dt><dt><span class="section"><a href="groups.html">3.15. Groups and Group Security</a></span></dt><dd><dl><dt><span class="section"><a href="groups.html#create-groups">3.15.1. Creating Groups</a></span></dt><dt><span class="section"><a href="groups.html#edit-groups">3.15.2. Editing Groups and Assigning Group Permissions</a></span></dt><dt><span class="section"><a href="groups.html#users-and-groups">3.15.3. Assigning Users to Groups</a></span></dt><dt><span class="section"><a href="groups.html#idm140356571134160">3.15.4. Assigning Group Controls to Products</a></span></dt></dl></dd><dt><span class="section"><a href="sanitycheck.html">3.16. Checking and Maintaining Database Integrity</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="parameters.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.7. Upgrading to New Releases </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.1. Bugzilla Configuration</td></tr></table></div></body></html>
......@@ -281,7 +281,7 @@ name="Limiting_What_Fields_Are_Returned"
<p>If you specify all the fields, then this function will return empty hashes.</p>
<p>Some RPC calls support specifying sub fields. If an RPC call states that it support sub field restrictions, you can restrict what information is returned within the first field. For example, if you call Products.get with an include_fields of components.name, then only the component name would be returned (and nothing else). You can include the main field, and exclude a sub field.</p>
<p>Some RPC calls support specifying sub fields. If an RPC call states that it support sub field restrictions, you can restrict what information is returned within the first field. For example, if you call Product.get with an include_fields of components.name, then only the component name would be returned (and nothing else). You can include the main field, and exclude a sub field.</p>
<p>Invalid field names are ignored.</p>
......
......@@ -2,13 +2,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Bugzilla 4.4.5 API Documentation</title>
<title>Bugzilla 4.4.6 API Documentation</title>
<link rel="stylesheet" title="style" type="text/css" href="./../../../style.css" media="all" >
</head>
<body class="contentspage">
<h1>Bugzilla 4.4.5 API Documentation</h1>
<h1>Bugzilla 4.4.6 API Documentation</h1>
<dl class='superindex'>
<dt><a name="Extensions">Extensions</a></dt>
<dd>
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.7. Attachments</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="bugreports.html" title="5.6. Filing Bugs"><link rel="next" href="hintsandtips.html" title="5.8. Hints and Tips"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.7. Attachments</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bugreports.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="hintsandtips.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="attachments"></a>5.7. Attachments</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.7. Attachments</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="bugreports.html" title="5.6. Filing Bugs"><link rel="next" href="hintsandtips.html" title="5.8. Hints and Tips"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.7. Attachments</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bugreports.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="hintsandtips.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="attachments"></a>5.7. Attachments</h2></div></div></div><p>
You should use attachments, rather than comments, for large chunks of ASCII
data, such as trace, debugging output files, or log files. That way, it
doesn't bloat the bug for everyone who wants to read it, and cause people to
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.3. Anatomy of a Bug</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="myaccount.html" title="5.2. Create a Bugzilla Account"><link rel="next" href="lifecycle.html" title="5.4. Life Cycle of a Bug"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.3. Anatomy of a Bug</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="myaccount.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="lifecycle.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_page"></a>5.3. Anatomy of a Bug</h2></div></div></div><p>The core of Bugzilla is the screen which displays a particular
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.3. Anatomy of a Bug</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="myaccount.html" title="5.2. Create a Bugzilla Account"><link rel="next" href="lifecycle.html" title="5.4. Life Cycle of a Bug"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.3. Anatomy of a Bug</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="myaccount.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="lifecycle.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_page"></a>5.3. Anatomy of a Bug</h2></div></div></div><p>The core of Bugzilla is the screen which displays a particular
bug. It's a good place to explain some Bugzilla concepts.
<a class="ulink" href="http://landfill.bugzilla.org/bugzilla-4.4-branch/show_bug.cgi?id=1" target="_top">
Bug 1 on Landfill</a>
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.12. Bug Status Workflow</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="edit-values.html" title="3.11. Legal Values"><link rel="next" href="voting.html" title="3.13. Voting"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.12. Bug Status Workflow</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="edit-values.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="voting.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_status_workflow"></a>3.12. Bug Status Workflow</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.12. Bug Status Workflow</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="edit-values.html" title="3.11. Legal Values"><link rel="next" href="voting.html" title="3.13. Voting"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.12. Bug Status Workflow</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="edit-values.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="voting.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bug_status_workflow"></a>3.12. Bug Status Workflow</h2></div></div></div><p>
The bug status workflow is no longer hardcoded but can be freely customized
from the web interface. Only one bug status cannot be renamed nor deleted,
UNCONFIRMED, but the workflow involving it is free. The configuration
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.6. Filing Bugs</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="query.html" title="5.5. Searching for Bugs"><link rel="next" href="attachments.html" title="5.7. Attachments"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.6. Filing Bugs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="query.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="attachments.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bugreports"></a>5.6. Filing Bugs</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="fillingbugs"></a>5.6.1. Reporting a New Bug</h3></div></div></div><p>Years of bug writing experience has been distilled for your
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>5.6. Filing Bugs</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="using.html" title="Chapter 5. Using Bugzilla"><link rel="prev" href="query.html" title="5.5. Searching for Bugs"><link rel="next" href="attachments.html" title="5.7. Attachments"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.6. Filing Bugs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="query.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Using Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="attachments.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="bugreports"></a>5.6. Filing Bugs</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="fillingbugs"></a>5.6.1. Reporting a New Bug</h3></div></div></div><p>Years of bug writing experience has been distilled for your
reading pleasure into the
<a class="ulink" href="http://landfill.bugzilla.org/bugzilla-4.4-branch/page.cgi?id=bug-writing.html" target="_top">
Bug Writing Guidelines</a>.
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.3. Classifications</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="useradmin.html" title="3.2. User Administration"><link rel="next" href="products.html" title="3.4. Products"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.3. Classifications</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="useradmin.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="products.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="classifications"></a>3.3. Classifications</h2></div></div></div><p>Classifications tend to be used in order to group several related
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.3. Classifications</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="useradmin.html" title="3.2. User Administration"><link rel="next" href="products.html" title="3.4. Products"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.3. Classifications</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="useradmin.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="products.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="classifications"></a>3.3. Classifications</h2></div></div></div><p>Classifications tend to be used in order to group several related
products into one distinct entity.</p><p>The classifications layer is disabled by default; it can be turned
on or off using the useclassification parameter,
in the <span class="emphasis"><em>Bug Fields</em></span> section of the edit parameters screen.</p><p>Access to the administration of classifications is controlled using
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.2. Command-line 'Send Unsent Bug-mail' tool</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="patches.html" title="Appendix B. Contrib"><link rel="prev" href="cmdline.html" title="B.1. Command-line Search Interface"><link rel="next" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.2. Command-line 'Send Unsent Bug-mail' tool</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cmdline.html">Prev</a> </td><th width="60%" align="center">Appendix B. Contrib</th><td width="20%" align="right"> <a accesskey="n" href="install-perlmodules-manual.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline-bugmail"></a>B.2. Command-line 'Send Unsent Bug-mail' tool</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.2. Command-line 'Send Unsent Bug-mail' tool</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="patches.html" title="Appendix B. Contrib"><link rel="prev" href="cmdline.html" title="B.1. Command-line Search Interface"><link rel="next" href="install-perlmodules-manual.html" title="Appendix C. Manual Installation of Perl Modules"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.2. Command-line 'Send Unsent Bug-mail' tool</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cmdline.html">Prev</a> </td><th width="60%" align="center">Appendix B. Contrib</th><td width="20%" align="right"> <a accesskey="n" href="install-perlmodules-manual.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline-bugmail"></a>B.2. Command-line 'Send Unsent Bug-mail' tool</h2></div></div></div><p>
Within the <code class="filename">contrib</code> directory
exists a utility with the descriptive (if compact) name
of <code class="filename">sendunsentbugmail.pl</code>. The purpose of this
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.1. Command-line Search Interface</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="patches.html" title="Appendix B. Contrib"><link rel="prev" href="patches.html" title="Appendix B. Contrib"><link rel="next" href="cmdline-bugmail.html" title="B.2. Command-line 'Send Unsent Bug-mail' tool"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.1. Command-line Search Interface</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="patches.html">Prev</a> </td><th width="60%" align="center">Appendix B. Contrib</th><td width="20%" align="right"> <a accesskey="n" href="cmdline-bugmail.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline"></a>B.1. Command-line Search Interface</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>B.1. Command-line Search Interface</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="patches.html" title="Appendix B. Contrib"><link rel="prev" href="patches.html" title="Appendix B. Contrib"><link rel="next" href="cmdline-bugmail.html" title="B.2. Command-line 'Send Unsent Bug-mail' tool"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">B.1. Command-line Search Interface</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="patches.html">Prev</a> </td><th width="60%" align="center">Appendix B. Contrib</th><td width="20%" align="right"> <a accesskey="n" href="cmdline-bugmail.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cmdline"></a>B.1. Command-line Search Interface</h2></div></div></div><p>
There are a suite of Unix utilities for searching Bugzilla from the
command line. They live in the
<code class="filename">contrib/cmdline</code> directory.
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.5. Components</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="products.html" title="3.4. Products"><link rel="next" href="versions.html" title="3.6. Versions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Components</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="products.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="versions.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="components"></a>3.5. Components</h2></div></div></div><p>Components are subsections of a Product. E.g. the computer game
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.5. Components</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="administration.html" title="Chapter 3. Administering Bugzilla"><link rel="prev" href="products.html" title="3.4. Products"><link rel="next" href="versions.html" title="3.6. Versions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Components</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="products.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Administering Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="versions.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="components"></a>3.5. Components</h2></div></div></div><p>Components are subsections of a Product. E.g. the computer game
you are designing may have a "UI"
component, an "API" component, a "Sound System" component, and a
"Plugins" component, each overseen by a different programmer. It
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.2. Configuration</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="installation.html" title="2.1. Installation"><link rel="next" href="extraconfig.html" title="2.3. Optional Additional Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.2. Configuration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="extraconfig.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuration"></a>2.2. Configuration</h2></div></div></div><div class="warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.2. Configuration</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"><link rel="prev" href="installation.html" title="2.1. Installation"><link rel="next" href="extraconfig.html" title="2.3. Optional Additional Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.2. Configuration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing Bugzilla</th><td width="20%" align="right"> <a accesskey="n" href="extraconfig.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuration"></a>2.2. Configuration</h2></div></div></div><div class="warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
Poorly-configured MySQL and Bugzilla installations have
given attackers full access to systems in the past. Please take the
security parts of these guidelines seriously, even for Bugzilla
......@@ -76,7 +76,7 @@
configuration in the "[mysqld]" section, like this:</p><pre class="screen">[mysqld]
# Allow packets up to 4MB
max_allowed_packet=4M
</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048665072"></a>2.2.2.2.2. Allow small words in full-text indexes</h5></div></div></div><p>By default, words must be at least four characters in length
</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575142192"></a>2.2.2.2.2. Allow small words in full-text indexes</h5></div></div></div><p>By default, words must be at least four characters in length
in order to be indexed by MySQL's full-text indexes. This causes
a lot of Bugzilla specific words to be missed, including "cc",
"ftp" and "uri".</p><p>MySQL can be configured to index those words by setting the
......@@ -111,7 +111,7 @@ ft_min_word_len=2</pre><p>Rebuilding the indexes can be done based on documentat
CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.*
TO bugs@localhost IDENTIFIED BY '<em class="replaceable"><code>$db_pass</code></em>';
<code class="prompt">mysql&gt;</code> FLUSH PRIVILEGES;
</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048648896"></a>2.2.2.2.4. Permit attachments table to grow beyond 4GB</h5></div></div></div><p>
</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575126016"></a>2.2.2.2.4. Permit attachments table to grow beyond 4GB</h5></div></div></div><p>
By default, MySQL will limit the size of a table to 4GB.
This limit is present even if the underlying filesystem
has no such limit. To set a higher limit, follow these
......@@ -132,7 +132,7 @@ ft_min_word_len=2</pre><p>Rebuilding the indexes can be done based on documentat
</p><div class="note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>
This does not affect Big Files, attachments that are stored directly
on disk instead of in the database.
</p></td></tr></table></div></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="postgresql"></a>2.2.2.3. PostgreSQL</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048639296"></a>2.2.2.3.1. Add a User to PostgreSQL</h5></div></div></div><p>You need to add a new user to PostgreSQL for the Bugzilla
</p></td></tr></table></div></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="postgresql"></a>2.2.2.3. PostgreSQL</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575116416"></a>2.2.2.3.1. Add a User to PostgreSQL</h5></div></div></div><p>You need to add a new user to PostgreSQL for the Bugzilla
application to use when accessing the database. The following instructions
assume the defaults in <code class="filename">localconfig</code>; if you
changed those, you need to modify the commands appropriately. You will
......@@ -142,7 +142,7 @@ ft_min_word_len=2</pre><p>Rebuilding the indexes can be done based on documentat
login as the root user, and then</p><pre class="screen"><code class="prompt">bash#</code> su - postgres</pre><p>As the postgres user, you then need to create a new user: </p><pre class="screen"><code class="prompt">bash$</code> createuser -U postgres -dRSP bugs</pre><p>When asked for a password, provide the password which will be set as
<em class="replaceable"><code>$db_pass</code></em> in <code class="filename">localconfig</code>.
The created user will not be a superuser (-S) and will not be able to create
new users (-R). He will only have the ability to create databases (-d).</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048629744"></a>2.2.2.3.2. Configure PostgreSQL</h5></div></div></div><p>Now, you will need to edit <code class="filename">pg_hba.conf</code> which is
new users (-R). He will only have the ability to create databases (-d).</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575106864"></a>2.2.2.3.2. Configure PostgreSQL</h5></div></div></div><p>Now, you will need to edit <code class="filename">pg_hba.conf</code> which is
usually located in <code class="filename">/var/lib/pgsql/data/</code>. In this file,
you will need to add a new line to it as follows:</p><p>
<code class="computeroutput">host all bugs 127.0.0.1 255.255.255.255 md5</code>
......@@ -154,7 +154,7 @@ ft_min_word_len=2</pre><p>Rebuilding the indexes can be done based on documentat
restarted, you will need to edit <code class="filename">localconfig</code>, finding
the <code class="literal">$db_driver</code> variable and setting it to
<code class="literal">Pg</code> and changing the password in <code class="literal">$db_pass</code>
to the one you picked previously, while setting up the account.</p></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="oracle"></a>2.2.2.4. Oracle</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048619520"></a>2.2.2.4.1. Create a New Tablespace</h5></div></div></div><p>
to the one you picked previously, while setting up the account.</p></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="oracle"></a>2.2.2.4. Oracle</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575096640"></a>2.2.2.4.1. Create a New Tablespace</h5></div></div></div><p>
You can use the existing tablespace or create a new one for Bugzilla.
To create a new tablespace, run the following command:
</p><pre class="programlisting">
......@@ -168,7 +168,7 @@ AUTOEXTEND ON NEXT 30M MAXSIZE UNLIMITED
<code class="filename">/u01/oradata/bugzilla.dbf</code>.
The initial size of the database file is set in this example to 500 Mb,
with an increment of 30 Mb everytime we reach the size limit of the file.
</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048614848"></a>2.2.2.4.2. Add a User to Oracle</h5></div></div></div><p>
</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575091968"></a>2.2.2.4.2. Add a User to Oracle</h5></div></div></div><p>
The user name and password must match what you set in
<code class="filename">localconfig</code> (<code class="literal">$db_user</code>
and <code class="literal">$db_pass</code>, respectively). Here, we assume that
......@@ -186,7 +186,7 @@ GRANT RESOURCE TO bugs;
-- GRANT/REVOKE SYSTEM PRIVILEGES
GRANT UNLIMITED TABLESPACE TO bugs;
GRANT EXECUTE ON CTXSYS.CTX_DDL TO bugs;
</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140031048609712"></a>2.2.2.4.3. Configure the Web Server</h5></div></div></div><p>
</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a name="idm140356575086832"></a>2.2.2.4.3. Configure the Web Server</h5></div></div></div><p>
If you use Apache, append these lines to <code class="filename">httpd.conf</code>
to set ORACLE_HOME and LD_LIBRARY_PATH. For instance:
</p><pre class="programlisting">
......@@ -203,7 +203,7 @@ SetEnv LD_LIBRARY_PATH /u01/app/oracle/product/10.2.0/lib/
The database will be stored in <code class="filename">data/db/$db_name</code>,
where <code class="literal">$db_name</code> is the database name defined
in <code class="filename">localconfig</code>.
</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm140031055562304"></a>2.2.3. checksetup.pl</h3></div></div></div><p>
</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="idm140356575077456"></a>2.2.3. checksetup.pl</h3></div></div></div><p>
Next, rerun <code class="filename">checksetup.pl</code>. It reconfirms
that all the modules are present, and notices the altered
localconfig file, which it assumes you have edited to your
......
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.5. Document Conventions</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.5 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="credits.html" title="1.4. Credits"><link rel="next" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.5. Document Conventions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="credits.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="installing-bugzilla.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="conventions"></a>1.5. Document Conventions</h2></div></div></div><p>This document uses the following conventions:</p><div class="caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a caution. Make sure to read this to not be in trouble!</p></td></tr></table></div><div class="tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a hint or tip, especially about some configuration tweaks.</p></td></tr></table></div><div class="note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is just a note, for your information.</p></td></tr></table></div><div class="warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a warning, something you should take care of.</p></td></tr></table></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.5. Document Conventions</title><link rel="stylesheet" type="text/css" href="../../style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><meta name="keywords" content="Bugzilla, Guide, installation, FAQ, administration, integration, MySQL, Mozilla, webtools"><link rel="home" href="index.html" title="The Bugzilla Guide - 4.4.6 Release"><link rel="up" href="about.html" title="Chapter 1. About This Guide"><link rel="prev" href="credits.html" title="1.4. Credits"><link rel="next" href="installing-bugzilla.html" title="Chapter 2. Installing Bugzilla"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.5. Document Conventions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="credits.html">Prev</a> </td><th width="60%" align="center">Chapter 1. About This Guide</th><td width="20%" align="right"> <a accesskey="n" href="installing-bugzilla.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="conventions"></a>1.5. Document Conventions</h2></div></div></div><p>This document uses the following conventions:</p><div class="caution" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Caution"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../images/caution.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a caution. Make sure to read this to not be in trouble!</p></td></tr></table></div><div class="tip" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../images/tip.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a hint or tip, especially about some configuration tweaks.</p></td></tr></table></div><div class="note" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is just a note, for your information.</p></td></tr></table></div><div class="warning" style="margin-left: 1em; margin-right: 1em"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.gif"></td><th align="left"></th></tr><tr><td align="left" valign="top"><p>This is a warning, something you should take care of.</p></td></tr></table></div><p>
A filename or a path to a filename is displayed like this:
<code class="filename">/path/to/filename.ext</code>
</p><p>
......