New installation instructions and release notes.
[koha_gimpoz] / Makefile.PL
index bb5e56a..077f36c 100644 (file)
@@ -29,25 +29,34 @@ Makefile.PL - Koha packager and installer
 
 =head1 SYNOPSIS
 
+=head2 BASIC INSTALLATION
+
        perl Makefile.PL
        make
        sudo make install
+
+=head2 PACKAGING RELEASE TARBALLS
+
        make manifest tardist
        make manifest zipdist
 
+=head2 CLEANING UP
+
+       make clean
+
 =head1 DESCRIPTION
 
 This is a packager and installer that uses
 ExtUtils::MakeMaker, which is fairly common
 on perl systems.
 As well as building tar or zip files
-and installing,
+and installing with the above commands,
 it allows us to check pre-requisites
 and generate configuration files.
 
 =head1 VARIABLES
 
-=head2 NAME, VERSION, ABSTRACT, AUTHOR
+=head2 NAME, VERSION_FROM, ABSTRACT, AUTHOR
 
 Basic metadata about this software.
 
@@ -65,21 +74,23 @@ Hash of file mappings
 
 =head2 CONFIGURE
 
-Maybe use prompt() here in future to get configuration values at installation time.
+Maybe use prompt() here in future to get configuration values 
+interactively at installation time.
 
 =head2 PL_FILES
 
 This is a hash of PL scripts to run after installation and
 the files to ask them to generate.
 Maybe use the values from CONFIGURE
-to generate initial configuration files.
+to generate initial configuration files in future.
 
 =cut
 
 WriteMakefile(
 
     NAME => 'koha',
-    VERSION => strftime('2.9.%Y%m%d%H',gmtime),
+    #VERSION => strftime('2.9.%Y%m%d%H',gmtime),
+    VERSION_FROM => 'C4/Context.pm',
     ABSTRACT => 'Award-winning integrated library system (ILS) and Web OPAC',
     AUTHOR => 'Koha Developers <koha-devel@nongnu.org>',
     NO_META => 1,
@@ -142,12 +153,22 @@ WriteMakefile(
        # File tree mapping
        PM => map_tree(),
 
+       # disable tests
+       'test' => {TESTS => 't/dummy.t'},
+
 #   CONFIGURE => sub {
 #     # Ask for options with prompt($question,$default) calls here?
 #     return { macro => { 'export TEST' => '755' } }
 #     },
 
-#   PL_FILES => { # generator => target
+   PL_FILES => { # generator => target(s)
+      'rewrite-config.PL' => [
+         '$(INST_LIBDIR)/koha/etc/koha-conf.xml',
+         '$(INST_LIBDIR)/koha/etc/koha-httpd.conf',
+         '$(INST_LIBDIR)/koha/etc/zebra-biblios.cfg',
+         '$(INST_LIBDIR)/koha/etc/zebra-authorities.cfg'
+         ]
+   }
 #     'opac/getfromintranet.PL' => ['$(INST_LIBDIR)/opac/cgi-bin/detail.pl','$(INST_LIBDIR)/opac/cgi-bin/moredetail.pl','$(INST_LIBDIR)/opac/cgi-bin/search.pl','$(INST_LIBDIR)/opac/cgi-bin/subjectsearch.pl','$(INST_LIBDIR)/opac/cgi-bin/logout.pl'],
 #     'misc/koha.conf.PL' => '$(INST_LIBDIR)/../etc/koha.conf',
 #     'misc/apache-koha.conf.PL' => '$(INST_LIBDIR)/../etc/apache-koha.conf',
@@ -167,7 +188,7 @@ WriteMakefile(
 =head2 map_tree
 
 This function lists all files and where to install each one.
-It returns a hash reference suitable for PM.
+It returns a hash reference suitable for the PM variable above.
 
 =cut
 
@@ -186,11 +207,10 @@ C4/*.pm is copied to perl's lib namespace.
 =pod
 
 CGIs are copied to koha/cgi-bin
-and other scripts to koha/examples.
+and other scripts to koha/scripts.
 
 =cut
-       # Misc scripts to koha/examples
-       foreach my $src (glob("*.pl"),glob("*/*.pl"),glob("installer/*.pm"),glob("*/*/*.pl"),glob("*/*/*/*.pl")) {
+       foreach my $src ("mainpage.pl","help.pl",glob("*/*.pl"),glob("installer/*.pm"),glob("*/*/*.pl"),glob("*/*/*/*.pl")) {
                if ($src =~ /(misc|updater|rss)\//) {
                        $result{$src} = '$(INST_LIBDIR)/koha/scripts/'.$src;
                } else {
@@ -214,6 +234,16 @@ excluding non-files, CVS files and whitespace in filenames.
                        $result{$src} = '$(INST_LIBDIR)/koha/templates/'.$src;
                }
        }
+=pod
+
+etc files are copied to koha/etc
+
+=cut
+       # Misc etc to koha/etc
+       foreach my $src (glob("etc/*")) {
+               $result{$src} = '$(INST_LIBDIR)/koha/'.$src;
+       }
+
 
        return \%result;
 }
@@ -225,5 +255,9 @@ __END__
 
 ExtUtils::MakeMaker(3)
 
+=head1 AUTHOR
+
+MJ Ray mjr at phonecoop.coop
+
 =cut