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

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

NAME

       Module::Install::DOAPChangeSets - write your distribution change log in RDF

DESCRIPTION

       This package allows you to write your Changes file in Turtle or RDF/XML and autogenerate a human-readable text file.

       To do this, create an RDF file called "meta/changes.ttl" (or something like that) and describe your distribution's changes in RDF using the
       Dublin Core, DOAP, and DOAP Change Sets vocabularies. Then in your Makefile.PL, include:

	 write_doap_changes "meta/changes.ttl", "Changes", "turtle";

       This line will read your data from the file named as the first argument, parse it using either Turtle or RDFXML parsers (the third
       argument), and output a human-readable changelog to the file named as the second argument.

       The defaults are "meta/changes.ttl", "Changes", "turtle", so if you name the files like that, then you can exclude all the arguments and
       just include this in your Makefile.PL:

	 write_doap_changes;

       There's also a line you can use to output a Changes.xml file:

	 write_doap_changes_xml "meta/changes.ttl", "Changes.xml", "turtle";

   Integration with Module::Install::RDF
       Module::Install::RDF reads all the RDF it can find in 'meta'. If you invoke Module::Install::RDF before invoking
       Module::Install::DOAPChangeSets, then this module will use Module::Install::RDF's copy of the data.

WHY
?
       Why not?

BUGS

       Please report any bugs to <http://rt.cpan.org/>.

SEE ALSO

       Module::Install, Module::Install::DOAPChangeSets::Format , Module::Install::RDF.

       <http://www.perlrdf.org/>.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENSE

       Copyright (C) 2010-2011 by Toby Inkster

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

perl v5.14.2							    2012-01-18				      Module::Install::DOAPChangeSets(3pm)

Module::Install::Admin(3)				User Contributed Perl Documentation				 Module::Install::Admin(3)

NAME

       Module::Install::Admin - Author-side manager for Module::Install

SYNOPSIS

       In a Module::Install extension module:

	   sub extension_method {
	       my $self = shift;
	       $self->admin->some_method(@args);
	   }

       As an one-liner:

	   % perl "-MModule::Install::Admin" -e'&some_method(@args);'

       The two snippets above are really shorthands for

	   $some_obj->some_method(@args)

       where $some_obj is the singleton object of a class under the "Module::Install::Admin::*" namespace that provides the method "some_method".
       See "METHODS" for a list of built-in methods.

DESCRIPTION

       This module implements the internal mechanism for initializing, including and managing extensions, and should only be of interest to
       extension developers; it is never included under a distribution's inc/ directory, nor are any of the Module::Install::Admin::* extensions.

       For normal usage of Module::Install, please see Module::Install and "COOKBOOK / EXAMPLES" in Module::Install instead.

   Bootstrapping
       When someone runs a Makefile.PL that has "use inc::Module::Install", and there is no inc/ in the current directory, Module::Install will
       load this module bootstrap itself, through the steps below:

       o   First, Module/Install.pm is POD-stripped and copied from @INC to inc/.  This should only happen on the author's side, never on the end-
	   user side.

       o   Reload inc/Module/Install.pm if the current file is somewhere else.	This ensures that the included version of inc/Module/Install.pm is
	   always preferred over the installed version.

       o   Look at inc/Module/Install/*.pm and load all of them.

       o   Set up a "main::AUTOLOAD" function to delegate missing function calls to "Module::Install::Admin::load" -- again, this should only
	   happen at the author's side.

       o   Provide a "Module::Install::purge_self" function for removing included files under inc/.

METHODS

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.16.3							    2012-03-01						 Module::Install::Admin(3)