From 6d5d6dcaa66d7ccaa60807eb8b7fefa94bd32591 Mon Sep 17 00:00:00 2001 From: "jake%bugzilla.org" <> Date: Fri, 4 Apr 2008 11:46:34 +0000 Subject: Bug 203314 - Clean up 's, links to bugs and extra spaces in sentences. Patch by Martin Wulffeld . r,a=jake Also, added Martin to the section about people who have made signifigant conrtibutions. --- docs/en/xml/about.xml | 24 ++++++++++++------------ docs/en/xml/administration.xml | 8 ++++---- docs/en/xml/gfdl.xml | 5 +---- docs/en/xml/installation.xml | 36 +++++++++++++++++------------------- docs/en/xml/integration.xml | 10 +++------- docs/en/xml/patches.xml | 2 +- docs/en/xml/requiredsoftware.xml | 31 ++++++++++++------------------- docs/en/xml/using.xml | 10 +++------- 8 files changed, 53 insertions(+), 73 deletions(-) diff --git a/docs/en/xml/about.xml b/docs/en/xml/about.xml index f3a9a1c5f..3b0f18e0f 100644 --- a/docs/en/xml/about.xml +++ b/docs/en/xml/about.xml @@ -11,9 +11,9 @@ Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation - License, Version 1.1 or any later version published by the + License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no - Front-Cover Texts, and with no Back-Cover Texts. A copy of + Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in . @@ -37,15 +37,15 @@ All copyrights are held by their respective owners, unless - specifically noted otherwise. Use of a term in this document + specifically noted otherwise. Use of a term in this document should not be regarded as affecting the validity of any trademark or service mark. Naming of particular products or brands should not be seen as - endorsements, with the exception of the term "GNU/Linux". We + endorsements, with the exception of the term "GNU/Linux". We wholeheartedly endorse the use of GNU/Linux in every situation - where it is appropriate. It is an extremely versatile, stable, + where it is appropriate. It is an extremely versatile, stable, and robust operating system that offers an ideal operating environment for Bugzilla. @@ -60,10 +60,10 @@ documented or fixed in the code, security holes surely exist. Great care should be taken both in the installation and usage of this software. Carefully consider the implications of installing - other network services with Bugzilla. The Bugzilla development + other network services with Bugzilla. The Bugzilla development team members, Netscape Communications, America Online Inc., and any affiliated developers or sponsors assume no liability for - your use of this product. You have the source code to this + your use of this product. You have the source code to this product, and are responsible for auditing it yourself to ensure your security needs are met. @@ -88,7 +88,7 @@ The newest version of this guide can always be found at bugzilla.org; including + url="http://www.bugzilla.org"/>; including documentation for past releases and the current development version. @@ -98,9 +98,8 @@ The latest version of this document can always be checked out via CVS. - Please follow the instructions available at - the Mozilla CVS page, - and check out the mozilla/webtools/bugzilla/docs/ + Please follow the Mozilla CVS + instructions and check out the mozilla/webtools/bugzilla/docs/ subtree. @@ -181,7 +180,7 @@ Last but not least, all the members of the - newsgroup. Without your discussions, insight, suggestions, and patches, + newsgroup. Without your discussions, insight, suggestions, and patches, this could never have happened. @@ -194,6 +193,7 @@ Gervase Markham Joe Robins Kevin Brannen + Martin Wulffeld Ron Teitelbaum Spencer Smith Zach Liption diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml index afe50c789..2382fca82 100644 --- a/docs/en/xml/administration.xml +++ b/docs/en/xml/administration.xml @@ -618,7 +618,7 @@ Maximum Votes a person can put on a single - bug": + bug: It should probably be some number lower than the "Maximum votes per person". Don't set this field to "0" if "Maximum votes per person" is non-zero; that doesn't make @@ -884,9 +884,9 @@ skip-networking not be accessible is rather complicated. A new installation method is currently in the works which should solve this by allowing files that shouldn't be accessible from the web to be placed in directory - outside the webroot. See - bug - 44659 for more information. + outside the webroot. See + + bug 44659 for more information. diff --git a/docs/en/xml/gfdl.xml b/docs/en/xml/gfdl.xml index ae19501d2..93987caf6 100644 --- a/docs/en/xml/gfdl.xml +++ b/docs/en/xml/gfdl.xml @@ -381,10 +381,7 @@ the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See - - http://www.gnu.org/copyleft/ - - . + . Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml index 9964b88c8..142afaba7 100644 --- a/docs/en/xml/installation.xml +++ b/docs/en/xml/installation.xml @@ -44,7 +44,7 @@ - Perl + Perl (&min-perl-ver;, 5.6.1 is recommended if you wish to use Bundle::Bugzilla) @@ -209,7 +209,7 @@ MySQL Visit the MySQL homepage at - www.mysql.com + to grab and install the latest stable release of the server. @@ -257,7 +257,7 @@ Any machine that doesn't have Perl on it is a sad machine indeed. Perl can be got in source form from - perl.com for the rare + for the rare *nix systems which don't have it. Although Bugzilla runs with perl &min-perl-ver;, it's a good idea to be up to the very latest version @@ -620,7 +620,7 @@ Next, run the magic checksetup.pl script. (Many thanks to - Holger Schurig + Holger Schurig for writing this script!) This script is designed to make sure your MySQL database and other configuration options are consistent with the Bugzilla CGI files. @@ -870,10 +870,9 @@ man 5 crontab You can also try using OpenLDAP with Bugzilla, using any of a number of administration - tools. You should apply the patch attached this bug: - - http://bugzilla.mozilla.org/show_bug.cgi?id=158630, then set - the following object classes for your users: + tools. You should apply the patch attached to + bug 158630 + , then set the following object classes for your users: objectClass: person @@ -902,8 +901,7 @@ man 5 crontab incorporate the code changes necessary to fulfill the CERT advisory requirements mentioned in - http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3. + url="http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3"/>. Executing the following code snippet from a UNIX command shell will rectify the problem if your Bugzilla installation is intended for an English-speaking audience. As always, be sure your Bugzilla @@ -931,9 +929,9 @@ bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; chars Using <meta> tags to set the charset is not recommended, as there's a bug in Netscape 4.x which causes pages - marked up in this way to load twice. See - bug - 126266 for more information including progress toward making + marked up in this way to load twice. See + bug 126266 + for more information including progress toward making bugzilla charset aware by default. @@ -1032,7 +1030,7 @@ bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; chars Perl for Windows can be obtained from ActiveState. You should be able to find a compiled binary at http://aspn.activestate.com/ASPN/Downloads/ActivePerl/. + url="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/"/>. @@ -1059,7 +1057,7 @@ C:\perl> ppm <module name> A complete list of modules that can be installed using ppm can - be found at http://www.activestate.com/PPMPackages/5.6plus. + be found at . @@ -1362,7 +1360,7 @@ deny from all Personal Web Server you should be able to. You will need to configure them to know how to run CGI scripts, however. This is described in Microsoft Knowledge Base article - Q245225 + Q245225 for Internet Information Services and Q231998 for Personal Web Server. @@ -1415,9 +1413,9 @@ proc filter_deny { why } { This probably doesn't account for all possible editor backup files so you may wish to add some additional variations of - localconfig. For more information, see - bug - 186383 or localconfig. For more information, see + + bug 186383 or Bugtraq ID 6501. diff --git a/docs/en/xml/integration.xml b/docs/en/xml/integration.xml index 514064d26..65451dc75 100644 --- a/docs/en/xml/integration.xml +++ b/docs/en/xml/integration.xml @@ -36,9 +36,7 @@ There is also a CVSZilla project, based upon somewhat dated Bugzilla code, to integrate CVS and Bugzilla through CVS' ability to - email. Check it out at: - - http://homepages.kcbbs.gen.nz/~tonyg/. + email. Check it out at: . @@ -49,16 +47,14 @@ You can find the project page for Bugzilla and Teamtrack Perforce integration (p4dti) at: - - http://www.ravenbrook.com/project/p4dti + . p4dti is now an officially supported product from Perforce, and you can find the "Perforce Public Depot" p4dti page at - - http://public.perforce.com/public/perforce/p4dti/index.html + . diff --git a/docs/en/xml/patches.xml b/docs/en/xml/patches.xml index 84d83d333..b8c068fac 100644 --- a/docs/en/xml/patches.xml +++ b/docs/en/xml/patches.xml @@ -37,7 +37,7 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R] There are many, many more things you can do with mod_rewrite. Please refer to the mod_rewrite documentation at - http://www.apache.org. + . diff --git a/docs/en/xml/requiredsoftware.xml b/docs/en/xml/requiredsoftware.xml index 95988ec83..8a8c35774 100644 --- a/docs/en/xml/requiredsoftware.xml +++ b/docs/en/xml/requiredsoftware.xml @@ -6,59 +6,52 @@ stay current for a while. Apache Web Server: - http://www.apache.org + Optional web server for Bugzilla, but recommended because of broad user base and support. Bugzilla: - - http://www.bugzilla.org/ + MySQL: - http://www.mysql.com/ + Perl: - http://www.perl.org/ + CPAN: - http://www.cpan.org/ + DBI Perl module: - - http://www.cpan.org/modules/by-module/DBI/ + Data::Dumper module: - - http://www.cpan.org/modules/by-module/Data/ + MySQL related Perl modules: - - http://www.cpan.org/modules/by-module/Mysql/ + TimeDate Perl module collection: - - http://www.cpan.org/modules/by-module/Date/ + GD Perl module: - - http://www.cpan.org/modules/by-module/GD/ + Alternately, you should be able to find the latest version of GD at - http://www.boutell.com/gd/ + Chart::Base module: - - http://www.cpan.org/modules/by-module/Chart/ + (But remember, Bundle::Bugzilla will install all the modules for you.) diff --git a/docs/en/xml/using.xml b/docs/en/xml/using.xml index b5dab9d0a..e74c1ead3 100644 --- a/docs/en/xml/using.xml +++ b/docs/en/xml/using.xml @@ -22,8 +22,7 @@ Consult with the administrator responsible for your installation of Bugzilla for the URL you should use to access it. If you're test-driving Bugzilla, use this URL: - - http://landfill.bugzilla.org/bugzilla-tip/ + . @@ -269,10 +268,7 @@ The Bugzilla Search page is is the interface where you can find any bug report, comment, or patch currently in the Bugzilla system. You can play with it here: - - landfill.bugzilla.org/bugzilla-tip/query.cgi - - . + . The Search page has controls for selecting different possible values for all of the fields in a bug, as described above. Once you've @@ -392,7 +388,7 @@ However, Bugzilla will automatically make hyperlinks out of certain sorts of text in comments. For example, the text http://www.bugzilla.org will be turned into - http://www.bugzilla.org. + . Other strings which get linkified in the obvious manner are: bug 12345 -- cgit v1.2.3-24-g4f1b