diff options
author | jake%bugzilla.org <> | 2008-04-04 13:46:34 +0200 |
---|---|---|
committer | jake%bugzilla.org <> | 2008-04-04 13:46:34 +0200 |
commit | 6d5d6dcaa66d7ccaa60807eb8b7fefa94bd32591 (patch) | |
tree | 775fdd8fbdcbfd13490045d6d03a337799bc4232 /docs | |
parent | 50d03ba7d7304ec9ff363143a4885928daad4dfe (diff) | |
download | bugzilla-6d5d6dcaa66d7ccaa60807eb8b7fefa94bd32591.tar.gz bugzilla-6d5d6dcaa66d7ccaa60807eb8b7fefa94bd32591.tar.xz |
Bug 203314 - Clean up <ulink/>'s, links to bugs and extra spaces in sentences.
Patch by Martin Wulffeld <martin@wulffeld.org>.
r,a=jake
Also, added Martin to the section about people who have made signifigant conrtibutions.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/en/xml/about.xml | 24 | ||||
-rw-r--r-- | docs/en/xml/administration.xml | 8 | ||||
-rw-r--r-- | docs/en/xml/gfdl.xml | 5 | ||||
-rw-r--r-- | docs/en/xml/installation.xml | 36 | ||||
-rw-r--r-- | docs/en/xml/integration.xml | 10 | ||||
-rw-r--r-- | docs/en/xml/patches.xml | 2 | ||||
-rw-r--r-- | docs/en/xml/requiredsoftware.xml | 31 | ||||
-rw-r--r-- | 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 @@ <para> 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 <xref linkend="gfdl"/>. </para> </blockquote> @@ -37,15 +37,15 @@ </para> <para> 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. </para> <para> 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. </para> @@ -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. </para> @@ -88,7 +88,7 @@ </para> <para> The newest version of this guide can always be found at <ulink - url="http://www.bugzilla.org">bugzilla.org</ulink>; including + url="http://www.bugzilla.org"/>; including documentation for past releases and the current development version. </para> <para> @@ -98,9 +98,8 @@ </para> <para> The latest version of this document can always be checked out via CVS. - Please follow the instructions available at - <ulink url="http://www.mozilla.org/cvs.html">the Mozilla CVS page</ulink>, - and check out the <filename>mozilla/webtools/bugzilla/docs/</filename> + Please follow the <ulink url="http://www.mozilla.org/cvs.html">Mozilla CVS</ulink> + instructions and check out the <filename>mozilla/webtools/bugzilla/docs/</filename> subtree. </para> <para> @@ -181,7 +180,7 @@ <para> Last but not least, all the members of the <ulink url="news://news.mozilla.org/netscape/public/mozilla/webtools"/> - newsgroup. Without your discussions, insight, suggestions, and patches, + newsgroup. Without your discussions, insight, suggestions, and patches, this could never have happened. </para> <para> @@ -194,6 +193,7 @@ <member>Gervase Markham</member> <member>Joe Robins</member> <member>Kevin Brannen</member> + <member>Martin Wulffeld</member> <member>Ron Teitelbaum</member> <member>Spencer Smith</member> <member>Zach Liption</member> 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 @@ <listitem> <para><emphasis>Maximum Votes a person can put on a single - bug"</emphasis>: + bug</emphasis>: 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 - <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=44659">bug - 44659</ulink> for more information. + outside the webroot. See + <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=44659"> + bug 44659</ulink> for more information. </para> <itemizedlist spacing="compact"> 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 - <ulink url="http://www.gnu.org/copyleft/"> - http://www.gnu.org/copyleft/</ulink> - - .</para> + <ulink url="http://www.gnu.org/copyleft/"/>.</para> <para>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 @@ <listitem> <para> - <ulink url="http://www.perl.org">Perl</ulink> + <ulink url="http://www.perl.org/">Perl</ulink> (&min-perl-ver;, 5.6.1 is recommended if you wish to use Bundle::Bugzilla) </para> @@ -209,7 +209,7 @@ <title>MySQL</title> <para>Visit the MySQL homepage at - <ulink url="http://www.mysql.com">www.mysql.com</ulink> + <ulink url="http://www.mysql.com"/> to grab and install the latest stable release of the server. </para> @@ -257,7 +257,7 @@ <para>Any machine that doesn't have Perl on it is a sad machine indeed. Perl can be got in source form from - <ulink url="http://www.perl.com">perl.com</ulink> for the rare + <ulink url="http://www.perl.org"/> 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 @@ </title> <para>Next, run the magic checksetup.pl script. (Many thanks to - <ulink url="mailto:holgerschurig@nikocity.de">Holger Schurig </ulink> + <ulink url="mailto:holgerschurig@nikocity.de">Holger Schurig</ulink> 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 <para>You can also try using <ulink url="http://www.openldap.org/"> OpenLDAP</ulink> with Bugzilla, using any of a number of administration - tools. You should apply the patch attached this bug: - <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=158630"> - http://bugzilla.mozilla.org/show_bug.cgi?id=158630</ulink>, then set - the following object classes for your users: + tools. You should apply the patch attached to + <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=158630">bug 158630</ulink> + , then set the following object classes for your users: <orderedlist> <listitem><para>objectClass: person</para></listitem> @@ -902,8 +901,7 @@ man 5 crontab incorporate the code changes necessary to fulfill the CERT advisory requirements mentioned in <ulink - url="http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3"> - http://www.cet.org/tech_tips/malicious_code_mitigation.html/#3</ulink>. + 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 <note> <para>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 - <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=126266">bug - 126266</ulink> for more information including progress toward making + marked up in this way to load twice. See + <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=126266">bug 126266</ulink> + for more information including progress toward making bugzilla charset aware by default. </para> </note> @@ -1032,7 +1030,7 @@ bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; chars <para>Perl for Windows can be obtained from <ulink url="http://www.activestate.com/">ActiveState</ulink>. You should be able to find a compiled binary at <ulink - url="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/">http://aspn.activestate.com/ASPN/Downloads/ActivePerl/</ulink>. + url="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/"/>. </para> </section> @@ -1059,7 +1057,7 @@ C:\perl> <command>ppm <module name></command> <tip> <para>A complete list of modules that can be installed using ppm can - be found at <ulink url="http://www.activestate.com/PPMPackages/5.6plus">http://www.activestate.com/PPMPackages/5.6plus</ulink>. + be found at <ulink url="http://www.activestate.com/PPMPackages/5.6plus"/>. </para> </tip> </section> @@ -1362,7 +1360,7 @@ deny from all <productname>Personal Web Server</productname> 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 - <ulink url="http://support.microsoft.com/support/kb/articles/Q245/2/25.asp">Q245225 </ulink> + <ulink url="http://support.microsoft.com/support/kb/articles/Q245/2/25.asp">Q245225</ulink> for <productname>Internet Information Services</productname> and <ulink url="http://support.microsoft.com/support/kb/articles/Q231/9/98.asp">Q231998</ulink> for <productname>Personal Web Server</productname>. @@ -1415,9 +1413,9 @@ proc filter_deny { why } { <warning> <para>This probably doesn't account for all possible editor backup files so you may wish to add some additional variations of - <filename>localconfig</filename>. For more information, see - <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=186383">bug - 186383</ulink> or <ulink + <filename>localconfig</filename>. For more information, see + <ulink url="http://bugzilla.mozilla.org/show_bug.cgi?id=186383"> + bug 186383</ulink> or <ulink url="http://online.securityfocus.com/bid/6501">Bugtraq ID 6501</ulink>. </para> </warning> 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 @@ <para>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: - <ulink url="http://homepages.kcbbs.gen.nz/~tonyg/"> - http://homepages.kcbbs.gen.nz/~tonyg/</ulink>. + email. Check it out at: <ulink url="http://homepages.kcbbs.gen.nz/~tonyg/"/>. </para> </section> @@ -49,16 +47,14 @@ <para>You can find the project page for Bugzilla and Teamtrack Perforce integration (p4dti) at: - <ulink url="http://www.ravenbrook.com/project/p4dti/"> - http://www.ravenbrook.com/project/p4dti</ulink> + <ulink url="http://www.ravenbrook.com/project/p4dti/"/> . <quote>p4dti</quote> is now an officially supported product from Perforce, and you can find the "Perforce Public Depot" p4dti page at - <ulink url="http://public.perforce.com/public/perforce/p4dti/index.html"> - http://public.perforce.com/public/perforce/p4dti/index.html</ulink> + <ulink url="http://public.perforce.com/public/perforce/p4dti/index.html"/> .</para> 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] <listitem> <para>There are many, many more things you can do with mod_rewrite. Please refer to the mod_rewrite documentation at - <ulink url="http://www.apache.org">http://www.apache.org</ulink>. + <ulink url="http://www.apache.org"/>. </para> </listitem> </orderedlist> 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.</para> <para>Apache Web Server: - <ulink url="http://www.apache.org/">http://www.apache.org</ulink> + <ulink url="http://www.apache.org/"/> Optional web server for Bugzilla, but recommended because of broad user base and support.</para> <para>Bugzilla: - <ulink url="http://www.bugzilla.org/"> - http://www.bugzilla.org/</ulink> + <ulink url="http://www.bugzilla.org/"/> </para> <para>MySQL: - <ulink url="http://www.mysql.com/">http://www.mysql.com/</ulink> + <ulink url="http://www.mysql.com/"/> </para> <para>Perl: - <ulink url="http://www.perl.org">http://www.perl.org/</ulink> + <ulink url="http://www.perl.org/"/> </para> <para>CPAN: - <ulink url="http://www.cpan.org/">http://www.cpan.org/</ulink> + <ulink url="http://www.cpan.org/"/> </para> <para>DBI Perl module: - <ulink url="http://www.cpan.org/modules/by-module/DBI/"> - http://www.cpan.org/modules/by-module/DBI/</ulink> + <ulink url="http://www.cpan.org/modules/by-module/DBI/"/> </para> <para>Data::Dumper module: - <ulink url="http://www.cpan.org/modules/by-module/Data/"> - http://www.cpan.org/modules/by-module/Data/</ulink> + <ulink url="http://www.cpan.org/modules/by-module/Data/"/> </para> <para>MySQL related Perl modules: - <ulink url="http://www.cpan.org/modules/by-module/Mysql/"> - http://www.cpan.org/modules/by-module/Mysql/</ulink> + <ulink url="http://www.cpan.org/modules/by-module/Mysql/"/> </para> <para>TimeDate Perl module collection: - <ulink url="http://www.cpan.org/modules/by-module/Date/"> - http://www.cpan.org/modules/by-module/Date/</ulink> + <ulink url="http://www.cpan.org/modules/by-module/Date/"/> </para> <para>GD Perl module: - <ulink url="http://www.cpan.org/modules/by-module/GD/"> - http://www.cpan.org/modules/by-module/GD/</ulink> + <ulink url="http://www.cpan.org/modules/by-module/GD/"/> Alternately, you should be able to find the latest version of GD at - <ulink url="http://www.boutell.com/gd/">http://www.boutell.com/gd/</ulink> + <ulink url="http://www.boutell.com/gd/"/> </para> <para>Chart::Base module: - <ulink url="http://www.cpan.org/modules/by-module/Chart/"> - http://www.cpan.org/modules/by-module/Chart/</ulink> + <ulink url="http://www.cpan.org/modules/by-module/Chart/"/> </para> <para>(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: - <ulink url="http://landfill.bugzilla.org/bugzilla-tip/"> - http://landfill.bugzilla.org/bugzilla-tip/</ulink> + <ulink url="http://landfill.bugzilla.org/bugzilla-tip/"/>. </para> <orderedlist> @@ -269,10 +268,7 @@ <para>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: - <ulink url="http://landfill.bugzilla.org/bugzilla-tip/query.cgi"> - landfill.bugzilla.org/bugzilla-tip/query.cgi</ulink> - - .</para> + <ulink url="http://landfill.bugzilla.org/bugzilla-tip/query.cgi"/>.</para> <para>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 - <ulink url="http://www.bugzilla.org">http://www.bugzilla.org</ulink>. + <ulink url="http://www.bugzilla.org"/>. Other strings which get linkified in the obvious manner are: <simplelist> <member>bug 12345</member> |