Item13504: Update SystemRequirememts

Build more example installation commands,  tested on gentoo.

Add Email::MIME that will be required in Foswiki 2.1 once feature
branch is merged.

core/data/System/SystemRequirements.txt

@@ -1,4 +1,4 @@
-%META:TOPICINFO{author="ProjectContributor" date="1448412998" format="1.1" version="1"}%
+%META:TOPICINFO{author="ProjectContributor" date="1448505355" format="1.1" version="1"}%
 %META:TOPICPARENT{name="AdminDocumentationCategory"}%
 ---+ System Requirements
 
@@ -52,6 +52,7 @@ Install apache and rcs: ==apt-get install apache2 rcs==
 | CGI::Session | =libcgi-session-perl= | |
 | Crypt::PasswdMD5 | =libcrypt-passwdmd5-perl= | |
 | Digest::SHA | =libdigest-sha-perl= | *First shipped in perl 5.9.3 |
+| Email::MIME | =libemail-mime-perl=  | |
 | Encode | =libencode-perl= | |
 | Error | =liberror-perl= | |
 | File::Copy::Recursive | =libfile-copy-recursive-perl= | |
@@ -112,6 +113,7 @@ Install apache2, rcs, and perl-CPAN
 | CGI::Session | =perl-CGI-Session= | |
 | Crypt::PasswdMD5 | =perl-Crypt-PasswdMD5= | |
 | Digest::SHA | =perl-Digest-SHA= | *First shipped in perl 5.9.3 |
+| Email::MIME | =perl-Email-MIME=  | |
 | Encode | =perl-Encode=  | |
 | Error | =perl-Error= | |
 | File::Copy::Recursive | =perl-File-Copy-Recursive= | |
@@ -128,14 +130,14 @@ Install apache2, rcs, and perl-CPAN
 | URI | =perl-URI= | |
 | version | =perl-Perl-Version= | Must be version 0.77 or newer, included with perl 5.10.1 and newer. |
 
----+++++ To install the above packages on CentOS
+---+++++!! To install the above packages on CentOS
 First add the appropriate perl module repository, and then install the packages.
 <blockquote>
 =yum install -y epel-release= %BR%
 =yum install= %CALC{"$LISTJOIN($sp,$LIST(R2:C2..R100:C2))"}%
 </blockquote>
 
----+++++ To install the above packages on SuSE
+---+++++!! To install the above packages on SuSE
 First add the appropriate SuSE perl-modules repository, and then install the packages. Note: Not all listed packages will install on SuSE, but all dependences are resolved.
 <blockquote>
 =zypper ar -f -n perl-modules !http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_13.1 perl-modules= %BR%
@@ -174,25 +176,30 @@ Install =www-servers/apache=, =dev-vcs/rcs=, and =dev-lang/perl=
 | Apache2::Request | =www-apache/libapreq2= | Required if using Apache 2 and mod_perl |
 | Archive::Tar | =perl-Archive-Tar= | *First shipped in perl 5.9.3 |
 | Authen::SASL | =dev-perl/Authen-SASL= | Optional, needed for authenticated SMTP |
-| CGI | =perl-core/CGI= | |
+| CGI | =dev-perl/CGI= | |
 | CGI::Session | =dev-perl/CGI-Session= | |
 | Crypt::PasswdMD5 | =dev-perl/Crypt-PasswdMD5= | |
-| Digest::SHA | =perl-core/Digest-SHA= | Included with perl |
+| Digest::SHA | | Included with perl |
+| Email::MIME | =dev-perl/Email-MIME= | |
 | Error | =dev-perl/Error= | |
-| Encode | =perl-core/Encode= | |
+| Encode | | Included with perl |
 | File::Copy::Recursive | =dev-perl/File-Copy-Recursive= | |
 | HTML::Parser | =dev-perl/HTML-Parser= | |
 | HTML::Tree | =dev-perl/HTML-Tree= | |
-| IO::Socket::IP | =dev-perl/IO-Socket-IP= | |
+| IO::Socket::IP | | Ebuild not avaiable. Install with g-cpan if IPv6 is needed. |
 | IO::Socket::SSL | =dev-perl/IO-Socket-SSL= | Optional, support encrypted email connection: STARTTLS or SSL |
 | JSON | =dev-perl/JSON= | |
-| Locale::Maketext | =dev-perl/locale-maketext= |  |
-| Locale::Maketext::Lexicon | =dev-perl/locale-maketext-lexicon= | Optional, needed for internationalization |
+| Locale::Maketext | | Included with perl |
+| Locale::Maketext::Lexicon | =dev-perl/Locale-Maketext-Lexicon= | Optional, needed for internationalization |
 | Locale::Msgfmt | =dev-perl/Locale-Msgfmt= | Optional, needed for internationalization |
 | LWP | =dev-perl/libwww-perl= | |
-| version | =perl-core/version= | Must be version 0.77 or newer, included with perl 5.10.1 and newer. |
+| version | | Must be version 0.77 or newer, included with perl 5.10.1 and newer. |
 | URI | =dev-perl/URI= | |
-* Packages in =perl-core/= generally are installed with perl. May be directly installed if updated versions are available.
+---+++++!! To install the above packages on Gentoo
+
+<blockquote>
+=emerge= %CALC{"$LISTJOIN($sp,$LIST(R2:C2..R100:C2))"}%
+</blockquote>
 
 ---++++!! Optional dependencies
 
@@ -229,6 +236,7 @@ If run as root, the modules will be installed in the System perl.   Otherwise th
 | Crypt::PasswdMD5 | |
 | Digest::SHA | Included with perl |
 | Error | |
+| Email::MIME | |
 | Encode | |
 | File::Copy::Recursive | |
 | HTML::Parser | |
@@ -243,6 +251,14 @@ If run as root, the modules will be installed in the System perl.   Otherwise th
 | version | Must be version 0.77 or newer, included with perl 5.10.1 and newer. |
 | URI | |
 
+---+++++!! To install the above packages with =cpanm=
+*Note:* We do not recommend installing CPAN modules with cpanminus as root.
+See below for information on using a private module library with cpanminus.
+<blockquote>
+curl -L !http://cpanmin.us | perl - App::cpanminus    (optional - install cpanminus if not available ) %BR%
+cpanm  %CALC{"$LISTJOIN($sp,$LIST(R2:C1..R100:C1))"}% 
+</blockquote>
+
 ---++++!! Optional dependencies
 
 Install as needed.
@@ -258,10 +274,6 @@ Install as needed.
 ---++++!! Installation using =cpanminus=
 
 See Foswiki:Support.HowToInstallCpanModules for more information.
-<verbatim>
-curl -L http://cpanmin.us | perl - App::cpanminus    (optional - install cpanminus if not available )
-cpanm Algorithm::Diff Archive::Tar Authen::SASL CGI CGI::Session Crypt::PasswdMD5 DBI DBD::mysql DBD::Pg DBD::SQLite Digest::SHA Error Encode File::Copy::Recursive HTML::Parser HTML::Tree IO::Socket::IP IO::Socket::SSL JSON Locale::Maketext  Locale::Maketext::Lexicon Locale::Msgfmt LWP version URI
-</verbatim>
 
 If you want to install the dependendencies into a specified location, add the ="-l"= option to cpanm, and add the lib path to =bin/LocalLib.cfg=.   The dependencies will be installed under the specified location, in the =lib/perl5= subdirectory.
 Example:  User "foswiki" logs in and installs the libraries locally under the foswikideps directory: