Bug 962571 - Fix syntax highlighting of code blocks. r=LpSolit, a=justdave.

git-svn-id: svn://10.0.0.236/trunk@265206 18797224-902f-48f8-a5cc-f745e15eee43

mozilla/webtools/bugzilla/.bzrrev

@@ -1 +1 @@
-8889
+8890

mozilla/webtools/bugzilla/docs/en/rst/customization.rst

@@ -1,4 +1,4 @@
-
+.. highlight:: perl
 
 .. _customization:
 

mozilla/webtools/bugzilla/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 `<http://www.mysql.com>`_. 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 `<http://www.postgresql.org/>`_. 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 <modulename>
+    # perl install-module.pl <modulename>
 
 .. 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
+    USE $bugs_db;
-    mysql> ALTER TABLE attachments
+    
-    AVG_ROW_LENGTH=1000000, MAX_ROWS=20000;
+    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
+
        <Directory /var/www/html/bugzilla>
        AddHandler cgi-script .cgi
        Options +ExecCGI
@@ -824,7 +827,8 @@ mod_cgi, do the following:
    ``<Directory>`` directive
    (the same one as in the step above):
 
-   ::
+.. code-block:: apache
+
        +FollowSymLinks
 
 Without this directive, Apache will not follow symbolic links
@@ -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 <your-bugzilla-directory> && ./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 <your-bugzilla-directory> && ./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 <your-bugzilla-directory> && ./whine.pl
 
@@ -1092,7 +1097,7 @@ add the following lines to your Apache configuration, either in the
 Bugzilla, or in the ``<Directory>``
 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
 
     <VirtualHost 212.85.153.228:80>
     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
+    $ wget http://perl.org/CPAN/src/stable.tar.gz
-    bash$ tar zvxf stable.tar.gz
+    $ tar zvxf stable.tar.gz
-    bash$ cd perl-|min-perl-ver|
+    $ cd perl-|min-perl-ver|
-    bash$ sh Configure -de -Dprefix=/home/foo/perl
+    $ sh Configure -de -Dprefix=/home/foo/perl
-    bash$ make && make test && make install
+    $ 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
+    $ cd /var/www/html/bugzilla
-    bash$ bzr switch 4.2
+    $ 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
+    $ cd /var/www/html
-    bash$ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2.1.tar.gz
+    $ 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
+    $ cd bugzilla-4.2.1
-    bash$ cp ../bugzilla/localconfig* .
+    $ cp ../bugzilla/localconfig* .
-    bash$ cp -r ../bugzilla/data .
+    $ cp -r ../bugzilla/data .
-    bash$ cd ..
+    $ cd ..
-    bash$ mv bugzilla bugzilla.old
+    $ mv bugzilla bugzilla.old
-    bash$ mv bugzilla-4.2.1 bugzilla
+    $ 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
+    $ cd /var/www/html/bugzilla
-    bash$ wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.2-to-4.2.1.diff.gz
+    $ 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
+    $ gunzip bugzilla-4.2-to-4.2.1.diff.gz
-    bash$ patch -p1 < bugzilla-4.2-to-4.2.1.diff
+    $ 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

mozilla/webtools/bugzilla/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 <module>.tar.gz
+    # tar -xzvf <module>.tar.gz
-    bash# cd <module>
+    # cd <module>
-    bash# perl Makefile.PL
+    # perl Makefile.PL
-    bash# make
+    # make
-    bash# make test
+    # make test
-    bash# make install
+    # 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

mozilla/webtools/bugzilla/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:`<path-to-perl>/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'}) {
+    }
+    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'}) {
+    }
+    elsif ($attribs->{'NAMES'}) {
         $numFields = @{$attribs->{NAMES}};
+    }
 
 (note the S added to NAME.)