From 1f815b55a63db41908d7fcf382705764b6b6a8bb Mon Sep 17 00:00:00 2001 From: Gervase Markham Date: Mon, 10 Feb 2014 16:54:03 +0000 Subject: Fix problem of variables not being replaced in RTD documentation by removing references to them. r=LpSolit, a=justdave. https://bugzilla.mozilla.org/show_bug.cgi?id=964849 --- docs/definitions.rst.tmpl | 1 - docs/en/rst/conf.py | 8 ++-- docs/en/rst/installation.rst | 95 ++------------------------------------------ docs/en/rst/modules.rst | 92 ++++++++++++++---------------------------- docs/makedocs.pl | 55 +------------------------ 5 files changed, 39 insertions(+), 212 deletions(-) delete mode 100644 docs/definitions.rst.tmpl (limited to 'docs') diff --git a/docs/definitions.rst.tmpl b/docs/definitions.rst.tmpl deleted file mode 100644 index fac4db994..000000000 --- a/docs/definitions.rst.tmpl +++ /dev/null @@ -1 +0,0 @@ -.. |min-perl-ver| replace:: 5.10.1 diff --git a/docs/en/rst/conf.py b/docs/en/rst/conf.py index 71f610575..e55874a67 100644 --- a/docs/en/rst/conf.py +++ b/docs/en/rst/conf.py @@ -258,10 +258,10 @@ texinfo_documents = [ # How to display URL addresses: 'footnote', 'no', or 'inline'. #texinfo_show_urls = 'footnote' -definitions = "../../definitions.rst" -if os.path.exists(definitions): - execfile(definitions) - +# Global substitutions and other markup required in every page +rst_epilog = """ +.. |min-perl-ver| replace:: 5.10.1 +""" # -- Options for PDF output -------------------------------------------------- diff --git a/docs/en/rst/installation.rst b/docs/en/rst/installation.rst index 38187613c..ef7423d2d 100644 --- a/docs/en/rst/installation.rst +++ b/docs/en/rst/installation.rst @@ -215,14 +215,12 @@ The list of required modules is reasonably long; however, you may already have several of them installed. The preferred way to install missing Perl modules is to use the package -manager provided by your operating system (e.g ``rpm`` or +manager provided by your operating system (e.g ``rpm``, ``apt-get`` or ``yum`` on Linux distros, or ``ppm`` on Windows if using ActivePerl, see :ref:`win32-perl-modules`). If some Perl modules are still missing or are too old, then we recommend using the :file:`install-module.pl` script (doesn't work -with ActivePerl on Windows). If for some reason you really need to -install the Perl modules manually, see -:ref:`install-perlmodules-manual`. For instance, on Unix, +with ActivePerl on Windows). For instance, on Unix, you invoke :file:`install-module.pl` as follows: :: @@ -248,93 +246,8 @@ you invoke :file:`install-module.pl` as follows: these packages will vary depending on the specific distribution you are using, but are often called :file:`-devel`. -Here is a complete list of modules and their minimum versions. -Some modules have special installation notes, which follow. - -Required Perl modules: - -#. CGI (|min-cgi-ver|) - -#. Date::Format (|min-date-format-ver|) - -#. DateTime (|min-datetime-ver|) - -#. DateTime::TimeZone (|min-datetime-timezone-ver|) - -#. DBI (|min-dbi-ver|) - -#. DBD::mysql (|min-dbd-mysql-ver|) if using MySQL - -#. DBD::Pg (|min-dbd-pg-ver|) if using PostgreSQL - -#. DBD::Oracle (|min-dbd-oracle-ver|) if using Oracle - -#. Digest::SHA (|min-digest-sha-ver|) - -#. Email::Send (|min-email-send-ver|) - -#. Email::MIME (|min-email-mime-ver|) - -#. Template (|min-template-ver|) - -#. URI (|min-uri-ver|) - -Optional Perl modules: - -#. GD (|min-gd-ver|) for bug charting - -#. Template::Plugin::GD::Image - (|min-template-plugin-gd-image-ver|) for Graphical Reports - -#. Chart::Lines (|min-chart-lines-ver|) for bug charting - -#. GD::Graph (|min-gd-graph-ver|) for bug charting - -#. GD::Text (|min-gd-text-ver|) for bug charting - -#. XML::Twig (|min-xml-twig-ver|) for bug import/export - -#. MIME::Parser (|min-mime-parser-ver|) for bug import/export - -#. LWP::UserAgent - (|min-lwp-useragent-ver|) for Automatic Update Notifications - -#. PatchReader (|min-patchreader-ver|) for pretty HTML view of patches - -#. Net::LDAP - (|min-net-ldap-ver|) for LDAP Authentication - -#. Authen::SASL - (|min-authen-sasl-ver|) for SASL Authentication - -#. Authen::Radius - (|min-authen-radius-ver|) for RADIUS Authentication - -#. SOAP::Lite (|min-soap-lite-ver|) for the web service interface - -#. JSON::RPC - (|min-json-rpc-ver|) for the JSON-RPC interface - -#. Test::Taint - (|min-test-taint-ver|) for the web service interface - -#. HTML::Parser - (|min-html-parser-ver|) for More HTML in Product/Group Descriptions - -#. HTML::Scrubber - (|min-html-scrubber-ver|) for More HTML in Product/Group Descriptions - -#. Email::Reply - (|min-email-reply-ver|) for Inbound Email - -#. TheSchwartz - (|min-theschwartz-ver|) for Mail Queueing - -#. Daemon::Generic - (|min-daemon-generic-ver|) for Mail Queueing - -#. mod_perl2 - (|min-mod_perl2-ver|) for mod_perl +If for some reason you really need to install the Perl modules manually, see +:ref:`install-perlmodules-manual`. .. _install-MTA: diff --git a/docs/en/rst/modules.rst b/docs/en/rst/modules.rst index 1d6f21d69..474016180 100644 --- a/docs/en/rst/modules.rst +++ b/docs/en/rst/modules.rst @@ -47,73 +47,53 @@ Download Locations CGI: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ Data-Dumper: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ Date::Format (part of TimeDate): -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ DBI: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ DBD::mysql: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ DBD::Pg: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ Template-Toolkit: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ GD: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ Template::Plugin::GD: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ MIME::Parser (part of MIME-tools): -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ .. _modules-manual-optional: @@ -122,37 +102,25 @@ Optional Modules Chart::Lines: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ GD::Graph: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ GD::Text::Align (part of GD::Text::Util): -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ XML::Twig: -:: - - CPAN Download Page: ``_ - Documentation: ``_ +* CPAN Download Page: ``_ +* Documentation: ``_ PatchReader: -:: - - CPAN Download Page: ``_ - Documentation: ``_ - - +* CPAN Download Page: ``_ +* Documentation: ``_ diff --git a/docs/makedocs.pl b/docs/makedocs.pl index 2fc6721eb..d29a3fb91 100755 --- a/docs/makedocs.pl +++ b/docs/makedocs.pl @@ -46,64 +46,11 @@ if (eval { require Pod::Simple }) { $pod_simple = 1; }; -use Bugzilla::Install::Requirements - qw(REQUIRED_MODULES OPTIONAL_MODULES); -use Bugzilla::Constants qw(DB_MODULE BUGZILLA_VERSION); +use Bugzilla::Constants qw(BUGZILLA_VERSION); use File::Path qw(rmtree); use File::Which qw(which); -############################################################################### -# Generate minimum version list -############################################################################### - -my $modules = REQUIRED_MODULES; -my $opt_modules = OPTIONAL_MODULES; - -my $template; -{ - open(TEMPLATE, '<', 'definitions.rst.tmpl') - or die('Could not open definitions.rst.tmpl: ' . $!); - local $/; - $template =