Skip to content

bugzilla
bugzilla
Commit d40758a6 authored by Christopher's avatar Christopher Committed by Frédéric Buclin
Browse files
Options

Bug 355620: Lines enclosed in <simplelist> do not wrap in the PDF version of the Bugzilla Guide

r/a=LpSolit
parent e04a9d2f
Hide whitespace changes
Inline Side-by-side
Showing with 344 additions and 185 deletions
docs/en/xml/administration.xml
View file @ d40758a6
...@@ -2434,37 +2434,72 @@ ReadOnly: ENTRY, NA/NA, CANEDIT ...@@ -2434,37 +2434,72 @@ ReadOnly: ENTRY, NA/NA, CANEDIT
<emphasis>Type:</emphasis> <emphasis>Type:</emphasis>
The type of field to create. There are The type of field to create. There are
several types available: several types available:
<simplelist> <variablelist>
<member> <varlistentry>
Bug ID: A field where you can enter the ID of another bug from <term>Bug ID:</term>
the same Bugzilla installation. To point to a bug in a remote <listitem>
installation, use the See Also field instead. <para>
</member> A field where you can enter the ID of another bug from
<member> the same Bugzilla installation. To point to a bug in a remote
Large Text Box: A multiple line box for entering free text. installation, use the See Also field instead.
</member> </para>
<member> </listitem>
Free Text: A single line box for entering free text. </varlistentry>
</member>
<member> <varlistentry>
Multiple-Selection Box: A list box where multiple options <term>Large Text Box:</term>
can be selected. After creating this field, it must be edited <listitem>
to add the selection options. See <para>
<xref linkend="edit-values-list" /> for information about A multiple line box for entering free text.
editing legal values. </para>
</member> </listitem>
<member> </varlistentry>
Drop Down: A list box where only one option can be selected.
After creating this field, it must be edited to add the <varlistentry>
selection options. See <term>Free Text:</term>
<xref linkend="edit-values-list" /> for information about <listitem>
editing legal values. <para>
</member> A single line box for entering free text.
<member> </para>
Date/Time: A date field. This field appears with a </listitem>
calendar widget for choosing the date. </varlistentry>
</member>
</simplelist> <varlistentry>
<term>Multiple-Selection Box:</term>
<listitem>
<para>
A list box where multiple options
can be selected. After creating this field, it must be edited
to add the selection options. See
<xref linkend="edit-values-list" /> for information about
editing legal values.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Drop Down:</term>
<listitem>
<para>
A list box where only one option can be selected.
After creating this field, it must be edited to add the
selection options. See
<xref linkend="edit-values-list" /> for information about
editing legal values.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Date/Time:</term>
<listitem>
<para>
A date field. This field appears with a
calendar widget for choosing the date.
</para>
</listitem>
</varlistentry>
</variablelist>
</para> </para>
</listitem> </listitem>
......
docs/en/xml/using.xml
View file @ d40758a6
...@@ -137,58 +137,108 @@ ...@@ -137,58 +137,108 @@
<orderedlist> <orderedlist>
<listitem> <listitem>
<para> <para>
<emphasis>Product and Component</emphasis>: <emphasis>Product and Component</emphasis>:
Bugs are divided up by Product and Component, with a Product Bugs are divided up by Product and Component, with a Product
having one or more Components in it. For example, having one or more Components in it. For example,
bugzilla.mozilla.org's "Bugzilla" Product is composed of several bugzilla.mozilla.org's "Bugzilla" Product is composed of several
Components: Components:
<simplelist> <variablelist>
<member> <varlistentry>
<emphasis>Administration:</emphasis> <term>Administration:</term>
Administration of a Bugzilla installation.</member> <listitem>
<para>
<member> Administration of a Bugzilla installation.
<emphasis>Bugzilla-General:</emphasis> </para>
Anything that doesn't fit in the other components, or spans </listitem>
multiple components.</member> </varlistentry>
<member> <varlistentry>
<emphasis>Creating/Changing Bugs:</emphasis> <term>Bugzilla-General:</term>
Creating, changing, and viewing bugs.</member> <listitem>
<para>
<member> Anything that doesn't fit in the other components, or spans
<emphasis>Documentation:</emphasis> multiple components.
The Bugzilla documentation, including The Bugzilla Guide.</member> </para>
</listitem>
<member> </varlistentry>
<emphasis>Email:</emphasis>
Anything to do with email sent by Bugzilla.</member> <varlistentry>
<term>Creating/Changing Bugs:</term>
<member> <listitem>
<emphasis>Installation:</emphasis> <para>
The installation process of Bugzilla.</member> Creating, changing, and viewing bugs.
</para>
<member> </listitem>
<emphasis>Query/Buglist:</emphasis> </varlistentry>
Anything to do with searching for bugs and viewing the
buglists.</member> <varlistentry>
<term>Documentation:</term>
<member> <listitem>
<emphasis>Reporting/Charting:</emphasis> <para>
Getting reports from Bugzilla.</member> The Bugzilla documentation, including The Bugzilla Guide.
</para>
<member> </listitem>
<emphasis>User Accounts:</emphasis> </varlistentry>
Anything about managing a user account from the user's perspective.
Saved queries, creating accounts, changing passwords, logging in, <varlistentry>
etc.</member> <term>Email:</term>
<listitem>
<member> <para>
<emphasis>User Interface:</emphasis> Anything to do with email sent by Bugzilla.
General issues having to do with the user interface cosmetics (not </para>
functionality) including cosmetic issues, HTML templates, </listitem>
etc.</member> </varlistentry>
</simplelist>
<varlistentry>
<term>Installation:</term>
<listitem>
<para>
The installation process of Bugzilla.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Query/Buglist:</term>
<listitem>
<para>
Anything to do with searching for bugs and viewing the
buglists.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Reporting/Charting:</term>
<listitem>
<para>
Getting reports from Bugzilla.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>User Accounts:</term>
<listitem>
<para>
Anything about managing a user account from the user's perspective.
Saved queries, creating accounts, changing passwords, logging in,
etc.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>User Interface:</term>
<listitem>
<para>
General issues having to do with the user interface cosmetics (not
functionality) including cosmetic issues, HTML templates,
etc.
</para>
</listitem>
</varlistentry>
</variablelist>
</para> </para>
</listitem> </listitem>
...@@ -302,41 +352,76 @@ ...@@ -302,41 +352,76 @@
This form can be used for time tracking. This form can be used for time tracking.
To use this feature, you have to be blessed group membership To use this feature, you have to be blessed group membership
specified by the <quote>timetrackinggroup</quote> parameter. specified by the <quote>timetrackinggroup</quote> parameter.
<simplelist> <variablelist>
<member> <varlistentry>
<emphasis>Orig. Est.:</emphasis> <term>Orig. Est.:</term>
This field shows the original estimated time.</member> <listitem>
<para>
<member> This field shows the original estimated time.
<emphasis>Current Est.:</emphasis> </para>
This field shows the current estimated time. </listitem>
This number is calculated from <quote>Hours Worked</quote> </varlistentry>
and <quote>Hours Left</quote>.</member>
<varlistentry>
<member> <term>Current Est.:</term>
<emphasis>Hours Worked:</emphasis> <listitem>
This field shows the number of hours worked.</member> <para>
This field shows the current estimated time.
<member> This number is calculated from <quote>Hours Worked</quote>
<emphasis>Hours Left:</emphasis> and <quote>Hours Left</quote>.
This field shows the <quote>Current Est.</quote> - </para>
<quote>Hours Worked</quote>. </listitem>
This value + <quote>Hours Worked</quote> will become the </varlistentry>
new Current Est.</member>
<varlistentry>
<member> <term>Hours Worked:</term>
<emphasis>%Complete:</emphasis> <listitem>
This field shows what percentage of the task is complete.</member> <para>
This field shows the number of hours worked.
<member> </para>
<emphasis>Gain:</emphasis> </listitem>
This field shows the number of hours that the bug is ahead of the </varlistentry>
<quote>Orig. Est.</quote>.</member>
<varlistentry>
<member> <term>Hours Left:</term>
<emphasis>Deadline:</emphasis> <listitem>
This field shows the deadline for this bug.</member> <para>
</simplelist> This field shows the <quote>Current Est.</quote> -
<quote>Hours Worked</quote>.
This value + <quote>Hours Worked</quote> will become the
new Current Est.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>%Complete:</term>
<listitem>
<para>
This field shows what percentage of the task is complete.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Gain:</term>
<listitem>
<para>
This field shows the number of hours that the bug is ahead of the
<quote>Orig. Est.</quote>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Deadline:</term>
<listitem>
<para>
This field shows the deadline for this bug.
</para>
</listitem>
</varlistentry>
</variablelist>
</para> </para>
</listitem> </listitem>
...@@ -603,73 +688,112 @@ ...@@ -603,73 +688,112 @@
<para>The format of the list is configurable. For example, it can be <para>The format of the list is configurable. For example, it can be
sorted by clicking the column headings. Other useful features can be sorted by clicking the column headings. Other useful features can be
accessed using the links at the bottom of the list: accessed using the links at the bottom of the list:
<simplelist> <variablelist>
<member> <varlistentry>
<emphasis>Long Format:</emphasis> <term>Long Format:</term>
<listitem>
this gives you a large page with a non-editable summary of the fields <para>
of each bug.</member> this gives you a large page with a non-editable summary of the fields
of each bug.
<member> </para>
<emphasis>XML:</emphasis> </listitem>
</varlistentry>
get the buglist in the XML format.</member>
<varlistentry>
<member> <term>XML:</term>
<emphasis>CSV:</emphasis> <listitem>
<para>
get the buglist as comma-separated values, for import into e.g. get the buglist in the XML format.
a spreadsheet.</member> </para>
</listitem>
<member> </varlistentry>
<emphasis>Feed:</emphasis>
<varlistentry>
get the buglist as an Atom feed. Copy this link into your <term>CSV:</term>
favorite feed reader. If you are using Firefox, you can also <listitem>
save the list as a live bookmark by clicking the live bookmark <para>
icon in the status bar. To limit the number of bugs in the feed, get the buglist as comma-separated values, for import into e.g.
add a limit=n parameter to the URL.</member> a spreadsheet.
</para>
<member> </listitem>
<emphasis>iCalendar:</emphasis> </varlistentry>
Get the buglist as an iCalendar file. Each bug is represented as a <varlistentry>
to-do item in the imported calendar.</member> <term>Feed:</term>
<listitem>
<member> <para>
<emphasis>Change Columns:</emphasis> get the buglist as an Atom feed. Copy this link into your
favorite feed reader. If you are using Firefox, you can also
change the bug attributes which appear in the list.</member> save the list as a live bookmark by clicking the live bookmark
icon in the status bar. To limit the number of bugs in the feed,
<member> add a limit=n parameter to the URL.
<emphasis>Change several bugs at once:</emphasis> </para>
</listitem>
If your account is sufficiently empowered, and more than one bug </varlistentry>
appear in the bug list, this link is displayed which lets you make
the same change to all the bugs in the list - for example, changing <varlistentry>
their assignee.</member> <term>iCalendar:</term>
<listitem>
<member> <para>
<emphasis>Send mail to bug assignees:</emphasis> Get the buglist as an iCalendar file. Each bug is represented as a
to-do item in the imported calendar.
If more than one bug appear in the bug list and there are at least </para>
two distinct bug assignees, this links is displayed which lets you </listitem>
easily send a mail to the assignees of all bugs on the list.</member> </varlistentry>
<member> <varlistentry>
<emphasis>Edit Search:</emphasis> <term>Change Columns:</term>
<listitem>
If you didn't get exactly the results you were looking for, you can <para>
return to the Query page through this link and make small revisions change the bug attributes which appear in the list.
to the query you just made so you get more accurate results.</member> </para>
</listitem>
<member> </varlistentry>
<emphasis>Remember Search As:</emphasis>
<varlistentry>
You can give a search a name and remember it; a link will appear <term>Change several bugs at once:</term>
in your page footer giving you quick access to run it again later. <listitem>
</member> <para>
</simplelist> If your account is sufficiently empowered, and more than one bug
appear in the bug list, this link is displayed which lets you make
the same change to all the bugs in the list - for example, changing
their assignee.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Send mail to bug assignees:</term>
<listitem>
<para>
If more than one bug appear in the bug list and there are at least
two distinct bug assignees, this links is displayed which lets you
easily send a mail to the assignees of all bugs on the list.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Edit Search:</term>
<listitem>
<para>
If you didn't get exactly the results you were looking for, you can
return to the Query page through this link and make small revisions
to the query you just made so you get more accurate results.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Remember Search As:</term>
<listitem>
<para>
You can give a search a name and remember it; a link will appear
in your page footer giving you quick access to run it again later.
</para>
</listitem>
</varlistentry>
</variablelist>
</para> </para>
</section> </section>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment