From bce648342fa487a9afba9124b1db402678f0d67f Mon Sep 17 00:00:00 2001 From: Gervase Markham Date: Mon, 27 Jan 2014 15:08:01 +0000 Subject: Bug 962571 - Fix syntax highlighting of code blocks. r=LpSolit, a=justdave. --- docs/en/rst/customization.rst | 30 ++++---- docs/en/rst/installation.rst | 163 +++++++++++++++++++++------------------- docs/en/rst/modules.rst | 14 ++-- docs/en/rst/troubleshooting.rst | 24 +++--- 4 files changed, 121 insertions(+), 110 deletions(-) (limited to 'docs') diff --git a/docs/en/rst/customization.rst b/docs/en/rst/customization.rst index 4238f1650..929c75279 100644 --- a/docs/en/rst/customization.rst +++ b/docs/en/rst/customization.rst @@ -1,4 +1,4 @@ - +.. highlight:: perl .. _customization: @@ -406,7 +406,7 @@ In between those sections, you'll find snippets of code like: # Allow the assignee to change anything. if ($ownerid eq $whoid) { - return 1; + return 1; } It's fairly obvious what this piece of code does. @@ -428,12 +428,12 @@ or a negative check, which returns 0 (deny.) E.g.: :: if ($field eq "qacontact") { - if (Bugzilla->user->in_group("quality_assurance")) { - return 1; - } - else { - return 0; - } + if (Bugzilla->user->in_group("quality_assurance")) { + return 1; + } + else { + return 0; + } } This says that only users in the group "quality_assurance" can change @@ -444,14 +444,14 @@ Getting more weird: :: if (($field eq "priority") && - (Bugzilla->user->email =~ /.*\\@example\\.com$/)) + (Bugzilla->user->email =~ /.*\\@example\\.com$/)) { - if ($oldvalue eq "P1") { - return 1; - } - else { - return 0; - } + if ($oldvalue eq "P1") { + return 1; + } + else { + return 0; + } } This says that if the user is trying to change the priority field, diff --git a/docs/en/rst/installation.rst b/docs/en/rst/installation.rst index d9a8488f5..38187613c 100644 --- a/docs/en/rst/installation.rst +++ b/docs/en/rst/installation.rst @@ -1,4 +1,4 @@ - +.. highlight:: console .. _installing-bugzilla: @@ -61,7 +61,7 @@ Perl Installed Version Test: :: - perl -v + $ perl -v Any machine that doesn't have Perl on it is a sad machine indeed. If you don't have it and your OS doesn't provide official packages, @@ -85,7 +85,7 @@ MySQL Installed Version Test: :: - mysql -V + $ mysql -V If you don't have it and your OS doesn't provide official packages, visit ``_. You need MySQL version @@ -111,7 +111,7 @@ PostgreSQL Installed Version Test: :: - psql -V + $ psql -V If you don't have it and your OS doesn't provide official packages, visit ``_. You need PostgreSQL @@ -128,9 +128,10 @@ Oracle ------ Installed Version Test: -:: - select * from v$version +.. code-block:: sql + + SELECT * FROM v$version (you first have to log in into your DB) @@ -205,7 +206,7 @@ required modules, run: :: - bash# ./checksetup.pl --check-modules + # ./checksetup.pl --check-modules :file:`checksetup.pl` will print out a list of the required and optional Perl modules, together with the versions @@ -226,7 +227,7 @@ you invoke :file:`install-module.pl` as follows: :: - bash# perl install-module.pl + # perl install-module.pl .. note:: Many people complain that Perl modules will not install for them. Most times, the error messages complain that they are missing a @@ -407,7 +408,7 @@ without the ``--check-modules`` switch. :: - bash# ./checksetup.pl + # ./checksetup.pl This time, :file:`checksetup.pl` should tell you that all the correct modules are installed and will display a message about, and @@ -552,13 +553,14 @@ machine or as a different user. Run the :file:`mysql` command-line client and enter: -:: +.. code-block:: sql - mysql> GRANT SELECT, INSERT, + GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, ALTER, CREATE, LOCK TABLES, CREATE TEMPORARY TABLES, DROP, REFERENCES ON bugs.* TO bugs@localhost IDENTIFIED BY '$db_pass'; - mysql> FLUSH PRIVILEGES; + + FLUSH PRIVILEGES; Permit attachments table to grow beyond 4GB ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -573,11 +575,11 @@ database setup parts), you should run the :file:`MySQL` command-line client and enter the following, replacing ``$bugs_db`` with your Bugzilla database name (*bugs* by default): -:: +.. code-block:: sql - mysql> use $bugs_db - mysql> ALTER TABLE attachments - AVG_ROW_LENGTH=1000000, MAX_ROWS=20000; + USE $bugs_db; + + ALTER TABLE attachments AVG_ROW_LENGTH=1000000, MAX_ROWS=20000; The above command will change the limit to 20GB. Mysql will have to make a temporary copy of your entire table to do this. Ideally, @@ -607,13 +609,13 @@ login as the root user, and then :: - bash# su - postgres + # su - postgres As the postgres user, you then need to create a new user: :: - bash$ createuser -U postgres -dRSP bugs + $ createuser -U postgres -dRSP bugs When asked for a password, provide the password which will be set as $db_pass in :file:`localconfig`. @@ -652,7 +654,7 @@ Create a New Tablespace You can use the existing tablespace or create a new one for Bugzilla. To create a new tablespace, run the following command: -:: +.. code-block:: sql CREATE TABLESPACE bugs DATAFILE '*$path_to_datafile*' SIZE 500M @@ -674,7 +676,7 @@ and ``$db_pass``, respectively). Here, we assume that the user name is 'bugs' and the tablespace name is the same as above. -:: +.. code-block:: sql CREATE USER bugs IDENTIFIED BY "$db_pass" @@ -694,7 +696,7 @@ Configure the Web Server If you use Apache, append these lines to :file:`httpd.conf` to set ORACLE_HOME and LD_LIBRARY_PATH. For instance: -:: +.. code-block:: apache SetEnv ORACLE_HOME /u01/app/oracle/product/10.2.0/ SetEnv LD_LIBRARY_PATH /u01/app/oracle/product/10.2.0/lib/ @@ -781,7 +783,8 @@ mod_cgi, do the following: exist, you'll want to add one.) In this example, Bugzilla has been installed at :file:`/var/www/html/bugzilla`. - :: +.. code-block:: apache + AddHandler cgi-script .cgi Options +ExecCGI @@ -789,26 +792,26 @@ mod_cgi, do the following: AllowOverride Limit FileInfo Indexes Options - These instructions: allow apache to run .cgi files found - within the bugzilla directory; instructs the server to look - for a file called :file:`index.cgi` or, if not - found, :file:`index.html` if someone - only types the directory name into the browser; and allows - Bugzilla's :file:`.htaccess` files to override - some global permissions. - - .. note:: It is possible to make these changes globally, or to the - directive controlling Bugzilla's parent directory (e.g. - ````). - Such changes would also apply to the Bugzilla directory... - but they would also apply to many other places where they - may or may not be appropriate. In most cases, including - this one, it is better to be as restrictive as possible - when granting extra access. - - .. note:: On Windows, you may have to also add the - ``ScriptInterpreterSource Registry-Strict`` - line, see :ref:`Windows specific notes `. +These instructions: allow apache to run .cgi files found +within the bugzilla directory; instructs the server to look +for a file called :file:`index.cgi` or, if not +found, :file:`index.html` if someone +only types the directory name into the browser; and allows +Bugzilla's :file:`.htaccess` files to override +some global permissions. + +.. note:: It is possible to make these changes globally, or to the + directive controlling Bugzilla's parent directory (e.g. + ````). + Such changes would also apply to the Bugzilla directory... + but they would also apply to many other places where they + may or may not be appropriate. In most cases, including + this one, it is better to be as restrictive as possible + when granting extra access. + +.. note:: On Windows, you may have to also add the + ``ScriptInterpreterSource Registry-Strict`` + line, see :ref:`Windows specific notes `. #. :file:`checksetup.pl` can set tighter permissions on Bugzilla's files and directories if it knows what group the @@ -824,12 +827,13 @@ mod_cgi, do the following: ```` directive (the same one as in the step above): - :: +.. code-block:: apache + +FollowSymLinks - Without this directive, Apache will not follow symbolic links - to places outside its own directory structure, and you will be - unable to run Bugzilla. +Without this directive, Apache will not follow symbolic links +to places outside its own directory structure, and you will be +unable to run Bugzilla. .. _http-apache-mod_perl: @@ -853,7 +857,8 @@ and mod_perl .. warning:: You should also ensure that you have disabled ``KeepAlive`` support in your Apache install when utilizing Bugzilla under mod_perl - :: +.. code-block:: apache + PerlSwitches -w -T PerlConfigRequire /var/www/html/bugzilla/mod_perl.pl @@ -1001,14 +1006,14 @@ graphs. :: - bash# crontab -e + # crontab -e This should bring up the crontab file in your editor. Add a cron entry like this to run :file:`collectstats.pl` daily at 5 after midnight: -:: +.. code-block:: none 5 0 * * * cd && ./collectstats.pl @@ -1034,7 +1039,7 @@ This can be done by adding the following command as a daily crontab entry, in the same manner as explained above for bug graphs. This example runs it at 12.55am. -:: +.. code-block:: none 55 0 * * * cd && ./whineatnews.pl @@ -1059,7 +1064,7 @@ This can be done by adding the following command as a daily crontab entry, in the same manner as explained above for bug graphs. This example runs it every 15 minutes. -:: +.. code-block:: none */15 * * * * cd && ./whine.pl @@ -1092,7 +1097,7 @@ add the following lines to your Apache configuration, either in the Bugzilla, or in the ```` section for your Bugzilla: -:: +.. code-block:: apache AddType application/vnd.mozilla.xul+xml .xul AddType application/rdf+xml .rdf @@ -1127,7 +1132,8 @@ Now you have to configure the web server to pass this environment variable when accessed via an alternate URL, such as virtual host for instance. The following is an example of how you could do it in Apache, other Webservers may differ. -:: + +.. code-block:: apache ServerName foo.bar.baz @@ -1434,13 +1440,13 @@ in place, you must initialize the databases (ONCE). :: - bash$ mysql_install_db + $ mysql_install_db Then start the daemon with :: - bash$ safe_mysql & + $ safe_mysql & After you start mysqld the first time, you then connect to it as "root" and :command:`GRANT` permissions to other @@ -1467,11 +1473,11 @@ installed with your own personal version of Perl: :: - bash$ wget http://perl.org/CPAN/src/stable.tar.gz - bash$ tar zvxf stable.tar.gz - bash$ cd perl-|min-perl-ver| - bash$ sh Configure -de -Dprefix=/home/foo/perl - bash$ make && make test && make install + $ wget http://perl.org/CPAN/src/stable.tar.gz + $ tar zvxf stable.tar.gz + $ cd perl-|min-perl-ver| + $ sh Configure -de -Dprefix=/home/foo/perl + $ make && make test && make install Once you have Perl installed into a directory (probably in :file:`~/perl/bin`), you will need to @@ -1698,10 +1704,10 @@ using Bzr. :: - bash$ cd /var/www/html/bugzilla - bash$ bzr switch 4.2 + $ cd /var/www/html/bugzilla + $ bzr switch 4.2 (only run the previous command when not yet running 4.2) - bash$ bzr up -r tag:bugzilla-4.2.1 + $ bzr up -r tag:bugzilla-4.2.1 +N extensions/MoreBugUrl/ +N extensions/MoreBugUrl/Config.pm +N extensions/MoreBugUrl/Extension.pm @@ -1736,19 +1742,19 @@ omit the first three lines of the example. :: - bash$ cd /var/www/html - bash$ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.gz + $ cd /var/www/html + $ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.gz ... - bash$ tar xzvf bugzilla-4.2.1.tar.gz + $ tar xzvf bugzilla-4.2.1.tar.gz bugzilla-4.2.1/ bugzilla-4.2.1/colchange.cgi ... - bash$ cd bugzilla-4.2.1 - bash$ cp ../bugzilla/localconfig* . - bash$ cp -r ../bugzilla/data . - bash$ cd .. - bash$ mv bugzilla bugzilla.old - bash$ mv bugzilla-4.2.1 bugzilla + $ cd bugzilla-4.2.1 + $ cp ../bugzilla/localconfig* . + $ cp -r ../bugzilla/data . + $ cd .. + $ mv bugzilla bugzilla.old + $ mv bugzilla-4.2.1 bugzilla .. warning:: The :command:`cp` commands both end with periods which is a very important detail--it means that the destination @@ -1783,11 +1789,11 @@ first two commands. :: - bash$ cd /var/www/html/bugzilla - bash$ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.1.diff.gz + $ cd /var/www/html/bugzilla + $ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.1.diff.gz ... - bash$ gunzip bugzilla-4.2-to-4.2.1.diff.gz - bash$ patch -p1 < bugzilla-4.2-to-4.2.1.diff + $ gunzip bugzilla-4.2-to-4.2.1.diff.gz + $ patch -p1 < bugzilla-4.2-to-4.2.1.diff patching file Bugzilla/Constants.pm patching file enter_bug.cgi ... @@ -1824,8 +1830,9 @@ steps to complete your upgrade. and settings for the new version: :: - bash$ :command:`cd /var/www/html/bugzilla` - bash$ :command:`./checksetup.pl` + + $ :command:`cd /var/www/html/bugzilla` + $ :command:`./checksetup.pl` .. warning:: The period at the beginning of the command :command:`./checksetup.pl` is important and cannot diff --git a/docs/en/rst/modules.rst b/docs/en/rst/modules.rst index 2dced86bc..1d6f21d69 100644 --- a/docs/en/rst/modules.rst +++ b/docs/en/rst/modules.rst @@ -1,4 +1,4 @@ - +.. highlight:: console .. _install-perlmodules-manual: @@ -17,12 +17,12 @@ apply this magic incantation, as root: :: - bash# tar -xzvf .tar.gz - bash# cd - bash# perl Makefile.PL - bash# make - bash# make test - bash# make install + # tar -xzvf .tar.gz + # cd + # perl Makefile.PL + # make + # make test + # make install .. note:: In order to compile source code under Windows you will need to obtain a 'make' utility. The :command:`nmake` utility provided with diff --git a/docs/en/rst/troubleshooting.rst b/docs/en/rst/troubleshooting.rst index 26899bc57..64b9263a4 100644 --- a/docs/en/rst/troubleshooting.rst +++ b/docs/en/rst/troubleshooting.rst @@ -1,4 +1,4 @@ - +.. highlight:: console .. _troubleshooting: @@ -55,7 +55,7 @@ Bugzilla. :: - bash$ ./testserver.pl http://landfill.bugzilla.org/bugzilla-tip + $ ./testserver.pl http://landfill.bugzilla.org/bugzilla-tip TEST-OK Webserver is running under group id in $webservergroup. TEST-OK Got ant picture. TEST-OK Webserver is executing CGIs. @@ -97,23 +97,27 @@ To fix this, go to :file:`/lib/DBD/sponge.pm` in your Perl installation and replace -:: +.. code-block:: perl my $numFields; if ($attribs->{'NUM_OF_FIELDS'}) { - $numFields = $attribs->{'NUM_OF_FIELDS'}; - } elsif ($attribs->{'NAME'}) { - $numFields = @{$attribs->{NAME}}; + $numFields = $attribs->{'NUM_OF_FIELDS'}; + } + elsif ($attribs->{'NAME'}) { + $numFields = @{$attribs->{NAME}}; + } with -:: +.. code-block:: perl my $numFields; if ($attribs->{'NUM_OF_FIELDS'}) { - $numFields = $attribs->{'NUM_OF_FIELDS'}; - } elsif ($attribs->{'NAMES'}) { - $numFields = @{$attribs->{NAMES}}; + $numFields = $attribs->{'NUM_OF_FIELDS'}; + } + elsif ($attribs->{'NAMES'}) { + $numFields = @{$attribs->{NAMES}}; + } (note the S added to NAME.) -- cgit v1.2.3-24-g4f1b