FM / man3

/usr/local/share/man/man3

Name	Size	Mode	Actions
App::Prove.3pm	10508	0444	edit dl rm
App::Prove::State.3pm	6005	0444	edit dl rm
App::Prove::State::Result.3pm	5619	0444	edit dl rm
App::Prove::State::Result::Test.3pm	5051	0444	edit dl rm
AppConfig.3pm	35289	0444	edit dl rm
AppConfig::Args.3pm	7992	0444	edit dl rm
AppConfig::CGI.3pm	6609	0444	edit dl rm
AppConfig::File.3pm	12614	0444	edit dl rm
AppConfig::Getopt.3pm	7444	0444	edit dl rm
AppConfig::State.3pm	24972	0444	edit dl rm
AppConfig::Sys.3pm	6695	0444	edit dl rm
Archive::Tar.3pm	44061	0444	edit dl rm
Archive::Tar::File.3pm	11083	0444	edit dl rm
Archive::Zip.3pm	69985	0444	edit dl rm
Archive::Zip::FAQ.3pm	18437	0444	edit dl rm
Archive::Zip::MemberRead.3pm	6734	0444	edit dl rm
Archive::Zip::Tree.3pm	2875	0444	edit dl rm
B::COW.3pm	5163	0444	edit dl rm
Canary::Stability.3pm	3727	0444	edit dl rm
CDB_File.3pm	14318	0444	edit dl rm
common::sense.3pm	0	0444	edit dl rm
Compress::Raw::Bzip2.3pm	13463	0444	edit dl rm
Compress::Raw::Zlib.3pm	42082	0444	edit dl rm
Compress::Zlib.3pm	38719	0444	edit dl rm
CPAN::Meta.3pm	15923	0444	edit dl rm
CPAN::Meta::Converter.3pm	6594	0444	edit dl rm
CPAN::Meta::Feature.3pm	4322	0444	edit dl rm
CPAN::Meta::History.3pm	7855	0444	edit dl rm
CPAN::Meta::History::Meta_1_0.3pm	9973	0444	edit dl rm
CPAN::Meta::History::Meta_1_1.3pm	12410	0444	edit dl rm
CPAN::Meta::History::Meta_1_2.3pm	22224	0444	edit dl rm
CPAN::Meta::History::Meta_1_3.3pm	23974	0444	edit dl rm
CPAN::Meta::History::Meta_1_4.3pm	24565	0444	edit dl rm
CPAN::Meta::Merge.3pm	5285	0444	edit dl rm
CPAN::Meta::Prereqs.3pm	7380	0444	edit dl rm
CPAN::Meta::Requirements.3pm	12308	0444	edit dl rm
CPAN::Meta::Spec.3pm	45592	0444	edit dl rm
CPAN::Meta::Validator.3pm	4215	0444	edit dl rm
CPAN::Meta::YAML.3pm	4230	0444	edit dl rm
Crypt::OpenSSL::Random.3pm	5634	0444	edit dl rm
Curses.3pm	37580	0444	edit dl rm
Curses::UI.3pm	15619	0444	edit dl rm
Curses::UI::Buttonbox.3pm	8908	0444	edit dl rm
Curses::UI::Calendar.3pm	8203	0444	edit dl rm
Curses::UI::Checkbox.3pm	6509	0444	edit dl rm
Curses::UI::Color.3pm	5903	0444	edit dl rm
Curses::UI::Common.3pm	6498	0444	edit dl rm
Curses::UI::Container.3pm	9041	0444	edit dl rm
Curses::UI::Dialog::Basic.3pm	5213	0444	edit dl rm
Curses::UI::Dialog::Calendar.3pm	4761	0444	edit dl rm
Curses::UI::Dialog::Dirbrowser.3pm	5369	0444	edit dl rm
Curses::UI::Dialog::Error.3pm	4307	0444	edit dl rm
Curses::UI::Dialog::Filebrowser.3pm	6889	0444	edit dl rm
Curses::UI::Dialog::Progress.3pm	5774	0444	edit dl rm
Curses::UI::Dialog::Question.3pm	5277	0444	edit dl rm
Curses::UI::Dialog::Status.3pm	4765	0444	edit dl rm
Curses::UI::Label.3pm	7333	0444	edit dl rm
Curses::UI::Listbox.3pm	11988	0444	edit dl rm
Curses::UI::Menubar.3pm	8110	0444	edit dl rm
Curses::UI::Notebook.3pm	9140	0444	edit dl rm
Curses::UI::PasswordEntry.3pm	3743	0444	edit dl rm
Curses::UI::Popupmenu.3pm	7431	0444	edit dl rm
Curses::UI::Progressbar.3pm	5891	0444	edit dl rm
Curses::UI::Radiobuttonbox.3pm	4069	0444	edit dl rm
Curses::UI::Searchable.3pm	6668	0444	edit dl rm
Curses::UI::TextEditor.3pm	14171	0444	edit dl rm
Curses::UI::TextEntry.3pm	3623	0444	edit dl rm
Curses::UI::TextViewer.3pm	3670	0444	edit dl rm
Curses::UI::Tutorial.3pm	8555	0444	edit dl rm
Curses::UI::Widget.3pm	25675	0444	edit dl rm
Curses::UI::Window.3pm	5084	0444	edit dl rm
Cwd.3pm	7183	0444	edit dl rm
Date::Format.3pm	7291	0444	edit dl rm
Date::Language.3pm	3809	0444	edit dl rm
Date::Language::Bulgarian.3pm	3675	0444	edit dl rm
Date::Language::Hungarian.3pm	3091	0444	edit dl rm
Date::Parse.3pm	5402	0444	edit dl rm
Digest::SHA.3pm	25759	0444	edit dl rm
Expect.3pm	60229	0444	edit dl rm
ExtUtils::CBuilder.3pm	11923	0444	edit dl rm
ExtUtils::CBuilder::Platform::Windows.3pm	3117	0444	edit dl rm
ExtUtils::Command.3pm	5942	0444	edit dl rm
ExtUtils::Command::MM.3pm	5723	0444	edit dl rm
ExtUtils::Liblist.3pm	12679	0444	edit dl rm
ExtUtils::MakeMaker.3pm	79357	0444	edit dl rm
ExtUtils::MakeMaker::Config.3pm	2587	0444	edit dl rm
ExtUtils::MakeMaker::FAQ.3pm	26829	0444	edit dl rm
ExtUtils::MakeMaker::Locale.3pm	11168	0444	edit dl rm
ExtUtils::MakeMaker::Tutorial.3pm	8389	0444	edit dl rm
ExtUtils::Manifest.3pm	11961	0444	edit dl rm
ExtUtils::Mkbootstrap.3pm	3459	0444	edit dl rm
ExtUtils::Mksymlists.3pm	6699	0444	edit dl rm
ExtUtils::MM.3pm	2829	0444	edit dl rm
ExtUtils::MM_AIX.3pm	3044	0444	edit dl rm
ExtUtils::MM_Any.3pm	31129	0444	edit dl rm
ExtUtils::MM_BeOS.3pm	2798	0444	edit dl rm
ExtUtils::MM_Cygwin.3pm	3569	0444	edit dl rm
ExtUtils::MM_Darwin.3pm	2688	0444	edit dl rm
ExtUtils::MM_DOS.3pm	3021	0444	edit dl rm
ExtUtils::MM_MacOS.3pm	2987	0444	edit dl rm
ExtUtils::MM_NW5.3pm	3200	0444	edit dl rm
ExtUtils::MM_OS2.3pm	2886	0444	edit dl rm
ExtUtils::MM_QNX.3pm	2942	0444	edit dl rm
ExtUtils::MM_Unix.3pm	21419	0444	edit dl rm
ExtUtils::MM_UWIN.3pm	3051	0444	edit dl rm
ExtUtils::MM_VMS.3pm	14900	0444	edit dl rm
ExtUtils::MM_VOS.3pm	2926	0444	edit dl rm
ExtUtils::MM_Win32.3pm	5919	0444	edit dl rm
ExtUtils::MM_Win95.3pm	3276	0444	edit dl rm
ExtUtils::MY.3pm	2764	0444	edit dl rm
ExtUtils::testlib.3pm	2690	0444	edit dl rm
File::GlobMapper.3pm	11447	0444	edit dl rm
File::HomeDir.3pm	18212	0444	edit dl rm
File::HomeDir::Darwin.3pm	3232	0444	edit dl rm
File::HomeDir::Darwin::Carbon.3pm	3517	0444	edit dl rm
File::HomeDir::Darwin::Cocoa.3pm	3446	0444	edit dl rm
File::HomeDir::Driver.3pm	3101	0444	edit dl rm
File::HomeDir::FreeDesktop.3pm	3487	0444	edit dl rm
File::HomeDir::MacOS9.3pm	3499	0444	edit dl rm
File::HomeDir::Test.3pm	3534	0444	edit dl rm
File::HomeDir::Unix.3pm	3638	0444	edit dl rm
File::HomeDir::Windows.3pm	4891	0444	edit dl rm
File::Path.3pm	31030	0444	edit dl rm
File::Slurp.3pm	23626	0444	edit dl rm
File::Spec.3pm	13784	0444	edit dl rm
File::Spec::AmigaOS.3pm	2826	0444	edit dl rm
File::Spec::Cygwin.3pm	3957	0444	edit dl rm
File::Spec::Epoc.3pm	3251	0444	edit dl rm
File::Spec::Functions.3pm	3799	0444	edit dl rm
File::Spec::Mac.3pm	18664	0444	edit dl rm
File::Spec::OS2.3pm	3118	0444	edit dl rm
File::Spec::Unix.3pm	9837	0444	edit dl rm
File::Spec::VMS.3pm	6389	0444	edit dl rm
File::Spec::Win32.3pm	6451	0444	edit dl rm
File::Temp.3pm	36799	0444	edit dl rm
File::Which.3pm	9746	0444	edit dl rm
Getopt::Long.3pm	52647	0444	edit dl rm
HDB.3pm	10947	0444	edit dl rm
HDB::CMDS.3pm	18894	0444	edit dl rm
HDB::Encode.3pm	7863	0444	edit dl rm
HDB::Object.3pm	10057	0444	edit dl rm
HTML::AsSubs.3pm	8586	0444	edit dl rm
HTML::Element.3pm	70793	0444	edit dl rm
HTML::Element::traverse.3pm	15984	0444	edit dl rm
HTML::Form.3pm	28158	0444	edit dl rm
HTML::Parse.3pm	8277	0444	edit dl rm
HTML::Tree.3pm	9982	0444	edit dl rm
HTML::Tree::AboutObjects.3pm	37918	0444	edit dl rm
HTML::Tree::AboutTrees.3pm	58534	0444	edit dl rm
HTML::Tree::Scanning.3pm	34385	0444	edit dl rm
HTML::TreeBuilder.3pm	30138	0444	edit dl rm
HTTP::Tiny.3pm	27709	0444	edit dl rm
IO::AtomicFile.3pm	5381	0444	edit dl rm
IO::Compress::Base.3pm	3506	0444	edit dl rm
IO::Compress::Bzip2.3pm	23260	0444	edit dl rm
IO::Compress::Deflate.3pm	26768	0444	edit dl rm
IO::Compress::FAQ.3pm	26718	0444	edit dl rm
IO::Compress::Gzip.3pm	34489	0444	edit dl rm
IO::Compress::RawDeflate.3pm	27134	0444	edit dl rm
IO::Compress::Zip.3pm	40870	0444	edit dl rm
IO::InnerFile.3pm	6035	0444	edit dl rm
IO::Lines.3pm	3783	0444	edit dl rm
IO::Pty.3pm	8579	0444	edit dl rm
IO::Scalar.3pm	10679	0444	edit dl rm
IO::ScalarArray.3pm	10528	0444	edit dl rm
IO::Stringy.3pm	4049	0444	edit dl rm
IO::Tty.3pm	8348	0444	edit dl rm
IO::Tty::Constant.3pm	10012	0444	edit dl rm
IO::Uncompress::AnyInflate.3pm	32800	0444	edit dl rm
IO::Uncompress::AnyUncompress.3pm	30767	0444	edit dl rm
IO::Uncompress::Base.3pm	3518	0444	edit dl rm
IO::Uncompress::Bunzip2.3pm	29171	0444	edit dl rm
IO::Uncompress::Gunzip.3pm	31719	0444	edit dl rm
IO::Uncompress::Inflate.3pm	29915	0444	edit dl rm
IO::Uncompress::RawInflate.3pm	29563	0444	edit dl rm
IO::Uncompress::Unzip.3pm	31279	0444	edit dl rm
IO::Wrap.3pm	10664	0444	edit dl rm
IO::WrapTie.3pm	14987	0444	edit dl rm
JSON::PP.3pm	50080	0444	edit dl rm
JSON::PP::Boolean.3pm	2667	0444	edit dl rm
JSON::Syck.3pm	8094	0444	edit dl rm
JSON::XS.3pm	89037	0444	edit dl rm
JSON::XS::Boolean.3pm	2857	0444	edit dl rm
lib::core::only.3pm	5647	0444	edit dl rm
local::lib.3pm	31390	0444	edit dl rm
LWP.3pm	28506	0444	edit dl rm
LWP::Authen::Ntlm.3pm	7489	0444	edit dl rm
LWP::ConnCache.3pm	9967	0444	edit dl rm
LWP::Debug.3pm	5608	0444	edit dl rm
LWP::MemberMixin.3pm	4821	0444	edit dl rm
LWP::Protocol.3pm	8350	0444	edit dl rm
LWP::Protocol::https.3pm	5684	0444	edit dl rm
LWP::RobotUA.3pm	9022	0444	edit dl rm
LWP::Simple.3pm	9016	0444	edit dl rm
LWP::UserAgent.3pm	48156	0444	edit dl rm
lwpcook.3pm	14838	0444	edit dl rm
lwptut.3pm	32441	0444	edit dl rm
Module::Build.3pm	44563	0444	edit dl rm
Module::Build::API.3pm	89267	0444	edit dl rm
Module::Build::Authoring.3pm	17363	0444	edit dl rm
Module::Build::Base.3pm	5157	0444	edit dl rm
Module::Build::Bundling.3pm	9999	0444	edit dl rm
Module::Build::Compat.3pm	10885	0444	edit dl rm
Module::Build::ConfigData.3pm	7388	0444	edit dl rm
Module::Build::Cookbook.3pm	25946	0444	edit dl rm
Module::Build::Notes.3pm	4690	0444	edit dl rm
Module::Build::Platform::aix.3pm	4472	0444	edit dl rm
Module::Build::Platform::cygwin.3pm	4505	0444	edit dl rm
Module::Build::Platform::darwin.3pm	4491	0444	edit dl rm
Module::Build::Platform::Default.3pm	4490	0444	edit dl rm
Module::Build::Platform::MacOS.3pm	5398	0444	edit dl rm
Module::Build::Platform::os2.3pm	4474	0444	edit dl rm
Module::Build::Platform::Unix.3pm	4481	0444	edit dl rm
Module::Build::Platform::VMS.3pm	7885	0444	edit dl rm
Module::Build::Platform::VOS.3pm	4477	0444	edit dl rm
Module::Build::Platform::Windows.3pm	4529	0444	edit dl rm
Module::Build::PPMMaker.3pm	4886	0444	edit dl rm
Mozilla::CA.3pm	3571	0444	edit dl rm
Net::CIDR::Lite.3pm	9562	0444	edit dl rm
Net::Cmd.3pm	11545	0444	edit dl rm
Net::Config.3pm	8100	0444	edit dl rm
Net::Domain.3pm	3835	0444	edit dl rm
Net::FTP.3pm	27341	0444	edit dl rm
Net::FTP::dataconn.3pm	3979	0444	edit dl rm
Net::HTTP.3pm	16375	0444	edit dl rm
Net::HTTP::NB.3pm	5394	0444	edit dl rm
Net::HTTPS.3pm	5438	0444	edit dl rm
Net::IP.3pm	27697	0444	edit dl rm
Net::libnetFAQ.3pm	14746	0444	edit dl rm
Net::Netrc.3pm	6729	0444	edit dl rm
Net::NNTP.3pm	23193	0444	edit dl rm
Net::POP3.3pm	12259	0444	edit dl rm
Net::SMTP.3pm	18880	0444	edit dl rm
Net::SSLeay.3pm	349350	0444	edit dl rm
Net::SSLeay::Handle.3pm	9127	0444	edit dl rm
Net::Time.3pm	4524	0444	edit dl rm
ok.3pm	2851	0444	edit dl rm
Parse::CPAN::Meta.3pm	10187	0444	edit dl rm
POD2::DE::local::lib.3pm	22879	0444	edit dl rm
POD2::PT_BR::local::lib.3pm	22762	0444	edit dl rm
Socket.3pm	34078	0444	edit dl rm
Sub::Identify.3pm	5087	0444	edit dl rm
SUPER.3pm	7394	0444	edit dl rm
Switch.3pm	19014	0444	edit dl rm
TAP::Base.3pm	3401	0444	edit dl rm
TAP::Formatter::Base.3pm	6233	0444	edit dl rm
TAP::Formatter::Color.3pm	3717	0444	edit dl rm
TAP::Formatter::Console.3pm	2722	0444	edit dl rm
TAP::Formatter::Console::ParallelSession.3pm	3065	0444	edit dl rm
TAP::Formatter::Console::Session.3pm	2832	0444	edit dl rm
TAP::Formatter::File.3pm	2693	0444	edit dl rm
TAP::Formatter::File::Session.3pm	2847	0444	edit dl rm
TAP::Formatter::Session.3pm	3603	0444	edit dl rm
TAP::Harness.3pm	21300	0444	edit dl rm
TAP::Harness::Beyond.3pm	19118	0444	edit dl rm
TAP::Harness::Env.3pm	5467	0444	edit dl rm
TAP::Object.3pm	4497	0444	edit dl rm
TAP::Parser.3pm	42210	0444	edit dl rm
TAP::Parser::Aggregator.3pm	8023	0444	edit dl rm
TAP::Parser::Grammar.3pm	8647	0444	edit dl rm
TAP::Parser::Iterator.3pm	4993	0444	edit dl rm
TAP::Parser::Iterator::Array.3pm	3771	0444	edit dl rm
TAP::Parser::Iterator::Process.3pm	4601	0444	edit dl rm
TAP::Parser::Iterator::Stream.3pm	3712	0444	edit dl rm
TAP::Parser::IteratorFactory.3pm	6904	0444	edit dl rm
TAP::Parser::Multiplexer.3pm	4646	0444	edit dl rm
TAP::Parser::Result.3pm	7512	0444	edit dl rm
TAP::Parser::Result::Bailout.3pm	3293	0444	edit dl rm
TAP::Parser::Result::Comment.3pm	3118	0444	edit dl rm
TAP::Parser::Result::Plan.3pm	4173	0444	edit dl rm
TAP::Parser::Result::Pragma.3pm	3073	0444	edit dl rm
TAP::Parser::Result::Test.3pm	7114	0444	edit dl rm
TAP::Parser::Result::Unknown.3pm	2973	0444	edit dl rm
TAP::Parser::Result::Version.3pm	3154	0444	edit dl rm
TAP::Parser::Result::YAML.3pm	3086	0444	edit dl rm
TAP::Parser::ResultFactory.3pm	5523	0444	edit dl rm
TAP::Parser::Scheduler.3pm	8113	0444	edit dl rm
TAP::Parser::Scheduler::Job.3pm	4301	0444	edit dl rm
TAP::Parser::Scheduler::Spinner.3pm	3346	0444	edit dl rm
TAP::Parser::Source.3pm	8170	0444	edit dl rm
TAP::Parser::SourceHandler.3pm	7559	0444	edit dl rm
TAP::Parser::SourceHandler::Executable.3pm	5297	0444	edit dl rm
TAP::Parser::SourceHandler::File.3pm	4567	0444	edit dl rm
TAP::Parser::SourceHandler::Handle.3pm	4425	0444	edit dl rm
TAP::Parser::SourceHandler::Perl.3pm	6262	0444	edit dl rm
TAP::Parser::SourceHandler::RawTAP.3pm	4434	0444	edit dl rm
TAP::Parser::YAMLish::Reader.3pm	3995	0444	edit dl rm
TAP::Parser::YAMLish::Writer.3pm	4879	0444	edit dl rm
Template.3pm	27909	0444	edit dl rm
Template::Base.3pm	8149	0444	edit dl rm
Template::Config.3pm	8687	0444	edit dl rm
Template::Constants.3pm	7815	0444	edit dl rm
Template::Context.3pm	26637	0444	edit dl rm
Template::Directive.3pm	4821	0444	edit dl rm
Template::Document.3pm	11829	0444	edit dl rm
Template::Exception.3pm	6763	0444	edit dl rm
Template::FAQ.3pm	14564	0444	edit dl rm
Template::Filters.3pm	9817	0444	edit dl rm
Template::Grammar.3pm	5039	0444	edit dl rm
Template::Iterator.3pm	11413	0444	edit dl rm
Template::Manual.3pm	6317	0444	edit dl rm
Template::Manual::Config.3pm	79504	0444	edit dl rm
Template::Manual::Credits.3pm	8246	0444	edit dl rm
Template::Manual::Directives.3pm	77293	0444	edit dl rm
Template::Manual::Filters.3pm	20810	0444	edit dl rm
Template::Manual::Internals.3pm	23433	0444	edit dl rm
Template::Manual::Intro.3pm	14092	0444	edit dl rm
Template::Manual::Plugins.3pm	13780	0444	edit dl rm
Template::Manual::Syntax.3pm	14549	0444	edit dl rm
Template::Manual::Variables.3pm	33110	0444	edit dl rm
Template::Manual::Views.3pm	25953	0444	edit dl rm
Template::Manual::VMethods.3pm	28195	0444	edit dl rm
Template::Modules.3pm	9827	0444	edit dl rm
Template::Namespace::Constants.3pm	6002	0444	edit dl rm
Template::Parser.3pm	9917	0444	edit dl rm
Template::Plugin.3pm	10937	0444	edit dl rm
Template::Plugin::Assert.3pm	5446	0444	edit dl rm
Template::Plugin::CGI.3pm	6188	0444	edit dl rm
Template::Plugin::Datafile.3pm	6601	0444	edit dl rm
Template::Plugin::Date.3pm	9538	0444	edit dl rm
Template::Plugin::Directory.3pm	11979	0444	edit dl rm
Template::Plugin::Dumper.3pm	6078	0444	edit dl rm
Template::Plugin::File.3pm	13009	0444	edit dl rm
Template::Plugin::Filter.3pm	12936	0444	edit dl rm
Template::Plugin::Format.3pm	4895	0444	edit dl rm
Template::Plugin::HTML.3pm	7823	0444	edit dl rm
Template::Plugin::Image.3pm	11950	0444	edit dl rm
Template::Plugin::Iterator.3pm	5061	0444	edit dl rm
Template::Plugin::Math.3pm	6623	0444	edit dl rm
Template::Plugin::Pod.3pm	4784	0444	edit dl rm
Template::Plugin::Procedural.3pm	5631	0444	edit dl rm
Template::Plugin::Scalar.3pm	5032	0444	edit dl rm
Template::Plugin::String.3pm	17263	0444	edit dl rm
Template::Plugin::Table.3pm	11145	0444	edit dl rm
Template::Plugin::URL.3pm	8080	0444	edit dl rm
Template::Plugin::View.3pm	5479	0444	edit dl rm
Template::Plugin::Wrap.3pm	6433	0444	edit dl rm
Template::Plugins.3pm	9733	0444	edit dl rm
Template::Provider.3pm	14678	0444	edit dl rm
Template::Service.3pm	14813	0444	edit dl rm
Template::Stash.3pm	11983	0444	edit dl rm
Template::Stash::Context.3pm	7130	0444	edit dl rm
Template::Stash::XS.3pm	6644	0444	edit dl rm
Template::Test.3pm	15524	0444	edit dl rm
Template::Toolkit.3pm	9227	0444	edit dl rm
Template::Tools.3pm	5001	0444	edit dl rm
Template::Tools::tpage.3pm	5806	0444	edit dl rm
Template::Tools::ttree.3pm	16567	0444	edit dl rm
Template::Tutorial.3pm	4566	0444	edit dl rm
Template::Tutorial::Datafile.3pm	19539	0444	edit dl rm
Template::Tutorial::Web.3pm	34118	0444	edit dl rm
Template::View.3pm	12618	0444	edit dl rm
Template::VMethods.3pm	4688	0444	edit dl rm
Term::ReadKey.3pm	13029	0444	edit dl rm
Test2.3pm	9556	0444	edit dl rm
Test2::API.3pm	30424	0444	edit dl rm
Test2::API::Breakage.3pm	4988	0444	edit dl rm
Test2::API::Context.3pm	17574	0444	edit dl rm
Test2::API::Instance.3pm	12404	0444	edit dl rm
Test2::API::Stack.3pm	6568	0444	edit dl rm
Test2::Event.3pm	9189	0444	edit dl rm
Test2::Event::Bail.3pm	3470	0444	edit dl rm
Test2::Event::Diag.3pm	3338	0444	edit dl rm
Test2::Event::Exception.3pm	3520	0444	edit dl rm
Test2::Event::Generic.3pm	7662	0444	edit dl rm
Test2::Event::Info.3pm	4261	0444	edit dl rm
Test2::Event::Note.3pm	3323	0444	edit dl rm
Test2::Event::Ok.3pm	4255	0444	edit dl rm
Test2::Event::Plan.3pm	3907	0444	edit dl rm
Test2::Event::Skip.3pm	3665	0444	edit dl rm
Test2::Event::Subtest.3pm	3573	0444	edit dl rm
Test2::Event::Waiting.3pm	3107	0444	edit dl rm
Test2::Formatter.3pm	5208	0444	edit dl rm
Test2::Formatter::TAP.3pm	9255	0444	edit dl rm
Test2::Hub.3pm	16755	0444	edit dl rm
Test2::Hub::Interceptor.3pm	2937	0444	edit dl rm
Test2::Hub::Interceptor::Terminator.3pm	2980	0444	edit dl rm
Test2::Hub::Subtest.3pm	3803	0444	edit dl rm
Test2::IPC.3pm	3324	0444	edit dl rm
Test2::IPC::Driver.3pm	9512	0444	edit dl rm
Test2::IPC::Driver::Files.3pm	3822	0444	edit dl rm
Test2::Transition.3pm	18406	0444	edit dl rm
Test2::Util.3pm	5123	0444	edit dl rm
Test2::Util::ExternalMeta.3pm	5594	0444	edit dl rm
Test2::Util::HashBase.3pm	7463	0444	edit dl rm
Test2::Util::Trace.3pm	5577	0444	edit dl rm
Test::Builder.3pm	26915	0444	edit dl rm
Test::Builder::Formatter.3pm	3656	0444	edit dl rm
Test::Builder::IO::Scalar.3pm	9740	0444	edit dl rm
Test::Builder::Module.3pm	5567	0444	edit dl rm
Test::Builder::Tester.3pm	11550	0444	edit dl rm
Test::Builder::Tester::Color.3pm	3131	0444	edit dl rm
Test::Builder::TodoDiag.3pm	3129	0444	edit dl rm
Test::Fatal.3pm	9303	0444	edit dl rm
Test::HACKING.3pm	9253	0444	edit dl rm
Test::Harness.3pm	11028	0444	edit dl rm
Test::LeakTrace.3pm	10022	0444	edit dl rm
Test::LeakTrace::JA.3pm	12328	0444	edit dl rm
Test::LeakTrace::Script.3pm	5140	0444	edit dl rm
Test::MockModule.3pm	10818	0444	edit dl rm
Test::More.3pm	43215	0444	edit dl rm
Test::More::UTF8.3pm	3602	0444	edit dl rm
Test::RequiresInternet.3pm	3944	0444	edit dl rm
Test::Simple.3pm	9119	0444	edit dl rm
Test::Tester.3pm	15781	0444	edit dl rm
Test::Tester::Capture.3pm	2902	0444	edit dl rm
Test::Tester::CaptureRunner.3pm	2673	0444	edit dl rm
Test::Tutorial.3pm	24261	0444	edit dl rm
Test::use::ok.3pm	3841	0444	edit dl rm
Test::Warnings.3pm	14231	0444	edit dl rm
Text::Glob.3pm	6106	0444	edit dl rm
Text::Template.3pm	65499	0444	edit dl rm
Text::Template::Preprocess.3pm	6270	0444	edit dl rm
Time::Zone.3pm	3413	0444	edit dl rm
TimeDate.3pm	2397	0444	edit dl rm
Try::Tiny.3pm	20343	0444	edit dl rm
Types::Serialiser.3pm	11473	0444	edit dl rm
Types::Serialiser::Error.3pm	2705	0444	edit dl rm
version.3pm	13937	0444	edit dl rm
version::Internals.3pm	30287	0444	edit dl rm
WWW::Mechanize.3pm	68196	0444	edit dl rm
WWW::Mechanize::Cookbook.3pm	7159	0444	edit dl rm
WWW::Mechanize::Examples.3pm	22490	0444	edit dl rm
WWW::Mechanize::FAQ.3pm	24359	0444	edit dl rm
WWW::Mechanize::Image.3pm	6490	0444	edit dl rm
WWW::Mechanize::Link.3pm	6518	0444	edit dl rm
XML::NamespaceSupport.3pm	13052	0444	edit dl rm
XML::Parser.3pm	26296	0444	edit dl rm
XML::Parser::Expat.3pm	26799	0444	edit dl rm
XML::Parser::Style::Debug.3pm	4408	0444	edit dl rm
XML::Parser::Style::Objects.3pm	4888	0444	edit dl rm
XML::Parser::Style::Stream.3pm	5925	0444	edit dl rm
XML::Parser::Style::Subs.3pm	4863	0444	edit dl rm
XML::Parser::Style::Tree.3pm	5529	0444	edit dl rm
XML::SAX.3pm	9229	0444	edit dl rm
XML::SAX::Base.3pm	13704	0444	edit dl rm
XML::SAX::BuildSAXBase.3pm	13700	0444	edit dl rm
XML::SAX::DocumentLocator.3pm	5239	0444	edit dl rm
XML::SAX::Exception.3pm	5622	0444	edit dl rm
XML::SAX::Expat.3pm	6404	0444	edit dl rm
XML::SAX::Intro.3pm	20220	0444	edit dl rm
XML::SAX::ParserFactory.3pm	7919	0444	edit dl rm
XML::SAX::PurePerl.3pm	6172	0444	edit dl rm
XML::SAX::PurePerl::Reader.3pm	4103	0444	edit dl rm
XML::Simple.3pm	65589	0444	edit dl rm
XML::Simple::FAQ.3pm	27223	0444	edit dl rm
YAML.3pm	29980	0444	edit dl rm
YAML::Any.3pm	7487	0444	edit dl rm
YAML::Dumper.3pm	4776	0444	edit dl rm
YAML::Dumper::Base.3pm	4642	0444	edit dl rm
YAML::Error.3pm	4681	0444	edit dl rm
YAML::Loader.3pm	4766	0444	edit dl rm
YAML::Loader::Base.3pm	4642	0444	edit dl rm
YAML::Marshall.3pm	4640	0444	edit dl rm
YAML::Node.3pm	6743	0444	edit dl rm
YAML::Syck.3pm	10806	0444	edit dl rm
YAML::Tag.3pm	4499	0444	edit dl rm
YAML::Types.3pm	4716	0444	edit dl rm

Edit: /usr/local/share/man/man3/Template::Tutorial::Web.3pm (34118B)

.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Template::Tutorial::Web 3"
.TH Template::Tutorial::Web 3 "2014-04-23" "perl v5.16.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Template::Tutorial::Web \- Generating Web Content Using the Template Toolkit
.SH "Overview"
.IX Header "Overview"
This tutorial document provides a introduction to the Template Toolkit and
demonstrates some of the typical ways it may be used for generating web
content. It covers the generation of static pages from templates using the
tpage and ttree scripts
and then goes on to show dynamic content generation using \s-1CGI\s0 scripts and
Apache/mod_perl handlers.
.PP
Various features of the Template Toolkit are introduced and described briefly
and explained by use of example. For further information, see Template,
Template::Manual and the various sections within it. e.g
.PP
.Vb 3
\&    perldoc Template                    # Template.pm module usage
\&    perldoc Template::Manual            # index to manual
\&    perldoc Template::Manual::Config    # e.g. configuration options
.Ve
.PP
The documentation is also available in \s-1HTML\s0 format to read online, or download
from the Template Toolkit web site:
.PP
.Vb 1
\&    http://template\-toolkit.org/docs/
.Ve
.SH "Introduction"
.IX Header "Introduction"
The Template Toolkit is a set of Perl modules which collectively
implement a template processing system.
.PP
A template is a text document with special markup tags embedded in it.
By default, the Template Toolkit uses '\f(CW\*(C`[%\*(C'\fR' and '\f(CW\*(C`%]\*(C'\fR' to denote
the start and end of a tag.  Here's an example:
.PP
.Vb 1
\&    [% INCLUDE header %]
\&    
\&    People of [% planet %], your attention please.
\&    
\&    This is [% captain %] of the
\&    Galactic Hyperspace Planning Council.
\&    
\&    As you will no doubt be aware, the plans
\&    for development of the outlying regions
\&    of the Galaxy require the building of a
\&    hyperspatial express route through your
\&    star system, and regrettably your planet
\&    is one of those scheduled for destruction.
\&    
\&    The process will take slightly less than
\&    [% time %].
\&    
\&    Thank you.
\&    
\&    [% INCLUDE footer %]
.Ve
.PP
Tags can contain simple \fIvariables\fR (like \f(CW\*(C`planet\*(C'\fR and \f(CW\*(C`captain\*(C'\fR) and more
complex \fIdirectives\fR that start with an upper case keyword (like \f(CW\*(C`INCLUDE\*(C'\fR).
A directive is an instruction that tells the template processor to perform
some action, like processing another template (\f(CW\*(C`header\*(C'\fR and \f(CW\*(C`footer\*(C'\fR in this
example) and inserting the output into the current template. In fact, the
simple variables we mentioned are actually \f(CW\*(C`GET\*(C'\fR directives, but the \f(CW\*(C`GET\*(C'\fR
keyword is optional.
.PP
.Vb 2
\&    People of [% planet %], your attention please.      # short form
\&    People of [% GET planet %], your attention please.  # long form
.Ve
.PP
Other directives include \f(CW\*(C`SET\*(C'\fR to set a variable value (the \f(CW\*(C`SET\*(C'\fR keyword is
also optional), \f(CW\*(C`FOREACH\*(C'\fR to iterate through a list of values, and \f(CW\*(C`IF\*(C'\fR,
\&\f(CW\*(C`UNLESS\*(C'\fR, \f(CW\*(C`ELSIF\*(C'\fR and \f(CW\*(C`ELSE\*(C'\fR to declare conditional blocks.
.PP
The Template Toolkit processes all \fItext\fR files equally, regardless of what
kind of content they contain.  So you can use \s-1TT\s0 to generate \s-1HTML, XML, CSS,\s0
Javascript, Perl, \s-1RTF,\s0 LaTeX, or any other text-based format.  In this tutorial,
however, we'll be concentrating on generating \s-1HTML\s0 for web pages.
.SH "Generating Static Web Content"
.IX Header "Generating Static Web Content"
Here's an example of a template used to generate an \s-1HTML\s0 document.
.PP
.Vb 2
\&    [%  INCLUDE header
\&          title = \*(AqThis is an HTML example\*(Aq;
\&        
\&        pages = [
\&          { url   = \*(Aqhttp://foo.org\*(Aq
\&            title = \*(AqThe Foo Organisation\*(Aq 
\&          }
\&          { url   = \*(Aqhttp://bar.org\*(Aq
\&            title = \*(AqThe Bar Organisation\*(Aq 
\&          }
\&        ]
\&    %]
\&       <h1>Some Interesting Links</h1>
\&       <ul>
\&    [%  FOREACH page IN pages %]
\&         <li><a href="[% page.url %]">[% page.title %]</a>
\&    [%  END %]
\&       </ul>
\&    
\&    [% INCLUDE footer %]
.Ve
.PP
This example shows how the \f(CW\*(C`INCLUDE\*(C'\fR directive is used to load and process
separate '\f(CW\*(C`header\*(C'\fR' and '\f(CW\*(C`footer\*(C'\fR' template files, including the output in
the current document.  These files might look something like this:
.PP
header:
.PP
.Vb 5
\&    <html>
\&      <head>
\&        <title>[% title %]</title>
\&      </head>
\&      <body>
.Ve
.PP
footer:
.PP
.Vb 5
\&        <div class="copyright">
\&          &copy; Copyright 2007 Arthur Dent
\&        </div>
\&      </body>
\&    </html>
.Ve
.PP
The example also uses the \f(CW\*(C`FOREACH\*(C'\fR directive to iterate through the
\&'\f(CW\*(C`pages\*(C'\fR' list to build a table of links. In this example, we have defined
this list within the template to contain a number of hash references, each
containing a '\f(CW\*(C`url\*(C'\fR' and '\f(CW\*(C`title\*(C'\fR' member. The \f(CW\*(C`FOREACH\*(C'\fR directive iterates
through the list, aliasing '\f(CW\*(C`page\*(C'\fR' to each item (in this case, hash array
references). The \f(CW\*(C`[% page.url %]\*(C'\fR and \f(CW\*(C`[% page.title %]\*(C'\fR directives then
access the individual values in the hash arrays and insert them into the
document.
.SS "Using tpage"
.IX Subsection "Using tpage"
Having created a template file we can now process it to generate some real
output. The quickest and easiest way to do this is to use the
tpage script. This is provided as part of the
Template Toolkit and should be installed in your usual Perl bin directory.
.PP
Assuming you saved your template file as \fIexample.html\fR, you would run
the command:
.PP
.Vb 1
\&    $ tpage example.html
.Ve
.PP
This will process the template file, sending the output to \f(CW\*(C`STDOUT\*(C'\fR (i.e.
whizzing past you on the screen). You may want to redirect the output to a
file but be careful not to specify the same name as the template file, or
you'll overwrite it. You may want to use one prefix for your templates (e.g.
\&'\f(CW\*(C`.tt\*(C'\fR') and another (e.g. '\f(CW\*(C`.html\*(C'\fR') for the output files.
.PP
.Vb 1
\&    $ tpage example.tt > example.html
.Ve
.PP
Or you can redirect the output to another directory. e.g.
.PP
.Vb 1
\&    $ tpage templates/example.tt > html/example.html
.Ve
.PP
The output generated would look like this:
.PP
.Vb 10
\&    <html>
\&      <head>
\&        <title>This is an HTML example</title>
\&      </head>
\&      <body>
\&        <h1>Some Interesting Links</h1>
\&        <ul>
\&          <li><a href="http://foo.org">The Foo Organsiation</a>
\&          <li><a href="http://bar.org">The Bar Organsiation</a>
\&        </ul>
\&        <div class="copyright">
\&          &copy; Copyright 2007 Arthur Dent
\&        </div>
\&      </body>
\&    </html>
.Ve
.PP
The \fIheader\fR and \fIfooter\fR template files have been included (assuming
you created them and they're in the current directory) and the link data 
has been built into an \s-1HTML\s0 list.
.SS "Using ttree"
.IX Subsection "Using ttree"
The tpage script gives you a simple and easy way to
process a single template without having to write any Perl code. The
<ttree:Template::Tools::ttree> script, also distributed as part of the
Template Toolkit, provides a more flexible way to process a number of template
documents in one go.
.PP
The first time you run the script, it will ask you if it should create a
configuration file (\fI.ttreerc\fR) in your home directory. Answer \f(CW\*(C`y\*(C'\fR to have
it create the file.
.PP
The <ttree:Template::Tools::ttree> documentation describes how you can change
the location of this file and also explains the syntax and meaning of the
various options in the file. Comments are written to the sample configuration
file which should also help.
.PP
In brief, the configuration file describes the directories in which template
files are to be found (\f(CW\*(C`src\*(C'\fR), where the corresponding output should be
written to (\f(CW\*(C`dest\*(C'\fR), and any other directories (\f(CW\*(C`lib\*(C'\fR) that may contain
template files that you plan to \f(CW\*(C`INCLUDE\*(C'\fR into your source documents. You can
also specify processing options (such as \f(CW\*(C`verbose\*(C'\fR and \f(CW\*(C`recurse\*(C'\fR) and provide
regular expression to match files that you don't want to process (\f(CW\*(C`ignore\*(C'\fR,
\&\f(CW\*(C`accept\*(C'\fR)> or should be copied instead of being processed as templates (\f(CW\*(C`copy\*(C'\fR).
.PP
An example \fI.ttreerc\fR file is shown here:
.PP
\&\f(CW$HOME\fR/.ttreerc:
.PP
.Vb 2
\&    verbose 
\&    recurse
\&    
\&    # this is where I keep other ttree config files
\&    cfg = ~/.ttree
\&    
\&    src  = ~/websrc/src
\&    lib  = ~/websrc/lib
\&    dest = ~/public_html/test
\&    
\&    ignore = \eb(CVS|RCS)\eb
\&    ignore = ^#
.Ve
.PP
You can create many different configuration files and store them
in the directory specified in the \f(CW\*(C`cfg\*(C'\fR option, shown above.  You then
add the \f(CW\*(C`\-f filename\*(C'\fR option to \f(CW\*(C`ttree\*(C'\fR to have it read that file.
.PP
When you run the script, it compares all the files in the \f(CW\*(C`src\*(C'\fR directory
(including those in sub-directories if the \f(CW\*(C`recurse\*(C'\fR option is set), with
those in the \f(CW\*(C`dest\*(C'\fR directory.  If the destination file doesn't exist or
has an earlier modification time than the corresponding source file, then 
the source will be processed with the output written to the destination 
file.  The \f(CW\*(C`\-a\*(C'\fR option forces all files to be processed, regardless of 
modification times.
.PP
The script \fIdoesn't\fR process any of the files in the \f(CW\*(C`lib\*(C'\fR directory, but it
does add it to the \f(CW\*(C`INCLUDE_PATH\*(C'\fR for the template processor so that it can
locate these files via an \f(CW\*(C`INCLUDE\*(C'\fR, \f(CW\*(C`PROCESS\*(C'\fR or \f(CW\*(C`WRAPPER\*(C'\fR directive.
Thus, the \f(CW\*(C`lib\*(C'\fR directory is an excellent place to keep template elements
such as header, footers, etc., that aren't complete documents in their own
right.
.PP
You can also specify various Template Toolkit options from the configuration
file. Consult the ttree documentation and help
summary (\f(CW\*(C`ttree \-h\*(C'\fR) for full details. e.g.
.PP
\&\f(CW$HOME\fR/.ttreerc:
.PP
.Vb 3
\&    pre_process = config
\&    interpolate
\&    post_chomp
.Ve
.PP
The \f(CW\*(C`pre_process\*(C'\fR option allows you to specify a template file which
should be processed before each file.  Unsurprisingly, there's also a
\&\f(CW\*(C`post_process\*(C'\fR option to add a template after each file.  In the
fragment above, we have specified that the \f(CW\*(C`config\*(C'\fR template should be
used as a prefix template.  We can create this file in the \f(CW\*(C`lib\*(C'\fR
directory and use it to define some common variables, including those
web page links we defined earlier and might want to re-use in other
templates.  We could also include an \s-1HTML\s0 header, title, or menu bar
in this file which would then be prepended to each and every template
file, but for now we'll keep all that in a separate \f(CW\*(C`header\*(C'\fR file.
.PP
\&\f(CW$lib\fR/config:
.PP
.Vb 10
\&    [% root     = \*(Aq~/abw\*(Aq
\&       home     = "$root/index.html"
\&       images   = "$root/images"
\&       email    = \*(Aqabw@wardley.org\*(Aq
\&       graphics = 1
\&       webpages = [
\&         { url => \*(Aqhttp://foo.org\*(Aq, title => \*(AqThe Foo Organsiation\*(Aq }
\&         { url => \*(Aqhttp://bar.org\*(Aq, title => \*(AqThe Bar Organsiation\*(Aq }
\&       ]
\&    %]
.Ve
.PP
Assuming you've created or copied the \f(CW\*(C`header\*(C'\fR and \f(CW\*(C`footer\*(C'\fR files from the 
earlier example into your \f(CW\*(C`lib\*(C'\fR directory, you can now start to create 
web pages like the following in your \f(CW\*(C`src\*(C'\fR directory and process them 
with \f(CW\*(C`ttree\*(C'\fR.
.PP
\&\f(CW$src\fR/newpage.html:
.PP
.Vb 3
\&    [% INCLUDE header
\&       title = \*(AqAnother Template Toolkit Test Page\*(Aq
\&    %]
\&    
\&        <a href="[% home %]">Home</a>
\&        <a href="mailto:[% email %]">Email</a>
\&    
\&    [% IF graphics %]
\&        <img src="[% images %]/logo.gif" align=right width=60 height=40>
\&    [% END %]
\&    
\&    [% INCLUDE footer %]
.Ve
.PP
Here we've shown how pre-defined variables can be used as flags to
enable certain feature (e.g. \f(CW\*(C`graphics\*(C'\fR) and to specify common items
such as an email address and \s-1URL\s0's for the home page, images directory
and so on.  This approach allows you to define these values once so
that they're consistent across all pages and can easily be changed to 
new values.
.PP
When you run \fIttree\fR, you should see output similar to the following
(assuming you have the verbose flag set).
.PP
.Vb 1
\&    ttree 2.9 (Template Toolkit version 2.20)
\&    
\&         Source: /home/abw/websrc/src
\&    Destination: /home/abw/public_html/test
\&   Include Path: [ /home/abw/websrc/lib ]
\&         Ignore: [ \eb(CVS|RCS)\eb, ^# ]
\&           Copy: [  ]
\&         Accept: [ * ]
\&         
\&    + newpage.html
.Ve
.PP
The \f(CW\*(C`+\*(C'\fR in front of the \f(CW\*(C`newpage.html\*(C'\fR filename shows that the file was
processed, with the output being written to the destination directory. If you
run the same command again, you'll see the following line displayed instead
showing a \f(CW\*(C`\-\*(C'\fR and giving a reason why the file wasn't processed.
.PP
.Vb 1
\&    \- newpage.html                     (not modified)
.Ve
.PP
It has detected a \f(CW\*(C`newpage.html\*(C'\fR in the destination directory which is
more recent than that in the source directory and so hasn't bothered
to waste time re-processing it.  To force all files to be processed,
use the \f(CW\*(C`\-a\*(C'\fR option.  You can also specify one or more filenames as
command line arguments to \f(CW\*(C`ttree\*(C'\fR:
.PP
.Vb 1
\&    tpage newpage.html
.Ve
.PP
This is what the destination page looks like.
.PP
\&\f(CW$dest\fR/newpage.html:
.PP
.Vb 5
\&    <html>
\&      <head>
\&        <title>Another Template Toolkit Test Page</title>
\&      </head>
\&      <body>
\&        
\&        <a href="~/abw/index.html">Home</a>
\&        <a href="mailto:abw@wardley.org">Email me</a>
\&        <img src="~/abw/images/logo.gif" align=right width=60 height=40>
\&        
\&        <div class="copyright">
\&          &copy; Copyright 2007 Arthur Dent
\&        </div>
\&      </body>
\&    </html>
.Ve
.PP
You can add as many documents as you like to the \f(CW\*(C`src\*(C'\fR directory and
\&\f(CW\*(C`ttree\*(C'\fR will apply the same process to them all.  In this way, it is
possible to build an entire tree of static content for a web site with
a single command.  The added benefit is that you can be assured of
consistency in links, header style, or whatever else you choose to
implement in terms of common templates elements or variables.
.SH "Dynamic Content Generation Via CGI Script"
.IX Header "Dynamic Content Generation Via CGI Script"
The Template module provides a simple front-end to the Template Toolkit for
use in \s-1CGI\s0 scripts and Apache/mod_perl handlers. Simply \f(CW\*(C`use\*(C'\fR the Template
module, create an object instance with the \fInew()\fR method and then call the
\&\fIprocess()\fR method on the object, passing the name of the template file as a
parameter. The second parameter passed is a reference to a hash array of
variables that we want made available to the template:
.PP
.Vb 4
\&    #!/usr/bin/perl
\&    use strict;
\&    use warnings;
\&    use Template;
\&    
\&    my $file = \*(Aqsrc/greeting.html\*(Aq;
\&    my $vars = {
\&       message  => "Hello World\en"
\&    };
\&    
\&    my $template = Template\->new();
\&    
\&    $template\->process($file, $vars)
\&        || die "Template process failed: ", $template\->error(), "\en";
.Ve
.PP
So that our scripts will work with the same template files as our earlier
examples, we'll can add some configuration options to the constructor to 
tell it about our environment:
.PP
.Vb 6
\&    my $template\->new({
\&        # where to find template files
\&        INCLUDE_PATH => [\*(Aq/home/abw/websrc/src\*(Aq, \*(Aq/home/abw/websrc/lib\*(Aq],
\&        # pre\-process lib/config to define any extra values
\&        PRE_PROCESS  => \*(Aqconfig\*(Aq,
\&    });
.Ve
.PP
Note that here we specify the \f(CW\*(C`config\*(C'\fR file as a \f(CW\*(C`PRE_PROCESS\*(C'\fR option.
This means that the templates we process can use the same global
variables defined earlier for our static pages.  We don't have to
replicate their definitions in this script.  However, we can supply
additional data and functionality specific to this script via the hash
of variables that we pass to the \f(CW\*(C`process()\*(C'\fR method.
.PP
These entries in this hash may contain simple text or other values,
references to lists, others hashes, sub-routines or objects.  The Template
Toolkit will automatically apply the correct procedure to access these 
different types when you use the variables in a template.
.PP
Here's a more detailed example to look over.  Amongst the different
template variables we define in \f(CW$vars\fR, we create a reference to a
\&\s-1CGI\s0 object and a \f(CW\*(C`get_user_projects()\*(C'\fR sub-routine.
.PP
.Vb 5
\&    #!/usr/bin/perl
\&    use strict;
\&    use warnings;
\&    use Template;
\&    use CGI;
\&    
\&    $| = 1;
\&    print "Content\-type: text/html\en\en";
\&    
\&    my $file = \*(Aquserinfo.html\*(Aq;
\&    my $vars = {
\&        \*(Aqversion\*(Aq  => 3.14,
\&        \*(Aqdays\*(Aq     => [ qw( mon tue wed thu fri sat sun ) ],
\&        \*(Aqworklist\*(Aq => \e&get_user_projects,
\&        \*(Aqcgi\*(Aq      => CGI\->new(),
\&        \*(Aqme\*(Aq       => {
\&            \*(Aqid\*(Aq     => \*(Aqabw\*(Aq,
\&            \*(Aqname\*(Aq   => \*(AqAndy Wardley\*(Aq,
\&        },
\&    };
\&    
\&    sub get_user_projects {
\&        my $user = shift;
\&        my @projects = ...   # do something to retrieve data
\&        return \e@projects;
\&    }
\&    
\&    my $template = Template\->new({
\&        INCLUDE_PATH => \*(Aq/home/abw/websrc/src:/home/abw/websrc/lib\*(Aq,
\&        PRE_PROCESS  => \*(Aqconfig\*(Aq,
\&    });
\&    
\&    $template\->process($file, $vars)
\&        || die $template\->error();
.Ve
.PP
Here's a sample template file that we might create to build the output
for this script.
.PP
\&\f(CW$src\fR/userinfo.html:
.PP
.Vb 3
\&    [% INCLUDE header
\&       title = \*(AqTemplate Toolkit CGI Test\*(Aq
\&    %]
\&    
\&    <a href="mailto:[% email %]">Email [% me.name %]</a>
\&    
\&    <p>This is version [% version %]</p>
\&    
\&    <h3>Projects</h3>
\&    <ul>
\&    [% FOREACH project IN worklist(me.id) %]
\&       <li> <a href="[% project.url %]">[% project.name %]</a>
\&    [% END %]
\&    </ul>
\&    
\&    [% INCLUDE footer %]
.Ve
.PP
This example shows how we've separated the Perl implementation (code) from the
presentation (\s-1HTML\s0). This not only makes them easier to maintain in isolation,
but also allows the re-use of existing template elements such as headers and
footers, etc. By using template to create the output of your \s-1CGI\s0 scripts, you
can give them the same consistency as your static pages built via
ttree or other means.
.PP
Furthermore, we can modify our script so that it processes any one of a
number of different templates based on some condition.  A \s-1CGI\s0 script to
maintain a user database, for example, might process one template to
provide an empty form for new users, the same form with some default 
values set for updating an existing user record, a third template for
listing all users in the system, and so on.  You can use any Perl 
functionality you care to write to implement the logic of your 
application and then choose one or other template to generate the 
desired output for the application state.
.SH "Dynamic Content Generation Via Apache/Mod_Perl Handler"
.IX Header "Dynamic Content Generation Via Apache/Mod_Perl Handler"
\&\fB\s-1NOTE:\s0\fR the Apache::Template module is available from \s-1CPAN\s0 and provides a
simple and easy to use Apache/mod_perl interface to the Template Toolkit.
Although basic, it implements most, if not all of what is described below, and
it avoids the need to write your own handler. However, in many cases, you'll
want to write your own handler to customise processing for your own need, and
this section will show you how to get started.
.PP
The Template module can be used from an Apache/mod_perl handler. Here's an
example of a typical Apache \fIhttpd.conf\fR file:
.PP
.Vb 3
\&    PerlModule CGI;
\&    PerlModule Template
\&    PerlModule MyOrg::Apache::User
\&    
\&    PerlSetVar websrc_root   /home/abw/websrc
\&    
\&    <Location /user/bin>
\&        SetHandler     perl\-script
\&        PerlHandler    MyOrg::Apache::User
\&    </Location>
.Ve
.PP
This defines a location called \f(CW\*(C`/user/bin\*(C'\fR to which all requests will
be forwarded to the \f(CW\*(C`handler()\*(C'\fR method of the \f(CW\*(C`MyOrg::Apache::User\*(C'\fR
module.  That module might look something like this:
.PP
.Vb 1
\&    package MyOrg::Apache::User;
\&    
\&    use strict;
\&    use vars qw( $VERSION );
\&    use Apache::Constants qw( :common );
\&    use Template qw( :template );
\&    use CGI;
\&    
\&    $VERSION = 1.59;
\&    
\&    sub handler {
\&        my $r = shift;
\&        
\&        my $websrc = $r\->dir_config(\*(Aqwebsrc_root\*(Aq)
\&            or return fail($r, SERVER_ERROR,
\&                           "\*(Aqwebsrc_root\*(Aq not specified");
\&                           
\&        my $template = Template\->new({ 
\&            INCLUDE_PATH  => "$websrc/src/user:$websrc/lib",
\&            PRE_PROCESS   => \*(Aqconfig\*(Aq,
\&            OUTPUT        => $r,     # direct output to Apache request
\&        });
\&        
\&        my $params = {
\&            uri     => $r\->uri,
\&            cgi     => CGI\->new,
\&        };
\&        
\&        # use the path_info to determine which template file to process
\&        my $file = $r\->path_info;
\&        $file =~ s[^/][];
\&        
\&        $r\->content_type(\*(Aqtext/html\*(Aq);
\&        $r\->send_http_header;
\&            
\&        $template\->process($file, $params) 
\&            || return fail($r, SERVER_ERROR, $template\->error());
\&        
\&        return OK;
\&    }
\&    
\&    sub fail {
\&        my ($r, $status, $message) = @_;
\&        $r\->log_reason($message, $r\->filename);
\&        return $status;
\&    }
.Ve
.PP
The handler accepts the request and uses it to determine the \f(CW\*(C`websrc_root\*(C'\fR
value from the config file.  This is then used to define an \f(CW\*(C`INCLUDE_PATH\*(C'\fR
for a new Template object.  The \s-1URI\s0 is extracted from the request and a 
\&\s-1CGI\s0 object is created.  These are both defined as template variables.
.PP
The name of the template file itself is taken from the \f(CW\*(C`PATH_INFO\*(C'\fR element
of the request.  In this case, it would comprise the part of the \s-1URL \s0
coming after \f(CW\*(C`/user/bin\*(C'\fR,  e.g for \f(CW\*(C`/user/bin/edit\*(C'\fR, the template file
would be \f(CW\*(C`edit\*(C'\fR located in \f(CW\*(C`$websrc/src/user\*(C'\fR.  The headers are sent 
and the template file is processed.  All output is sent directly to the
\&\f(CW\*(C`print()\*(C'\fR method of the Apache request object.
.SH "Using Plugins to Extend Functionality"
.IX Header "Using Plugins to Extend Functionality"
As we've already shown, it is possible to bind Perl data and functions
to template variables when creating dynamic content via a \s-1CGI\s0 script
or Apache/mod_perl process.  The Template Toolkit also supports a
plugin interface which allows you define such additional data and/or
functionality in a separate module and then load and use it as
required with the \f(CW\*(C`USE\*(C'\fR directive.
.PP
The main benefit to this approach is that you can load the extension into
any template document, even those that are processed \*(L"statically\*(R" by 
\&\f(CW\*(C`tpage\*(C'\fR or \f(CW\*(C`ttree\*(C'\fR.  You \fIdon't\fR need to write a Perl wrapper to 
explicitly load the module and make it available via the stash.
.PP
Let's demonstrate this principle using the \f(CW\*(C`DBI\*(C'\fR plugin written by Simon
Matthews (available from \s-1CPAN\s0). You can create this template in your \f(CW\*(C`src\*(C'\fR
directory and process it using \f(CW\*(C`ttree\*(C'\fR to see the results. Of course, this
example relies on the existence of the appropriate \s-1SQL\s0 database but you should
be able to adapt it to your own resources, or at least use it as a
demonstrative example of what's possible.
.PP
.Vb 3
\&    [% INCLUDE header
\&         title = \*(AqUser Info\*(Aq
\&    %]
\&    
\&    [% USE DBI(\*(Aqdbi:mSQL:mydbname\*(Aq) %]
\&    
\&    <table border=0 width="100%">
\&      <tr>
\&        <th>User ID</th> 
\&        <th>Name</th>  
\&        <th>Email</th>
\&      </tr>
\&    [% FOREACH user IN DBI.query(\*(AqSELECT * FROM user ORDER BY id\*(Aq) %]
\&      <tr>
\&        <td>[% user.id %]</td> 
\&        <td>[% user.name %]</td> 
\&        <td>[% user.email %]</td>
\&      </tr>
\&    [% END %]
\&    </table>
\&    
\&    [% INCLUDE footer %]
.Ve
.PP
A plugin is simply a Perl module in a known location and conforming to 
a known standard such that the Template Toolkit can find and load it 
automatically.  You can create your own plugin by inheriting from the 
Template::Plugin module.
.PP
Here's an example which defines some data items (\f(CW\*(C`foo\*(C'\fR and \f(CW\*(C`people\*(C'\fR)
and also an object method (\f(CW\*(C`bar\*(C'\fR).  We'll call the plugin \f(CW\*(C`FooBar\*(C'\fR for
want of a better name and create it in the \f(CW\*(C`MyOrg::Template::Plugin::FooBar\*(C'\fR
package.  We've added a \f(CW\*(C`MyOrg\*(C'\fR to the regular \f(CW\*(C`Template::Plugin::*\*(C'\fR package
to avoid any conflict with existing plugins.
.PP
.Vb 3
\&    package MyOrg::Template::Plugin::FooBar;
\&    use base \*(AqTemplate::Plugin\*(Aq
\&    our $VERSION = 1.23;
\&    
\&    sub new {
\&        my ($class, $context, @params) = @_;
\&        
\&        bless {
\&            _CONTEXT => $context,
\&            foo      => 25,
\&            people   => [ \*(Aqtom\*(Aq, \*(Aqdick\*(Aq, \*(Aqharry\*(Aq ],
\&        }, $class;
\&    }
\&    
\&    sub bar {
\&        my ($self, @params) = @_;
\&        # ...do something...    
\&        return $some_value;
\&    }
.Ve
.PP
The plugin constructor \f(CW\*(C`new()\*(C'\fR receives the class name as the first
parameter, as is usual in Perl, followed by a reference to something called a
Template::Context object. You don't need to worry too much about this at
the moment, other than to know that it's the main processing object for the
Template Toolkit. It provides access to the functionality of the processor and
some plugins may need to communicate with it. We don't at this stage, but
we'll save the reference anyway in the \f(CW\*(C`_CONTEXT\*(C'\fR member. The leading
underscore is a convention which indicates that this item is private and the
Template Toolkit won't attempt to access this member. The other members
defined, \f(CW\*(C`foo\*(C'\fR and \f(CW\*(C`people\*(C'\fR are regular data items which will be made
available to templates using this plugin. Following the context reference are
passed any additional parameters specified with the \s-1USE\s0 directive, such as the
data source parameter, \f(CW\*(C`dbi:mSQL:mydbname\*(C'\fR, that we used in the earlier \s-1DBI\s0
example.
.PP
If you don't or can't install it to the regular place for your Perl 
modules (perhaps because you don't have the required privileges) then
you can set the \s-1PERL5LIB\s0 environment variable to specify another location.
If you're using \f(CW\*(C`ttree\*(C'\fR then you can add the following line to your 
configuration file instead.
.PP
\&\f(CW$HOME\fR/.ttreerc:
.PP
.Vb 1
\&    perl5lib = /path/to/modules
.Ve
.PP
One further configuration item must be added to inform the toolkit of
the new package name we have adopted for our plugins:
.PP
\&\f(CW$HOME\fR/.ttreerc:
.PP
.Vb 1
\&    plugin_base = \*(AqMyOrg::Template::Plugin\*(Aq
.Ve
.PP
If you're writing Perl code to control the Template modules directly,
then this value can be passed as a configuration parameter when you 
create the module.
.PP
.Vb 1
\&    use Template;
\&    
\&    my $template = Template\->new({ 
\&        PLUGIN_BASE => \*(AqMyOrg::Template::Plugin\*(Aq 
\&    });
.Ve
.PP
Now we can create a template which uses this plugin:
.PP
.Vb 3
\&    [% INCLUDE header
\&       title = \*(AqFooBar Plugin Test\*(Aq
\&    %]
\&    
\&    [% USE FooBar %]
\&    
\&    Some values available from this plugin:
\&      [% FooBar.foo %] [% FooBar.bar %]
\&      
\&    The users defined in the \*(Aqpeople\*(Aq list:
\&    [% FOREACH uid = FooBar.people %]
\&      * [% uid %]
\&    [% END %]
\&    
\&    [% INCLUDE footer %]
.Ve
.PP
The \f(CW\*(C`foo\*(C'\fR, \f(CW\*(C`bar\*(C'\fR, and \f(CW\*(C`people\*(C'\fR items of the FooBar plugin are
automatically resolved to the appropriate data items or method calls
on the underlying object.
.PP
Using this approach, it is possible to create application
functionality in a single module which can then be loaded and used on
demand in any template.  The simple interface between template
directives and plugin objects allows complex, dynamic content to be
built from a few simple template documents without knowing anything
about the underlying implementation.
.SH "AUTHOR"
.IX Header "AUTHOR"
Andy Wardley <abw@wardley.org> <http://wardley.org/>
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 1996\-2007 Andy Wardley.  All Rights Reserved.
.PP
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

cmd: