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/Test::Tutorial.3pm (24261B)

.\" 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
.\" ========================================================================
.\"
.IX Title "Test::Tutorial 3"
.TH Test::Tutorial 3 "2016-10-20" "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"
Test::Tutorial \- A tutorial about writing really basic tests
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fI\s-1AHHHHHHH\s0!!!!  \s-1NOT TESTING\s0!  Anything but testing!
Beat me, whip me, send me to Detroit, but don't make
me write tests!\fR
.PP
\&\fI*sob*\fR
.PP
\&\fIBesides, I don't know how to write the damned things.\fR
.PP
Is this you?  Is writing tests right up there with writing
documentation and having your fingernails pulled out?  Did you open up
a test and read
.PP
.Vb 1
\&    ######## We start with some black magic
.Ve
.PP
and decide that's quite enough for you?
.PP
It's ok.  That's all gone now.  We've done all the black magic for
you.  And here are the tricks...
.SS "Nuts and bolts of testing."
.IX Subsection "Nuts and bolts of testing."
Here's the most basic test program.
.PP
.Vb 1
\&    #!/usr/bin/perl \-w
\&
\&    print "1..1\en";
\&
\&    print 1 + 1 == 2 ? "ok 1\en" : "not ok 1\en";
.Ve
.PP
Because 1 + 1 is 2, it prints:
.PP
.Vb 2
\&    1..1
\&    ok 1
.Ve
.PP
What this says is: \f(CW1..1\fR \*(L"I'm going to run one test.\*(R" [1] \f(CW\*(C`ok 1\*(C'\fR
\&\*(L"The first test passed\*(R".  And that's about all magic there is to
testing.  Your basic unit of testing is the \fIok\fR.  For each thing you
test, an \f(CW\*(C`ok\*(C'\fR is printed.  Simple.  Test::Harness interprets your test
results to determine if you succeeded or failed (more on that later).
.PP
Writing all these print statements rapidly gets tedious.  Fortunately,
there's Test::Simple.  It has one function, \f(CW\*(C`ok()\*(C'\fR.
.PP
.Vb 1
\&    #!/usr/bin/perl \-w
\&
\&    use Test::Simple tests => 1;
\&
\&    ok( 1 + 1 == 2 );
.Ve
.PP
That does the same thing as the previous code.  \f(CW\*(C`ok()\*(C'\fR is the backbone
of Perl testing, and we'll be using it instead of roll-your-own from
here on.  If \f(CW\*(C`ok()\*(C'\fR gets a true value, the test passes.  False, it
fails.
.PP
.Vb 1
\&    #!/usr/bin/perl \-w
\&
\&    use Test::Simple tests => 2;
\&    ok( 1 + 1 == 2 );
\&    ok( 2 + 2 == 5 );
.Ve
.PP
From that comes:
.PP
.Vb 5
\&    1..2
\&    ok 1
\&    not ok 2
\&    #     Failed test (test.pl at line 5)
\&    # Looks like you failed 1 tests of 2.
.Ve
.PP
\&\f(CW1..2\fR \*(L"I'm going to run two tests.\*(R"  This number is a \fIplan\fR. It helps to
ensure your test program ran all the way through and didn't die or skip some
tests.  \f(CW\*(C`ok 1\*(C'\fR \*(L"The first test passed.\*(R"  \f(CW\*(C`not ok 2\*(C'\fR \*(L"The second test failed\*(R".
Test::Simple helpfully prints out some extra commentary about your tests.
.PP
It's not scary.  Come, hold my hand.  We're going to give an example
of testing a module.  For our example, we'll be testing a date
library, Date::ICal.  It's on \s-1CPAN,\s0 so download a copy and follow
along. [2]
.SS "Where to start?"
.IX Subsection "Where to start?"
This is the hardest part of testing, where do you start?  People often get
overwhelmed at the apparent enormity of the task of testing a whole module.
The best place to start is at the beginning.  Date::ICal is an
object-oriented module, and that means you start by making an object.  Test
\&\f(CW\*(C`new()\*(C'\fR.
.PP
.Vb 1
\&    #!/usr/bin/perl \-w
\&
\&    # assume these two lines are in all subsequent examples
\&    use strict;
\&    use warnings;
\&
\&    use Test::Simple tests => 2;
\&
\&    use Date::ICal;
\&
\&    my $ical = Date::ICal\->new;         # create an object
\&    ok( defined $ical );                # check that we got something
\&    ok( $ical\->isa(\*(AqDate::ICal\*(Aq) );     # and it\*(Aqs the right class
.Ve
.PP
Run that and you should get:
.PP
.Vb 3
\&    1..2
\&    ok 1
\&    ok 2
.Ve
.PP
Congratulations! You've written your first useful test.
.SS "Names"
.IX Subsection "Names"
That output isn't terribly descriptive, is it?  When you have two tests you can
figure out which one is #2, but what if you have 102 tests?
.PP
Each test can be given a little descriptive name as the second
argument to \f(CW\*(C`ok()\*(C'\fR.
.PP
.Vb 1
\&    use Test::Simple tests => 2;
\&
\&    ok( defined $ical,              \*(Aqnew() returned something\*(Aq );
\&    ok( $ical\->isa(\*(AqDate::ICal\*(Aq),   "  and it\*(Aqs the right class" );
.Ve
.PP
Now you'll see:
.PP
.Vb 3
\&    1..2
\&    ok 1 \- new() returned something
\&    ok 2 \-   and it\*(Aqs the right class
.Ve
.SS "Test the manual"
.IX Subsection "Test the manual"
The simplest way to build up a decent testing suite is to just test what
the manual says it does. [3] Let's pull something out of the
\&\*(L"\s-1SYNOPSIS\*(R"\s0 in Date::ICal and test that all its bits work.
.PP
.Vb 1
\&    #!/usr/bin/perl \-w
\&
\&    use Test::Simple tests => 8;
\&
\&    use Date::ICal;
\&
\&    $ical = Date::ICal\->new( year => 1964, month => 10, day => 16,
\&                             hour => 16,   min   => 12, sec => 47,
\&                             tz   => \*(Aq0530\*(Aq );
\&
\&    ok( defined $ical,            \*(Aqnew() returned something\*(Aq );
\&    ok( $ical\->isa(\*(AqDate::ICal\*(Aq), "  and it\*(Aqs the right class" );
\&    ok( $ical\->sec   == 47,       \*(Aq  sec()\*(Aq   );
\&    ok( $ical\->min   == 12,       \*(Aq  min()\*(Aq   );
\&    ok( $ical\->hour  == 16,       \*(Aq  hour()\*(Aq  );
\&    ok( $ical\->day   == 17,       \*(Aq  day()\*(Aq   );
\&    ok( $ical\->month == 10,       \*(Aq  month()\*(Aq );
\&    ok( $ical\->year  == 1964,     \*(Aq  year()\*(Aq  );
.Ve
.PP
Run that and you get:
.PP
.Vb 11
\&    1..8
\&    ok 1 \- new() returned something
\&    ok 2 \-   and it\*(Aqs the right class
\&    ok 3 \-   sec()
\&    ok 4 \-   min()
\&    ok 5 \-   hour()
\&    not ok 6 \-   day()
\&    #     Failed test (\- at line 16)
\&    ok 7 \-   month()
\&    ok 8 \-   year()
\&    # Looks like you failed 1 tests of 8.
.Ve
.PP
Whoops, a failure! [4] Test::Simple helpfully lets us know on what line the
failure occurred, but not much else.  We were supposed to get 17, but we
didn't.  What did we get??  Dunno.  You could re-run the test in the debugger
or throw in some print statements to find out.
.PP
Instead, switch from Test::Simple to Test::More.  Test::More
does everything Test::Simple does, and more!  In fact, Test::More does
things \fIexactly\fR the way Test::Simple does.  You can literally swap
Test::Simple out and put Test::More in its place.  That's just what
we're going to do.
.PP
Test::More does more than Test::Simple.  The most important difference at
this point is it provides more informative ways to say \*(L"ok\*(R".  Although you can
write almost any test with a generic \f(CW\*(C`ok()\*(C'\fR, it can't tell you what went
wrong.  The \f(CW\*(C`is()\*(C'\fR function lets us declare that something is supposed to be
the same as something else:
.PP
.Vb 1
\&    use Test::More tests => 8;
\&
\&    use Date::ICal;
\&
\&    $ical = Date::ICal\->new( year => 1964, month => 10, day => 16,
\&                             hour => 16,   min   => 12, sec => 47,
\&                             tz   => \*(Aq0530\*(Aq );
\&
\&    ok( defined $ical,            \*(Aqnew() returned something\*(Aq );
\&    ok( $ical\->isa(\*(AqDate::ICal\*(Aq), "  and it\*(Aqs the right class" );
\&    is( $ical\->sec,     47,       \*(Aq  sec()\*(Aq   );
\&    is( $ical\->min,     12,       \*(Aq  min()\*(Aq   );
\&    is( $ical\->hour,    16,       \*(Aq  hour()\*(Aq  );
\&    is( $ical\->day,     17,       \*(Aq  day()\*(Aq   );
\&    is( $ical\->month,   10,       \*(Aq  month()\*(Aq );
\&    is( $ical\->year,    1964,     \*(Aq  year()\*(Aq  );
.Ve
.PP
"Is \f(CW\*(C`$ical\->sec\*(C'\fR 47?\*(L"  \*(R"Is \f(CW\*(C`$ical\->min\*(C'\fR 12?"  With \f(CW\*(C`is()\*(C'\fR in place,
you get more information:
.PP
.Vb 10
\&    1..8
\&    ok 1 \- new() returned something
\&    ok 2 \-   and it\*(Aqs the right class
\&    ok 3 \-   sec()
\&    ok 4 \-   min()
\&    ok 5 \-   hour()
\&    not ok 6 \-   day()
\&    #     Failed test (\- at line 16)
\&    #          got: \*(Aq16\*(Aq
\&    #     expected: \*(Aq17\*(Aq
\&    ok 7 \-   month()
\&    ok 8 \-   year()
\&    # Looks like you failed 1 tests of 8.
.Ve
.PP
Aha. \f(CW\*(C`$ical\->day\*(C'\fR returned 16, but we expected 17.  A
quick check shows that the code is working fine, we made a mistake
when writing the tests.  Change it to:
.PP
.Vb 1
\&    is( $ical\->day,     16,       \*(Aq  day()\*(Aq   );
.Ve
.PP
\&... and everything works.
.PP
Any time you're doing a \*(L"this equals that\*(R" sort of test, use \f(CW\*(C`is()\*(C'\fR.
It even works on arrays.  The test is always in scalar context, so you
can test how many elements are in an array this way. [5]
.PP
.Vb 1
\&    is( @foo, 5, \*(Aqfoo has 5 elements\*(Aq );
.Ve
.SS "Sometimes the tests are wrong"
.IX Subsection "Sometimes the tests are wrong"
This brings up a very important lesson.  Code has bugs.  Tests are
code.  Ergo, tests have bugs.  A failing test could mean a bug in the
code, but don't discount the possibility that the test is wrong.
.PP
On the flip side, don't be tempted to prematurely declare a test
incorrect just because you're having trouble finding the bug.
Invalidating a test isn't something to be taken lightly, and don't use
it as a cop out to avoid work.
.SS "Testing lots of values"
.IX Subsection "Testing lots of values"
We're going to be wanting to test a lot of dates here, trying to trick
the code with lots of different edge cases.  Does it work before 1970?
After 2038?  Before 1904?  Do years after 10,000 give it trouble?
Does it get leap years right?  We could keep repeating the code above,
or we could set up a little try/expect loop.
.PP
.Vb 2
\&    use Test::More tests => 32;
\&    use Date::ICal;
\&
\&    my %ICal_Dates = (
\&            # An ICal string     And the year, month, day
\&            #                    hour, minute and second we expect.
\&            \*(Aq19971024T120000\*(Aq =>    # from the docs.
\&                                [ 1997, 10, 24, 12,  0,  0 ],
\&            \*(Aq20390123T232832\*(Aq =>    # after the Unix epoch
\&                                [ 2039,  1, 23, 23, 28, 32 ],
\&            \*(Aq19671225T000000\*(Aq =>    # before the Unix epoch
\&                                [ 1967, 12, 25,  0,  0,  0 ],
\&            \*(Aq18990505T232323\*(Aq =>    # before the MacOS epoch
\&                                [ 1899,  5,  5, 23, 23, 23 ],
\&    );
\&
\&
\&    while( my($ical_str, $expect) = each %ICal_Dates ) {
\&        my $ical = Date::ICal\->new( ical => $ical_str );
\&
\&        ok( defined $ical,            "new(ical => \*(Aq$ical_str\*(Aq)" );
\&        ok( $ical\->isa(\*(AqDate::ICal\*(Aq), "  and it\*(Aqs the right class" );
\&
\&        is( $ical\->year,    $expect\->[0],     \*(Aq  year()\*(Aq  );
\&        is( $ical\->month,   $expect\->[1],     \*(Aq  month()\*(Aq );
\&        is( $ical\->day,     $expect\->[2],     \*(Aq  day()\*(Aq   );
\&        is( $ical\->hour,    $expect\->[3],     \*(Aq  hour()\*(Aq  );
\&        is( $ical\->min,     $expect\->[4],     \*(Aq  min()\*(Aq   );
\&        is( $ical\->sec,     $expect\->[5],     \*(Aq  sec()\*(Aq   );
\&    }
.Ve
.PP
Now we can test bunches of dates by just adding them to
\&\f(CW%ICal_Dates\fR.  Now that it's less work to test with more dates, you'll
be inclined to just throw more in as you think of them.
Only problem is, every time we add to that we have to keep adjusting
the \*(L"use Test::More tests => ##\*(R" line.  That can rapidly get
annoying.  There are ways to make this work better.
.PP
First, we can calculate the plan dynamically using the \f(CW\*(C`plan()\*(C'\fR
function.
.PP
.Vb 2
\&    use Test::More;
\&    use Date::ICal;
\&
\&    my %ICal_Dates = (
\&        ...same as before...
\&    );
\&
\&    # For each key in the hash we\*(Aqre running 8 tests.
\&    plan tests => keys(%ICal_Dates) * 8;
\&
\&    ...and then your tests...
.Ve
.PP
To be even more flexible, use \f(CW\*(C`done_testing\*(C'\fR.  This means we're just
running some tests, don't know how many. [6]
.PP
.Vb 1
\&    use Test::More;   # instead of tests => 32
\&
\&    ... # tests here
\&
\&    done_testing();   # reached the end safely
.Ve
.PP
If you don't specify a plan, Test::More expects to see \f(CW\*(C`done_testing()\*(C'\fR
before your program exits. It will warn you if you forget it. You can give
\&\f(CW\*(C`done_testing()\*(C'\fR an optional number of tests you expected to run, and if the
number ran differs, Test::More will give you another kind of warning.
.SS "Informative names"
.IX Subsection "Informative names"
Take a look at the line:
.PP
.Vb 1
\&    ok( defined $ical,            "new(ical => \*(Aq$ical_str\*(Aq)" );
.Ve
.PP
We've added more detail about what we're testing and the ICal string
itself we're trying out to the name.  So you get results like:
.PP
.Vb 8
\&    ok 25 \- new(ical => \*(Aq19971024T120000\*(Aq)
\&    ok 26 \-   and it\*(Aqs the right class
\&    ok 27 \-   year()
\&    ok 28 \-   month()
\&    ok 29 \-   day()
\&    ok 30 \-   hour()
\&    ok 31 \-   min()
\&    ok 32 \-   sec()
.Ve
.PP
If something in there fails, you'll know which one it was and that
will make tracking down the problem easier.  Try to put a bit of
debugging information into the test names.
.PP
Describe what the tests test, to make debugging a failed test easier
for you or for the next person who runs your test.
.SS "Skipping tests"
.IX Subsection "Skipping tests"
Poking around in the existing Date::ICal tests, I found this in
\&\fIt/01sanity.t\fR [7]
.PP
.Vb 1
\&    #!/usr/bin/perl \-w
\&
\&    use Test::More tests => 7;
\&    use Date::ICal;
\&
\&    # Make sure epoch time is being handled sanely.
\&    my $t1 = Date::ICal\->new( epoch => 0 );
\&    is( $t1\->epoch, 0,          "Epoch time of 0" );
\&
\&    # XXX This will only work on unix systems.
\&    is( $t1\->ical, \*(Aq19700101Z\*(Aq, "  epoch to ical" );
\&
\&    is( $t1\->year,  1970,       "  year()"  );
\&    is( $t1\->month, 1,          "  month()" );
\&    is( $t1\->day,   1,          "  day()"   );
\&
\&    # like the tests above, but starting with ical instead of epoch
\&    my $t2 = Date::ICal\->new( ical => \*(Aq19700101Z\*(Aq );
\&    is( $t2\->ical, \*(Aq19700101Z\*(Aq, "Start of epoch in ICal notation" );
\&
\&    is( $t2\->epoch, 0,          "  and back to ICal" );
.Ve
.PP
The beginning of the epoch is different on most non-Unix operating systems [8].
Even though Perl smooths out the differences for the most part, certain ports
do it differently.  MacPerl is one off the top of my head. [9]  Rather than
putting a comment in the test and hoping someone will read the test while
debugging the failure, we can explicitly say it's never going to work and skip
the test.
.PP
.Vb 2
\&    use Test::More tests => 7;
\&    use Date::ICal;
\&
\&    # Make sure epoch time is being handled sanely.
\&    my $t1 = Date::ICal\->new( epoch => 0 );
\&    is( $t1\->epoch, 0,          "Epoch time of 0" );
\&
\&    SKIP: {
\&        skip(\*(Aqepoch to ICal not working on Mac OS\*(Aq, 6)
\&            if $^O eq \*(AqMacOS\*(Aq;
\&
\&        is( $t1\->ical, \*(Aq19700101Z\*(Aq, "  epoch to ical" );
\&
\&        is( $t1\->year,  1970,       "  year()"  );
\&        is( $t1\->month, 1,          "  month()" );
\&        is( $t1\->day,   1,          "  day()"   );
\&
\&        # like the tests above, but starting with ical instead of epoch
\&        my $t2 = Date::ICal\->new( ical => \*(Aq19700101Z\*(Aq );
\&        is( $t2\->ical, \*(Aq19700101Z\*(Aq, "Start of epoch in ICal notation" );
\&
\&        is( $t2\->epoch, 0,          "  and back to ICal" );
\&    }
.Ve
.PP
A little bit of magic happens here.  When running on anything but MacOS, all
the tests run normally.  But when on MacOS, \f(CW\*(C`skip()\*(C'\fR causes the entire
contents of the \s-1SKIP\s0 block to be jumped over.  It never runs.  Instead,
\&\f(CW\*(C`skip()\*(C'\fR prints special output that tells Test::Harness that the tests have
been skipped.
.PP
.Vb 8
\&    1..7
\&    ok 1 \- Epoch time of 0
\&    ok 2 # skip epoch to ICal not working on MacOS
\&    ok 3 # skip epoch to ICal not working on MacOS
\&    ok 4 # skip epoch to ICal not working on MacOS
\&    ok 5 # skip epoch to ICal not working on MacOS
\&    ok 6 # skip epoch to ICal not working on MacOS
\&    ok 7 # skip epoch to ICal not working on MacOS
.Ve
.PP
This means your tests won't fail on MacOS.  This means fewer emails
from MacPerl users telling you about failing tests that you know will
never work.  You've got to be careful with skip tests.  These are for
tests which don't work and \fInever will\fR.  It is not for skipping
genuine bugs (we'll get to that in a moment).
.PP
The tests are wholly and completely skipped. [10]  This will work.
.PP
.Vb 2
\&    SKIP: {
\&        skip("I don\*(Aqt wanna die!");
\&
\&        die, die, die, die, die;
\&    }
.Ve
.SS "Todo tests"
.IX Subsection "Todo tests"
While thumbing through the Date::ICal man page, I came across this:
.PP
.Vb 1
\&   ical
\&
\&       $ical_string = $ical\->ical;
\&
\&   Retrieves, or sets, the date on the object, using any
\&   valid ICal date/time string.
.Ve
.PP
\&\*(L"Retrieves or sets\*(R".  Hmmm. I didn't see a test for using \f(CW\*(C`ical()\*(C'\fR to set
the date in the Date::ICal test suite.  So I wrote one:
.PP
.Vb 2
\&    use Test::More tests => 1;
\&    use Date::ICal;
\&
\&    my $ical = Date::ICal\->new;
\&    $ical\->ical(\*(Aq20201231Z\*(Aq);
\&    is( $ical\->ical, \*(Aq20201231Z\*(Aq,   \*(AqSetting via ical()\*(Aq );
.Ve
.PP
Run that. I saw:
.PP
.Vb 6
\&    1..1
\&    not ok 1 \- Setting via ical()
\&    #     Failed test (\- at line 6)
\&    #          got: \*(Aq20010814T233649Z\*(Aq
\&    #     expected: \*(Aq20201231Z\*(Aq
\&    # Looks like you failed 1 tests of 1.
.Ve
.PP
Whoops!  Looks like it's unimplemented.  Assume you don't have the time to fix
this. [11] Normally, you'd just comment out the test and put a note in a todo
list somewhere.  Instead, explicitly state \*(L"this test will fail\*(R" by wrapping it
in a \f(CW\*(C`TODO\*(C'\fR block:
.PP
.Vb 1
\&    use Test::More tests => 1;
\&
\&    TODO: {
\&        local $TODO = \*(Aqical($ical) not yet implemented\*(Aq;
\&
\&        my $ical = Date::ICal\->new;
\&        $ical\->ical(\*(Aq20201231Z\*(Aq);
\&
\&        is( $ical\->ical, \*(Aq20201231Z\*(Aq,   \*(AqSetting via ical()\*(Aq );
\&    }
.Ve
.PP
Now when you run, it's a little different:
.PP
.Vb 4
\&    1..1
\&    not ok 1 \- Setting via ical() # TODO ical($ical) not yet implemented
\&    #          got: \*(Aq20010822T201551Z\*(Aq
\&    #     expected: \*(Aq20201231Z\*(Aq
.Ve
.PP
Test::More doesn't say \*(L"Looks like you failed 1 tests of 1\*(R".  That '#
\&\s-1TODO\s0' tells Test::Harness \*(L"this is supposed to fail\*(R" and it treats a
failure as a successful test.  You can write tests even before
you've fixed the underlying code.
.PP
If a \s-1TODO\s0 test passes, Test::Harness will report it \*(L"\s-1UNEXPECTEDLY
SUCCEEDED\*(R". \s0 When that happens, remove the \s-1TODO\s0 block with \f(CW\*(C`local $TODO\*(C'\fR and
turn it into a real test.
.SS "Testing with taint mode."
.IX Subsection "Testing with taint mode."
Taint mode is a funny thing.  It's the globalest of all global
features.  Once you turn it on, it affects \fIall\fR code in your program
and \fIall\fR modules used (and all the modules they use).  If a single
piece of code isn't taint clean, the whole thing explodes.  With that
in mind, it's very important to ensure your module works under taint
mode.
.PP
It's very simple to have your tests run under taint mode.  Just throw
a \f(CW\*(C`\-T\*(C'\fR into the \f(CW\*(C`#!\*(C'\fR line.  Test::Harness will read the switches
in \f(CW\*(C`#!\*(C'\fR and use them to run your tests.
.PP
.Vb 1
\&    #!/usr/bin/perl \-Tw
\&
\&    ...test normally here...
.Ve
.PP
When you say \f(CW\*(C`make test\*(C'\fR it will run with taint mode on.
.SH "FOOTNOTES"
.IX Header "FOOTNOTES"
.IP "1." 4
The first number doesn't really mean anything, but it has to be 1.
It's the second number that's important.
.IP "2." 4
For those following along at home, I'm using version 1.31.  It has
some bugs, which is good \*(-- we'll uncover them with our tests.
.IP "3." 4
You can actually take this one step further and test the manual
itself.  Have a look at Test::Inline (formerly Pod::Tests).
.IP "4." 4
Yes, there's a mistake in the test suite.  What!  Me, contrived?
.IP "5." 4
We'll get to testing the contents of lists later.
.IP "6." 4
But what happens if your test program dies halfway through?!  Since we
didn't say how many tests we're going to run, how can we know it
failed?  No problem, Test::More employs some magic to catch that death
and turn the test into a failure, even if every test passed up to that
point.
.IP "7." 4
I cleaned it up a little.
.IP "8." 4
Most Operating Systems record time as the number of seconds since a
certain date.  This date is the beginning of the epoch.  Unix's starts
at midnight January 1st, 1970 \s-1GMT.\s0
.IP "9." 4
MacOS's epoch is midnight January 1st, 1904.  \s-1VMS\s0's is midnight,
November 17th, 1858, but vmsperl emulates the Unix epoch so it's not a
problem.
.IP "10." 4
As long as the code inside the \s-1SKIP\s0 block at least compiles.  Please
don't ask how.  No, it's not a filter.
.IP "11." 4
Do \s-1NOT\s0 be tempted to use \s-1TODO\s0 tests as a way to avoid fixing simple
bugs!
.SH "AUTHORS"
.IX Header "AUTHORS"
Michael G Schwern <schwern@pobox.com> and the perl-qa dancers!
.SH "MAINTAINERS"
.IX Header "MAINTAINERS"
.IP "Chad Granum <exodist@cpan.org>" 4
.IX Item "Chad Granum <exodist@cpan.org>"
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright 2001 by Michael G Schwern <schwern@pobox.com>.
.PP
This documentation is free; you can redistribute it and/or modify it
under the same terms as Perl itself.
.PP
Irrespective of its distribution, all code examples in these files
are hereby placed into the public domain.  You are permitted and
encouraged to use this code in your own programs for fun
or for profit as you see fit.  A simple comment in the code giving
credit would be courteous but is not required.

cmd: