From 1fc708bbd41eb6a5567adb2411b2ab57ddbf2cf4 Mon Sep 17 00:00:00 2001 From: "barnboy%trilobyte.net" <> Date: Fri, 4 Apr 2008 11:45:59 +0000 Subject: Initial conversion to XML format from SGML. Note this is a work-in-progress. It compiles cleanly, but I am not yet submitting compiled HTML and text. There is one notable problem: nsgmls barfs on the tag in database.sgml during validation. openjade handles it fine. Weird. --- docs/en/xml/Bugzilla-Guide.xml | 34 ++++++++++++++-------------- docs/en/xml/administration.xml | 4 ++-- docs/en/xml/gfdl.xml | 24 ++++++++++---------- docs/en/xml/glossary.xml | 38 ++++++++++++++++---------------- docs/en/xml/installation.xml | 50 +++++++++++++++++++++--------------------- docs/en/xml/integration.xml | 4 ++-- docs/en/xml/using.xml | 8 +++---- 7 files changed, 81 insertions(+), 81 deletions(-) (limited to 'docs/en/xml') diff --git a/docs/en/xml/Bugzilla-Guide.xml b/docs/en/xml/Bugzilla-Guide.xml index 8f2136bd8..6d49d9be8 100644 --- a/docs/en/xml/Bugzilla-Guide.xml +++ b/docs/en/xml/Bugzilla-Guide.xml @@ -1,4 +1,4 @@ - @@ -148,16 +148,16 @@ try to avoid clutter and feel free to waste space in the code to make it more re Bugzilla is an enterprise-class set of software utilities that, when used together, power issue-tracking for hundreds of organizations around the world, tracking millions of bugs. - While it is easy to use and quite flexible, it is very + While it is easy to use and quite flexible, it is difficult for a novice to install and maintain. Although we have provided step-by-step directions, Bugzilla is not always easy to get working. Please be sure the person responsible for installing and maintaining this software is a qualified - professional on operating system upon which you install + professional for the operating system upon which you install Bugzilla. - THIS DOCUMENTATION IS MAINTAINED IN DOCBOOK 4.1 SGML FORMAT. + THIS DOCUMENTATION IS MAINTAINED IN DOCBOOK 4.1.2 XML FORMAT. IF YOU WISH TO MAKE CORRECTIONS, PLEASE MAKE THEM IN PLAIN TEXT OR SGML DIFFS AGAINST THE SOURCE. I CANNOT ACCEPT ADDITIONS TO THE GUIDE WRITTEN IN HTML! @@ -165,18 +165,18 @@ try to avoid clutter and feel free to waste space in the code to make it more re - - Bugzilla - Guide - installation - FAQ - administration - integration - MySQL - Mozilla - webtools - - + + Bugzilla + Guide + installation + FAQ + administration + integration + MySQL + Mozilla + webtools + + &about; @@ -203,7 +203,7 @@ try to avoid clutter and feel free to waste space in the code to make it more re &faq; -&requiredsoftware +&requiredsoftware; &database; diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml index 98e726312..39e80c650 100644 --- a/docs/en/xml/administration.xml +++ b/docs/en/xml/administration.xml @@ -8,7 +8,7 @@ - So you followed to the + So you followed to the letter, and logged into Bugzilla for the very first time with your super-duper god account. You sit, contentedly staring at the Bugzilla Query Screen, the worst of the whole mad business of @@ -623,7 +623,7 @@ Formerly, and in some spots still, called "Programs" - Products are + Products are the broadest category in Bugzilla, and you should have the least of these. If your company makes computer games, you should have one product per game, and possibly a few special diff --git a/docs/en/xml/gfdl.xml b/docs/en/xml/gfdl.xml index 7d8d9967f..5351b41d2 100644 --- a/docs/en/xml/gfdl.xml +++ b/docs/en/xml/gfdl.xml @@ -18,7 +18,7 @@ Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. - + PREAMBLE The purpose of this License is to make a manual, textbook, @@ -45,7 +45,7 @@ of this license document, but changing it is not allowed. whose purpose is instruction or reference. - + APPLICABILITY AND DEFINITIONS This License applies to any manual or other work that @@ -113,7 +113,7 @@ of this license document, but changing it is not allowed. text. - + VERBATIM COPYING You may copy and distribute the Document in any medium, @@ -131,7 +131,7 @@ of this license document, but changing it is not allowed. above, and you may publicly display copies. - + COPYING IN QUANTITY If you publish printed copies of the Document numbering more @@ -173,7 +173,7 @@ of this license document, but changing it is not allowed. updated version of the Document. - + MODIFICATIONS You may copy and distribute a Modified Version of the @@ -304,7 +304,7 @@ of this license document, but changing it is not allowed. or to assert or imply endorsement of any Modified Version. - + COMBINING DOCUMENTS You may combine the Document with other documents released @@ -331,7 +331,7 @@ of this license document, but changing it is not allowed. must delete all sections entitled "Endorsements." - + COLLECTIONS OF DOCUMENTS You may make a collection consisting of the Document and @@ -348,7 +348,7 @@ of this license document, but changing it is not allowed. copying of that document. - + AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other @@ -369,7 +369,7 @@ of this license document, but changing it is not allowed. aggregate. - + TRANSLATION Translation is considered a kind of modification, so you may @@ -385,7 +385,7 @@ of this license document, but changing it is not allowed. prevail. - + TERMINATION You may not copy, modify, sublicense, or distribute the @@ -398,7 +398,7 @@ of this license document, but changing it is not allowed. compliance. - + FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new, revised @@ -419,7 +419,7 @@ of this license document, but changing it is not allowed. Free Software Foundation. - + How to use this License for your documents To use this License in a document you have written, include diff --git a/docs/en/xml/glossary.xml b/docs/en/xml/glossary.xml index faa4d1781..0ba9d87b5 100644 --- a/docs/en/xml/glossary.xml +++ b/docs/en/xml/glossary.xml @@ -23,7 +23,7 @@ - + A Apache @@ -40,7 +40,7 @@ - + B Bug @@ -89,9 +89,9 @@ - + - + Component @@ -103,7 +103,7 @@ - + CPAN CPAN stands for the @@ -117,7 +117,7 @@ - + D daemon @@ -132,7 +132,7 @@ - + Groups @@ -148,9 +148,9 @@ - + I - + Infinite Loop A loop of information that never ends; see recursion. @@ -158,7 +158,7 @@ - + M mysqld @@ -173,10 +173,10 @@ - + P - Product + Product A Product is a broad category of types of bugs. In general, there are several Components to a Product. A @@ -212,7 +212,7 @@ - + Q QA @@ -229,9 +229,9 @@ - + R - + Recursion The property of a function looking back at itself for @@ -243,7 +243,7 @@ - + S SGML @@ -266,9 +266,9 @@ - + T - + Target Milestone @@ -285,7 +285,7 @@ - + Z Zarro Boogs Found diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml index 7e4db1eb6..37d339e93 100644 --- a/docs/en/xml/installation.xml +++ b/docs/en/xml/installation.xml @@ -92,7 +92,7 @@ Bugzilla has been successfully installed under Solaris, Linux, and Win32. The peculiarities of installing on Win32 (Microsoft Windows) are not included in this section of the Guide; please - check out the for further advice + check out the for further advice on getting Bugzilla to work on Microsoft Windows. @@ -109,7 +109,7 @@ the CPAN dependencies listed below, and are running the very most recent version of Perl and MySQL (both the executables and development libraries) on your system, check out - Bundle::Bugzilla in + Bundle::Bugzilla in The software packages necessary for the proper running of bugzilla are: @@ -286,7 +286,7 @@ You can skip the following Perl module installation steps by installing Bundle::Bugzilla from - CPAN, which + CPAN, which includes them. All Perl module installation steps require you have an active Internet connection. If you wish to use Bundle::Bugzilla, however, you must be using the latest @@ -319,7 +319,7 @@ Like almost all Perl modules DBI can be found on the Comprehensive Perl Archive Network (CPAN) at http://www.cpan.org. The CPAN servers have a real tendency to bog down, so please use mirrors. The current location - at the time of this writing can be found in . + at the time of this writing can be found in . Quality, general Perl module installation instructions can be found on @@ -397,7 +397,7 @@ Data::Dumper is used by the MySQL-related Perl modules. It - can be found on CPAN (see ) and + can be found on CPAN (see ) and can be installed by following the same four step make sequence used for the DBI module. @@ -445,7 +445,7 @@ Many of the more common date/time/calendar related Perl modules have been grouped into a bundle similar to the MySQL modules bundle. This bundle is stored on the CPAN under the - name TimeDate (see link: ). The + name TimeDate (see link: ). The component module we're most interested in is the Date::Format module, but installing all of them is probably a good idea anyway. The standard Perl module installation instructions @@ -467,7 +467,7 @@ Actually bugzilla uses the Graph module which relies on GD itself. Isn't that always the way with object-oriented programming? At any rate, you can find the GD library on CPAN - in . + in . @@ -488,7 +488,7 @@ The Chart module provides bugzilla with on-the-fly charting abilities. It can be installed in the usual fashion after it has been fetched from CPAN where it is found as the - Chart-x.x... tarball, linked in . Note that + Chart-x.x... tarball, linked in . Note that as with the GD perl module, only the version listed above, or newer, will work. Earlier versions used GIF's, which are no longer supported by the latest versions of GD. @@ -555,7 +555,7 @@ Options ExecCGI and the localconfig file. You should configure your HTTP server to not serve content from these files. Failure to do so will expose critical passwords and - other data. Please see for details + other data. Please see for details on how to do this for Apache. I appreciate notes on how to get this same functionality using other webservers. @@ -597,8 +597,8 @@ Options ExecCGI location of your perl executable (probably /usr/bin/perl). Otherwise you must hack all the .cgi files to change where they look for perl, or use - , found in - . I suggest using the symlink + , found in + . I suggest using the symlink approach for future release compatability. Setting up bonsaitools symlink @@ -630,8 +630,8 @@ perl -pi -e 's@#!/usr/bonsaitools/bin/perl@#!/usr/bin/perl@' *cgi *pl Bug.pm If you don't have root access to set this symlink up, check out the - , listed in . It will change the path to perl in all your Bugzilla files for you. + , listed in . It will change the path to perl in all your Bugzilla files for you. @@ -773,7 +773,7 @@ perl -pi -e 's@#!/usr/bonsaitools/bin/perl@#!/usr/bin/perl@' *cgi *pl Bug.pm You should also install .htaccess files that the Apache webserver will use to restrict access to Bugzilla data files. See . + linkend="htaccess" />. Once you are happy with the settings, re-run @@ -993,7 +993,7 @@ bash# ./checksetup.pl Use .htaccess files with the Apache webserver to secure your - bugzilla install. See + bugzilla install. See Consider also: @@ -1136,7 +1136,7 @@ bash# ./checksetup.pl BSD Installation Notes For instructions on how to set up Bugzilla on FreeBSD, NetBSD, OpenBSD, BSDi, etc. please - consult . + consult . @@ -1213,7 +1213,7 @@ bash# ./checksetup.pl -
+
<filename>mod_throttle</filename> and Security It is possible for a user, by mistake or on purpose, to access @@ -1226,7 +1226,7 @@ bash# ./checksetup.pl url="http://www.snert.com/Software/Throttle/">http://www.snert.com/Software/Throttle/. Follow the instructions to install into your Apache install. This module only functions with the Apache web server!. You may use the ThrottleClientIP command provided by this module to accomplish this goal. See the Module Instructions for more information.
-
+
Preventing untrusted Bugzilla content from executing malicious Javascript code It is possible for a Bugzilla to execute malicious Javascript code. Due to internationalization concerns, we are @@ -1260,7 +1260,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ The February 25, 1999 re-write of this page was done by Ry4an Brase <ry4an@ry4an.org>, with some edits by Terry - Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But + Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But don't send bug reports to them; report them using bugzilla, at http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla ). @@ -1306,7 +1306,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ You should be familiar with, and cross-reference, the rest of the - section while performing your + section while performing your Win32 installation. Making Bugzilla work on Microsoft Windows is no @@ -1318,7 +1318,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ requires hacking source code and implementing some advanced utilities. What follows is the recommended installation procedure for Win32; additional suggestions are provided in - . + . @@ -1328,7 +1328,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ Install Apache Web Server for Windows, and copy the Bugzilla files somewhere Apache can serve them. Please follow all the - instructions referenced in + instructions referenced in regarding your Apache configuration, particularly instructions regarding the AddHandler parameter and ExecCGI. @@ -1339,7 +1339,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ Web Server for this purpose. However, setup is quite different. If ActivePerl doesn't seem to handle your file associations correctly (for .cgi and .pl files), - please consult . + please consult . If you are going to use IIS, if on Windows NT you must @@ -1521,7 +1521,7 @@ my $webservergid = 'Administrators' Edit localconfig to suit your requirements. Set $db_pass to your - bugs_password from , and $webservergroup to 8. + bugs_password from , and $webservergroup to 8. Not sure on the 8 for $webservergroup above. If it's @@ -1696,7 +1696,7 @@ exit; calls that use a perl script as an argument. This may take you a while. There is a setperl.csh utility to speed part of this procedure, available in the - section of The Bugzilla Guide. + section of The Bugzilla Guide. However, it requires the Cygwin GNU-compatible environment for Win32 be set up in order to work. See http://www.cygwin.com/ for details on obtaining Cygwin. diff --git a/docs/en/xml/integration.xml b/docs/en/xml/integration.xml index 36cc617e2..dd1729761 100644 --- a/docs/en/xml/integration.xml +++ b/docs/en/xml/integration.xml @@ -8,7 +8,7 @@
Bonsai Bonsai is a web-based tool for managing + linkend="cvs" /> . Using Bonsai, administrators can control open/closed status of trees, query a fast relational database back-end for change, branch, and comment information, and view changes made since the @@ -16,7 +16,7 @@ engineer responsible to be on the hook (include cool URL link here for Hook policies at mozilla.org). Bonsai also includes gateways to and Bugzilla + linkend="tinderbox" /> and Bugzilla
diff --git a/docs/en/xml/using.xml b/docs/en/xml/using.xml index 934817081..e0c61740b 100644 --- a/docs/en/xml/using.xml +++ b/docs/en/xml/using.xml @@ -31,7 +31,7 @@ Chapter: Using Bugzilla Using Bugzilla - What, Why, How, & Where? + What, Why, How, & Where? @@ -612,7 +612,7 @@ system against which all others are measured. And all this time, I thought we were taking bugs out... -
+
Writing a Great Bug Report Before we plunge into writing your first bug report, I @@ -701,7 +701,7 @@ system against which all others are measured.
-
+
Managing your Bug Reports OK, you should have a link to the bug you just created near @@ -812,7 +812,7 @@ system against which all others are measured. their flow charts and know when it is time to pull the bug onto a quality assurance platform for inspection. Other people set up email gateways to - or , and + or , and restrict which types of Bugzilla information are fed to these systems.. -- cgit v1.2.3-24-g4f1b