/usr/share/perl5/Catalyst/Plugin/Cache/Store.pod is in libcatalyst-plugin-cache-perl 0.12-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | =pod
=head1 NAME
Catalyst::Plugin::Cache::Store - how to write a Cache store plugin.
=head1 SYNOPSIS
package Catalyst::Plugin::Cache::Store::Frobnicator;
sub setup_frobnicator_cache_backend {
my ( $app, $name, $config ) = @_;
....
$app->register_cache_backend( $name => $cache_object );
}
=head1 DESCRIPTION
In order to write a cache store plugin, all you need is to implement a method
following the naming convention:
setup_<<lower case store name>>_cache_backend {
}
For example C<setup_fastmmap_cache_backend> for
L<Catalyst::Plugin::Cache::Store::FastMmap>.
and call C<register_cache_backend> from within that.
The method will get the backend name and configuration as it's first and second
arguments.
All invocation of the setup methods will be automatic, based on the
configuration. However, the plugin must be loaded by the user.
Note that store plugins are only necessary if some configuration defaults that
are catalyst specific need to be provided.
For most cases simply using a cache class instead of a plugin is sufficient.
=cut
|