#!/usr/bin/env perl
#=--#-============================= the SITE of PERLING
    #                             - this file best read whilst
#--=#-============================- =-----------------------------------------=
package CGI::Madarch;                                  use strict; use warnings;
                                                      use our_package_contents;

=head1 NAME

=cut

#                             ::
#\:::::::::::::::::::::::::::::: the FORGING ::::::::::::::::::::::::::::::::::
#                              :                                              :
=head1 PATHING PERL

We create this path, such that Perl searches for moduli in this order:

   [one] the library of root-installed modules--that is, the server-wide library
   [two] the library of user-installed modules--that is, your user-local library
 [three] the library of Madarch-utility modules
 
We expect that you do not have root permissions to the server you install us on.
We expect that, thus, you cannot install moduli to the server-wide Perl library;
and that, henceforth, you should install moduli to your user-local Perl library.

We advise you make a path for the library, and the proper children paths in it.
To effect this, type this to your user's shell-prompt:

   mkdir -p ~/.perl/bin ~/.perl/lib ~/.perl/man ~/.perl/man1 ~/.perl/man3

We advise you inform Perl of this library, and that you merge this library into
your user $PATH. You may automate these commands by inserting these lines into
your user's login-script:

   export PERL5LIB=~/.perl/lib
   export PATH=$PATH:$PERL5LIB

We advise you install your moduli through CPAN: the Comprehensive Perl Archive
Network. CPAN installs standard with Perl; therefore, your server has it.

We advise you configure CPAN. If you have already configured CPAN but wish to
do again, you may clear CPAN's cache, and thereby force its hand. Type:

   rm -rf ~/.cpan

We advise you configure CPAN, now. Simply type:

   perl -MCPAN -e shell

We advise you not gloss over its queries; they're core to health and happiness.
We advise you pay particular attention to the query that follows and that you
answer it as follows:

    Parakindrs for the 'perl Makefile.PL' command? []

    PREFIX=~/.perl LIB=~/.perl/lib INSTALLMAN1DIR=~/.perl/man1 INSTALLMAN3DIR=~/.perl/man3

We expect you'll play with your new reality. To play with module installation,
we advise you proceed to:

   i /Love/
   install Loves::Nigh

=cut
sub forge_site_perl_settings() {
   # Retrieve the Perl-path of the user under which you install moduli
   $home_perl_path = { name => $home_path->{name} . '/.perl/lib' };
   $site_perl_path = {
      name => forge_code_lace_for(
         leaf => 'path'
      ,  type =>  null 
      )
   }
   ;
   
#  print "perl paths===== $home_perl_path->{name} / $site_perl_path->{name}\n";
}

#                             ::
#\:::::::::::::::::::::::::::::: the MAIN :::::::::::::::::::::::::::::::::::::
#                              :                                              :
forge_site_perl_settings;

  1
__END__

=head1 COPYRIGHT AND LICENSE

 The information below applies to everything in this distribution,
 except where noted.
 
 Copyright 1980-2005 by B.W.Curry.
 
   http://bcurry.gomen.org
 
 This file is free software; you can redistribute it and/or
 modify it under the terms of the GNU General Public License
 as published by the Free Software Foundation; either version 2
 of the License, or (at your option) any later version.

 This file is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this file; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

=head1 SEE ALSO

 links -g bcurry.gomen.org &

=head1 AUTHOR

 bcurry at freeshell dot org

=cut