Subject: | Documention issue with Catalyst::Controller::MovableType |
The INSTALLATION section of the documentation is poorly formatted when
viewed with perldoc and contains a mistake (or perhaps the documentation
is just obsolete).
In the Catalyst/Controller/MovableType.pm file, just indent the section
that begins with
<Controller::Root>
and ends with
</Controller::Mt>
by one or more spaces. This configuration is repeated in the README
file, which would also benefit from being reformatted.
The instruction to use <capture_script_name></capture_script_name> tags
caused the app to fail to compile with the error message:
Couldn't load class (MTProof) because: Action "capture_script_name" is
not available from controller MTProof::Controller::Mt at
/home/.../local/perl-5.14.0/lib/site_perl/5.14.0/Catalyst/Controller.pm
line 207
Catalyst::Controller::get_action_methods('MTProof::Controller::Mt=HASH(0
x1cd9aa0)') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Controller.pm line 221
Catalyst::Controller::register_actions('MTProof::Controller::Mt=HASH(0x1
cd9aa0)', 'MTProof') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Dispatcher.pm line 605
Catalyst::Dispatcher::setup_actions('Catalyst::Dispatcher=HASH(0x18d3068
)', 'MTProof') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst.pm line 2438
Catalyst::setup_actions('MTProof') called at
/home/.../local/perl-5.14.0/lib/site_perl/5.14.0/Catalyst.pm line 1156
Catalyst::setup('MTProof') called at /home/.../catalyst-
tutorial/MTProof/script/../lib/MTProof.pm line 53
require MTProof.pm called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/cygwin-thread-multi-64int/Class/MOP.pm line
117
Class::MOP::__ANON__() called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Try/Tiny.pm line 71
eval {...} called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Try/Tiny.pm line 67
Try::Tiny::try('CODE(0x19e8140)',
'Try::Tiny::Catch=REF(0x18cd038)') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/cygwin-thread-multi-64int/Class/MOP.pm line
128
Class::MOP::load_first_existing_class('MTProof') called at
/home/.../local/perl-5.14.0/lib/site_perl/5.14.0/cygwin-thread-multi-
64int/Class/MOP.pm line 140
Class::MOP::load_class('MTProof') called at
/home/.../local/perl-5.14.0/lib/site_perl/5.14.0/Catalyst/ScriptRole.pm
line 83
Catalyst::ScriptRole::_run_application('Catalyst::Script::Server=HASH(0x
cb2938)') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Script/Server.pm line 174
Catalyst::Script::Server::__ANON__() called at
/home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Restarter/Forking.pm line 20
Catalyst::Restarter::Forking::_fork_and_start('Catalyst::Restarter::Fork
ing=HASH(0x13d2728)') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Restarter.pm line 141
Catalyst::Restarter::_handle_events('Catalyst::Restarter::Forking=HASH(0
x13d2728)', 'File::ChangeNotify::Event=HASH(0x1a6d988)') called at
/home/.../local/perl-5.14.0/lib/site_perl/5.14.0/Catalyst/Restarter.pm
line 105
Catalyst::Restarter::_restart_on_changes('Catalyst::Restarter::Forking=H
ASH(0x13d2728)') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Restarter.pm line 93
Catalyst::Restarter::run_and_watch('Catalyst::Restarter::Forking=HASH(0x
13d2728)') called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/Script/Server.pm line 223
Catalyst::Script::Server::run('Catalyst::Script::Server=HASH(0xcb2938)')
called at /home/.../local/perl-
5.14.0/lib/site_perl/5.14.0/Catalyst/ScriptRunner.pm line 47
Catalyst::ScriptRunner::run('Catalyst::ScriptRunner', 'MTProof',
'Server') called at script/mtproof_server.pl line 8
Changing those tags to <capture_mt_script></capture_mt_script> was
sufficient to fix the problem.
This is a great module. I only have a little experience with Catalyst
and MovableType; I'm so glad I don't have to figure out how to do this
by myself. Thank you for writing this module and publishing it on CPAN.
Marty O'Brien
mob@cpan.org