Bug 182975: Bugzilla directory structure to be adopted to l10n needs - Patch by A.A. Shimono (himorin) <shimono@mozilla.gr.jp> r=LpSolit r=mkanat a=LpSolit

1 files changed, 193 insertions, 0 deletions

diff --git a/docs/en/xml/modules.xml b/docs/en/xml/modules.xml
new file mode 100644
index 000000000..3d4f6e556
--- /dev/null
+++ b/docs/en/xml/modules.xml
@@ -0,0 +1,193 @@
+<!-- <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> -->
+<appendix id="install-perlmodules-manual">
+  <title>Manual Installation of Perl Modules</title>
+  
+  <section id="modules-manual-instructions">
+    <title>Instructions</title>
+    <para>
+      If you need to install Perl modules manually, here's how it's done.
+      Download the module using the link given in the next section, and then
+      apply this magic incantation, as root:
+    </para>
+
+    <para>  
+      <screen><prompt>bash#</prompt> tar -xzvf &lt;module&gt;.tar.gz
+<prompt>bash#</prompt> cd &lt;module&gt;
+<prompt>bash#</prompt> perl Makefile.PL
+<prompt>bash#</prompt> make
+<prompt>bash#</prompt> make test
+<prompt>bash#</prompt> make install</screen>
+    </para>
+    <note>
+      <para>
+        In order to compile source code under Windows you will need to obtain
+        a 'make' utility.  The <command>nmake</command> utility provided with
+        Microsoft Visual C++ may be used.  As an alternative, there is a
+        utility called <command>dmake</command> available from CPAN which is
+        written entirely in Perl.
+      </para>
+      <para>
+        As described in <xref linkend="modules-manual-download" />, however, most
+        packages already exist and are available from ActiveState or theory58S.
+        We highly recommend that you install them using the ppm GUI available with
+        ActiveState and to add the theory58S repository to your list of repositories.
+      </para>
+    </note>
+  </section>
+    
+  <section id="modules-manual-download">
+    <title>Download Locations</title>
+    
+    <note>
+      <para>
+        Running Bugzilla on Windows requires the use of ActiveState
+        Perl 5.8.1 or higher. Many modules already exist in the core
+        distribution of ActiveState Perl. Additional modules can be downloaded
+        from <ulink url="http://theoryx5.uwinnipeg.ca/ppms/" /> if you use
+        Perl 5.8.x or from <ulink url="http://cpan.uwinnipeg.ca/PPMPackages/10xx/" />
+        if you use Perl 5.10.x.
+      </para>
+    </note>
+
+    <para>
+      CGI:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/CGI.pm/"/>
+        Documentation: <ulink url="http://perldoc.perl.org/CGI.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      Data-Dumper:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Data-Dumper/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/Data-Dumper/Dumper.pm"/>
+      </literallayout>
+    </para>
+    
+    <para>
+      Date::Format (part of TimeDate):
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/TimeDate/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/TimeDate/lib/Date/Format.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      DBI:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/DBI/"/>
+        Documentation: <ulink url="http://dbi.perl.org/docs/"/>
+      </literallayout>
+    </para>
+
+    <para>
+      DBD::mysql:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/DBD-mysql/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/DBD-mysql/lib/DBD/mysql.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      DBD::Pg:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/DBD-Pg/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/DBD-Pg/Pg.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      File::Spec:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/File-Spec/"/>
+        Documentation: <ulink url="http://perldoc.perl.org/File/Spec.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      Template-Toolkit:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-Toolkit/"/>
+        Documentation: <ulink url="http://www.template-toolkit.org/docs.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      GD:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/GD/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/GD/GD.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      Template::Plugin::GD:
+      <literallayout>
+       CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-GD/" />
+       Documentation: <ulink url="http://www.template-toolkit.org/docs/aqua/Modules/index.html" />
+      </literallayout>
+    </para>
+
+    <para>
+      MIME::Parser (part of MIME-tools):
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/MIME-tools/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/MIME-tools/lib/MIME/Parser.pm"/>
+      </literallayout>
+    </para>
+
+  </section>
+
+  <section id="modules-manual-optional">
+    <title>Optional Modules</title>
+
+    <para>
+      Chart::Base:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Chart/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/Chart/Chart.pod"/>
+      </literallayout>
+    </para>
+
+     <para>
+      GD::Graph:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/GDGraph/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/GDGraph/Graph.pm"/>
+      </literallayout>
+    </para>
+
+    <para>
+      GD::Text::Align (part of GD::Text::Util):
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/GDTextUtil/"/>
+        Documentation: <ulink url="http://search.cpan.org/dist/GDTextUtil/Text/Align.pm"/>
+      </literallayout>
+    </para>
+
+   <para>
+      XML::Twig:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/XML-Twig/"/>
+        Documentation: <ulink url="http://standards.ieee.org/resources/spasystem/twig/twig_stable.html"/>
+      </literallayout>
+    </para>
+
+    <para>
+      PatchReader:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/author/JKEISER/PatchReader/"/>
+        Documentation: <ulink url="http://www.johnkeiser.com/mozilla/Patch_Viewer.html"/>
+      </literallayout>
+    </para>
+
+   <para>
+      Image::Magick:
+      <literallayout>
+        CPAN Download Page: <ulink url="http://search.cpan.org/dist/PerlMagick/"/>
+        Documentation: <ulink url="http://www.imagemagick.org/script/resources.php"/>
+      </literallayout>
+    </para>
+   </section>
+</appendix>