module::install::base(3pm) [debian man page]

Module::Install::Base(3pm)				User Contributed Perl Documentation				Module::Install::Base(3pm)

NAME

       Module::Install::Base - Base class for Module::Install extensions

SYNOPSIS

       In a Module::Install extension:

	   use Module::Install::Base ();
	   @ISA = qw(Module::Install::Base);

DESCRIPTION

       This module provide essential methods for all Module::Install extensions, in particular the common constructor "new" and method dispatcher
       "AUTOLOAD".

METHODS

       new(%args)
	   Constructor -- need to preserve at least _top

       AUTOLOAD
	   The main dispatcher - copy extensions if missing

       _top()
	   Returns the top-level Module::Install object.

       admin()
	   Returns the "_top" object's associated Module::Install::Admin object on the first run (i.e. when there was no inc/ when the program
	   started); on subsequent (user-side) runs, returns a fake admin object with an empty "AUTOLOAD" method that does nothing at all.

       is_admin()
	   Tells whether this is the first run of the installer (on author's side). That is when there was no inc/ at program start. True if
	   that's the case. False, otherwise.

SEE ALSO

       Module::Install

AUTHORS

       Audrey Tang <autrijus@autrijus.org>

COPYRIGHT

       Copyright 2003, 2004 by Audrey Tang <autrijus@autrijus.org>.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.14.2							    2012-03-01						Module::Install::Base(3pm)

Module::Install::Share(3pm)				User Contributed Perl Documentation			       Module::Install::Share(3pm)

NAME

       Module::Install::Share - Install non-code files for use during run-time

SYNOPSIS

	   # Put everything inside ./share/ into the distribution 'auto' path
	   install_share 'share';

	   # Same thing as above using the default directory name
	   install_share;

DESCRIPTION

       As well as Perl modules and Perl binary applications, some distributions need to install read-only data files to a location on the file
       system for use at run-time.

       XML Schemas, YAML data files, and SQLite databases are examples of the sort of things distributions might typically need to have available
       after installation.

       "Module::Install::Share" is a Module::Install extension that provides commands to allow these files to be installed to the applicable
       location on disk.

       To locate the files after installation so they can be used inside your module, see this extension's companion module File::ShareDir.

TO DO

       Currently "install_share" installs not only the files you want, but if called by the author will also copy .svn and other source-control
       directories, and other junk.

       Enhance this to copy only files under share that are in the MANIFEST, or possibly those not in MANIFEST.SKIP.

AUTHORS

       Audrey Tang <autrijus@autrijus.org>

       Adam Kennedy <adamk@cpan.org>

SEE ALSO

       Module::Install, File::ShareDir

COPYRIGHT

       Copyright 2006 Audrey Tang, Adam Kennedy.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.14.2							    2012-03-01					       Module::Install::Share(3pm)