Add various plugins from Mark Ivey.

[matthijs/upstream/blosxom-plugins.git] / general / uselib

diff --git a/general/uselib b/general/uselib
new file mode 100644 (file)
index 0000000..42b536a
--- /dev/null
+++ b/general/uselib
@@ -0,0 +1,78 @@
+# Blosxom Plugin: uselib 
+# Author(s): Mark Ivey <zovirl@zovirl.com> 
+# Version: 0.0.1
+# Documentation: See the bottom of this file or type: perldoc uselib 
+
+package uselib;
+
+sub start {
+   use lib "$blosxom::plugin_dir/lib";
+   1;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Blosxom Plug-in: uselib 
+
+=head1 SYNOPSIS
+
+Get modules from $blosxom::plugin_dir/lib
+
+=head1 VERSION
+
+0.0.1
+
+=head1 AUTHOR
+
+Mark Ivey <zovirl@zovirl.com>
+
+=head1 DESCRIPTION
+
+Tells perl to look for perl modules in $blosxom::plugin_dir/lib.  This
+gives users a standard place to install modules such as MIME::Types or 
+File::Cat.  For example, Cat.pm would be installed to 
+$blosxom::plugin_dir/lib/File.
+
+Obviously, this plugin should be loaded before any plugins that need 
+modules.  I accomplished this by renaming it to 01uselib (00 is taken by 
+seeerror).
+
+=head1 SEE ALSO
+
+Blosxom Home/Docs/Licensing: http://www.raelity.org/apps/blosxom/
+
+Blosxom Plugin Docs: http://www.raelity.org/apps/blosxom/plugin.shtml
+
+=head1 BUGS
+
+Address bug reports and comments to the Blosxom mailing list 
+[http://www.yahoogroups.com/group/blosxom].
+
+=head1 LICENSE
+
+uselib Blosxom plugin
+Copyright 2003, Mark Ivey
+
+Permission is hereby granted, free of charge, to any person obtaining a 
+copy of this software and associated documentation files (the 
+"Software"), to deal in the Software without restriction, including 
+without limitation the rights to use, copy, modify, merge, publish, 
+distribute, sublicense, and/or sell copies of the Software, and to permit 
+persons to whom the Software is furnished to do so, subject to the 
+following conditions:
+
+The above copyright notice and this permission notice shall be included 
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
+NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
+USE OR OTHER DEALINGS IN THE SOFTWARE. 
+