summaryrefslogtreecommitdiffstats
path: root/docs/sgml/Bugzilla-Guide.sgml
blob: 88daac2bb16a8481001115ccbba74f75455c2ce5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
<!DOCTYPE BOOK PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

<!-- Include macros -->
<!ENTITY about SYSTEM "about.sgml">
<!ENTITY conventions SYSTEM "conventions.sgml">
<!ENTITY doc-index SYSTEM "index.sgml">
<!ENTITY faq SYSTEM "faq.sgml">
<!ENTITY gfdl SYSTEM "gfdl.sgml">
<!ENTITY glossary SYSTEM "glossary.sgml">
<!ENTITY installation SYSTEM "installation.sgml">
<!ENTITY administration SYSTEM "administration.sgml">
<!ENTITY using SYSTEM "using.sgml">
<!ENTITY integration SYSTEM "integration.sgml">
<!ENTITY future SYSTEM "future.sgml">
<!ENTITY index SYSTEM "index.sgml">
<!ENTITY database SYSTEM "database.sgml">
<!ENTITY patches SYSTEM "patches.sgml">
<!ENTITY variants SYSTEM "variants.sgml">
<!ENTITY requiredsoftware SYSTEM "requiredsoftware.sgml">

]>

<!-- Coding standards for this document 

1.  Preface new or modified sections with a comment stating who
 modified it and when; please also use the "authorinitials" tag.

2.  There is no "two".

3.  Other than the GFDL, please use the "section" tag instead of "sect1", "sect2", etc.

4.  Use Entities to include files for new chapters in Bugzilla-Guide.sgml.

5.  Ensure all documents compile cleanly to HTML after modification.
  The errors "DTD Declaration not allowed here" and "DTDDECL catalog types not supported"
 are normal errors to be expected when compiling the whole guide.

6.  Try to index important terms wherever possible.

7.  Follow coding standards at http://www.linuxdoc.org.

8.  All tags should be lowercase (needsfix)

9.  Code being submitted for review should use the 
"review" tag. Documentation on this is available at 
http://www.linuxdoc.org/LDP/LDP-Author-Guide/tools-hints.html
 under section 4.9.4, "Making notes on the text while it's being written".

10.  Please use sensible spacing.  The comments at the very end of each Guide
 file define reasonable defaults for PSGML mode in EMACS.
  Double-indent tags, use double spacing whenever possible,
 try to avoid clutter and feel free to waste space in the code to make it more readable.

-->

<BOOK ID="index">

<!-- Header -->

  <BOOKINFO>
    <TITLE>The Bugzilla Guide</TITLE>
    <PUBDATE>2001-04-25</PUBDATE>
    <AUTHOR>
      <FIRSTNAME>Matthew</FIRSTNAME>
      <OTHERNAME>P.</OTHERNAME>
      <SURNAME>Barnson</SURNAME>
      <affiliation>
	<address><email>barnboy@trilobyte.net</email></address>
      </affiliation>
    </AUTHOR>

    <ABSTRACT>
      <PARA>This is the documentation for Bugzilla, the Mozilla bug-tracking system.</PARA>
    </ABSTRACT>

    <REVHISTORY>
      <REVISION>
	<REVNUMBER>v2.11</REVNUMBER>
	<DATE>20 December 2000</DATE>
	<AUTHORINITIALS>MPB</AUTHORINITIALS>
	<REVREMARK>Converted the README, FAQ, and DATABASE information into SGML
	  docbook format.</REVREMARK>
      </REVISION>

      <revision>
	<revnumber>2.11.1</revnumber>
	<date>06 March 2001</date>
	<authorinitials>MPB</authorinitials>
	<revremark>
	  Took way too long to revise this for 2.12 release.
	  Updated FAQ to use qandaset tags instead of literallayout,
	  cleaned up administration section, added User Guide section,
	  miscellaneous FAQ updates and third-party integration information.
	  From this point on all new tags are lowercase in preparation for the
	  2.13 release of the Guide in XML format instead of SGML.
	</revremark>
      </revision>

      <revision>
	<revnumber>2.12.0</revnumber>
	<date>24 April 2001</date>
	<authorinitials>MPB</authorinitials>
	<revremark>
	  Things fixed this release: Elaborated on queryhelp interface, added FAQ regarding
	  moving bugs from one keyword to another, clarified possible problems with the Landfill
	  tutorial, fixed a boatload of typos and unclear sentence structures.  Incorporated the
	  README into the UNIX installation section, and changed the README to indicate the deprecated
	  status.  Things I know need work:  Used "simplelist" a lot, where I should have used
	  "procedure" to tag things.  Need to lowercase all tags to be XML compliant.
	</revremark>
      </revision>
    </REVHISTORY>

    <KEYWORDSET>
      <KEYWORD>Bugzilla</KEYWORD>
      <KEYWORD>Guide</KEYWORD>
      <KEYWORD>installation</KEYWORD>
      <KEYWORD>FAQ</KEYWORD>
      <KEYWORD>administration</KEYWORD>
      <KEYWORD>integration</KEYWORD>
      <KEYWORD>MySQL</KEYWORD>
      <KEYWORD>Mozilla</KEYWORD>
      <KEYWORD>webtools</KEYWORD>
    </KEYWORDSET>
  </BOOKINFO>

<!-- About This Guide -->
&about;

<!-- Installing Bugzilla -->
&installation;

<!-- Administering Bugzilla -->
&administration;

<!-- Using Bugzilla -->
&using;

<!-- Integrating Bugzilla with Third-Party Tools -->
&integration;

<!-- The Future of Bugzilla -->
&future;

<!-- Appendix: The Frequently Asked Questions -->
&faq;

<!-- Appendix: Required Bugzilla Software Links -->
&requiredsoftware

<!-- Appendix: The Database Schema -->
&database;

<!-- Appendix: Major Bugzilla Variants -->
&variants;

<!-- Appendix: Custom Patches -->
&patches;

<!-- Appendix: The GNU Free Documentation License -->
&gfdl;

<!-- Glossary -->
&glossary;

<!-- Index -->
&index;

</BOOK>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->