Add various plugins from Mark Ivey.
[matthijs/upstream/blosxom-plugins.git] / general / uselib
1 # Blosxom Plugin: uselib 
2 # Author(s): Mark Ivey <zovirl@zovirl.com> 
3 # Version: 0.0.1
4 # Documentation: See the bottom of this file or type: perldoc uselib 
5
6 package uselib;
7
8 sub start {
9    use lib "$blosxom::plugin_dir/lib";
10    1;
11 }
12
13 1;
14
15 __END__
16
17 =head1 NAME
18
19 Blosxom Plug-in: uselib 
20
21 =head1 SYNOPSIS
22
23 Get modules from $blosxom::plugin_dir/lib
24
25 =head1 VERSION
26
27 0.0.1
28
29 =head1 AUTHOR
30
31 Mark Ivey <zovirl@zovirl.com>
32
33 =head1 DESCRIPTION
34
35 Tells perl to look for perl modules in $blosxom::plugin_dir/lib.  This
36 gives users a standard place to install modules such as MIME::Types or 
37 File::Cat.  For example, Cat.pm would be installed to 
38 $blosxom::plugin_dir/lib/File.
39
40 Obviously, this plugin should be loaded before any plugins that need 
41 modules.  I accomplished this by renaming it to 01uselib (00 is taken by 
42 seeerror).
43
44 =head1 SEE ALSO
45
46 Blosxom Home/Docs/Licensing: http://www.raelity.org/apps/blosxom/
47
48 Blosxom Plugin Docs: http://www.raelity.org/apps/blosxom/plugin.shtml
49
50 =head1 BUGS
51
52 Address bug reports and comments to the Blosxom mailing list 
53 [http://www.yahoogroups.com/group/blosxom].
54
55 =head1 LICENSE
56
57 uselib Blosxom plugin
58 Copyright 2003, Mark Ivey
59
60 Permission is hereby granted, free of charge, to any person obtaining a 
61 copy of this software and associated documentation files (the 
62 "Software"), to deal in the Software without restriction, including 
63 without limitation the rights to use, copy, modify, merge, publish, 
64 distribute, sublicense, and/or sell copies of the Software, and to permit 
65 persons to whom the Software is furnished to do so, subject to the 
66 following conditions:
67
68 The above copyright notice and this permission notice shall be included 
69 in all copies or substantial portions of the Software.
70
71 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 
72 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
73 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
74 NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
75 DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
76 OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
77 USE OR OTHER DEALINGS IN THE SOFTWARE. 
78