Item13515: Release CpanContrib for Foswiki 2.0

foswiki · Jul 8, 2015 · 81f91d3 · 81f91d3
1 parent 69b34ac
commit 81f91d3
Show file tree

Hide file tree

Showing 288 changed files with 52,682 additions and 56,935 deletions.
diff --git a/CpanContrib/data/System/CpanContrib.txt b/CpanContrib/data/System/CpanContrib.txt
@@ -1,4 +1,4 @@
-%META:TOPICINFO{author="ProjectContributor" date="1401892615" format="1.1" version="1"}%
+%META:TOPICINFO{author="ProjectContributor" date="1436389919" format="1.1" version="1"}%
 %META:TOPICPARENT{name="Contribs"}%
 <!--
 One line description, required for extensions repository catalog.
@@ -21,7 +21,26 @@ This contrib ships with all CPAN modules that are required for a fully functiona
 These modules are not provided because they are not available in a "pure perl" implemenation and must be compiled for the target system.  In addition, CPAN:Net::SSLeay has dependencies on the non-perl package !OpenSSL.
 
 ---++ Installation
-%$INSTALL_INSTRUCTIONS%
+
+This extension will typically require a special installation procedure.  Because this extension provides critical perl dependencies, the Foswiki
+extension installer will typically not be functional.
+
+To install this extension, download the zip or tgz file from the [[http://foswiki.org/Extensions/CpanContrib][Foswiki Extensions repository]], and unzip / untar the downloaded file into the foswiki
+installation. If Foswiki encounters errors because these modules are incompatible with the installed perl, you may need to follow the steps in =bin/LocalLib.cfg.txt= to add these libs to the front of the search path,
+overriding the system provided modules.
+
+---++ Updating this extension with current CPAN modules
+
+This extension was built using the =cpanm= tool provided by =App::cpanminus=
+
+cd into the CpanContrib directory and then build the dependencies:
+<verbatim>
+cpanm --pp -L . --self-contained --exclude-vendor Algorithm::Diff Archive::Tar Archive::Zip CGI CGI::Session Crypt::PasswdMD5 Digest::SHA Error File::Copy::Recursive
+cpanm --pp -L . --self-contained --exclude-vendor HTML::Parser HTML::Tree IO::Socket::IP Locale::Maketext::Lexicon Locale::Msgfmt LWP Socket version URI
+</verbatim>
+
+This will compile the modules into =lib/perl5=.   Move the contents of =lib/perl5= into =lib/CPAN/lib=.  If this is being built for portable use,
+remove any architecure specific directories, such as =x86_64-linux= Files such as =.pod= documentation can also be removed.
 
 ---++ Info
 
@@ -32,6 +51,7 @@ These modules are not provided because they are not available in a "pure perl" i
 |  Version: | %$VERSION% |
 |  Release: | %$RELEASE% |
 |  Change History: | <!-- versions below in reverse order -->&nbsp; |
-|  1.0.0 (14 Mar 2014): | Initial version |
+|  1.01 (08 Jul 2015): | Released for Foswiki 2.0 |
+|  1.00 (14 Mar 2014): | Initial version |
 |  Home: | http://foswiki.org/Extensions/%TOPIC% |
 |  Support: | http://foswiki.org/Support/%TOPIC% |