NAME
CPANPLUS::Shell::Wx::PODReader - GUI POD Reader
SYNOPSIS
use Wx qw[:allclasses];
use CPANPLUS::Shell::Wx::PODReader;
local *Wx::App::OnInit = sub{1};
my $app = Wx::App->new();
Wx::InitAllImageHandlers();
my $frame_podreader = CPANPLUS::Shell::Wx::PODReader::Frame->new();
$app->SetTopWindow($frame_podreader);
$frame_podreader->Show(1);
$app->MainLoop();
.....
$frame_podreader->Search($module_name,$where)
also
$podReader=CPANPLUS::Shell::Wx::PODReader::Embed->new($notebook);
$notebook->AddPage($podReader,"POD Reader");
DESCRIPTION
There are two types of PODReader: a windowed version, CPANPLUS::Shell::Wx::PODReader::Frame (a Wx::Frame), and a version which can be embedded within other Wx::Windows, CPANPLUS::Shell::Wx::PODReader::Emed (a Wx::Panel). They both have only one method, Search().
GUI DESCRIPTION
The GUI contains 3 basic entities: a Search Bar, the Status Text, and the Tabs.
Search Bar
The search bar contains a Find button, which enacts the Search() facility, a ComboBox, which is where you can type in the text to search for, and the type box, where you can select where you want to search for the documentation. It looks like this: Find $text in $where. The search box displays the previous 10 successful searches between sessions, in $HOME/.wxPODReader/searches.txt. You can type in the location of a file in this box to see the POD for that file.
Status Text
Some status information is displayed here.
Tabs
There are 4 tabs available: "Builtin Methods", "FAQ", "Module" and "Source". They correspond to the values in the 'type' dropdown list. Only the relevant tabs are displayed per search.
METHODS
$podreader->Search($text,$where)
This method searches for pod documentation, using the perldoc command.
- $text
-
The text to search for. Can be anything.
- $where
-
The place to look for documentation. Can be any one of "All", "Builtin Methods", "FAQ", "Modules" or "Sources". The default is 'All', which searches through all documentation, and displays only the tabs that contain the result. For example, a search for CPANPLUS will only show the Source and Module tab.
SEE ALSO
CPAN, CPANPLUS, CPANPLUS::Shell::Tk
website: http://wxcpan.googlecode.com mailing-list: wxcpan@googlegroups.com mailing-list website: http://groups.google.com/group/wxcpan
AUTHOR
Skaman Sam Tyler, <skamansam@gmail.com> website: http://rbe.homeip.net
COPYRIGHT AND LICENSE
Copyright (C) 2008 by Skaman Sam Tyler
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.