GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TK::POD_USAGE (3)

.ds Aq ’

NAME

Tk::Pod_usage - How to use the perl/Tk Pod browser widget

CONTENTS

DESCRIPTION

To navigate through the documentation one could use

    Hyperlinks

A <B>clickB> on a hyperlink display the corresponding Pod documentation (if there is any) in the same window. An URL will be displayed in a web browser. A man page will be displayed in a man viewer (if one is available).

With <Button-2> the documentation is loaded into a new window (<Shift-Button-1> works also for those with only a 2 button mouse).

    Selection

A <B>double clickB> tries to load the documentation for the selected word in the same window.

If the Shift key is simultaneously pressed a new browser window is opened.

    Key bindings

The Tk::Pod::Text widget is based on the Tk::More widget inheriting its key bindings.

    Search

Pressing <Key-/> lets you search in the displayed documentation.

    Section Menu

The Section Menu

The ’Section’ menu allows one to directly jump to the start of a section in the documentation.

    Action Menu

If you press the right mouse button you get a popup menu that allows:
o Back in history of displayed documentation
o Forward in history of displayed documentation
o Reload the documentation
o Edit Pod Start editor with source of the displayed document.

The used editor is selected by the first definition of the environment variables TKPODEDITOR, XEDITOR, VISUAL, EDITOR or as default /usr/bin/vi. If no terminal is available (or on Windows platforms), the ptked editor (bundled with Perl/Tk) will be used instead.

See also the menu entries ’File’ -> ’Edit’ and ’File’ -> ’Edit with ptked’.

o Search fulltext Full text search of the Pod in the perl library directories. (Note: to use it one has to install the perlindex distribution and build an index for the perl documentation, see Text::English)
The remaining menu entries are the same as in normal Text widgets.

    Tree view

You can toggle the tree view of all installed modules on or off with the ’View’ -> ’Pod Tree’ menu entry. The tree view is organized in three sections: Perl language (general documentation about Perl), Pragmata, and Modules. The labels in the tree are colored, where green means standard module which comes with the Perl core distribution, red means locally installed module, probably from CPAN, and grey means no module available, look at the subtree.

The tree data is cached in a temporary directory on a per-perl-version and per-user basis. A reload can be forced with the <B>ReloadB> entry in the action menu of the tree view. With the <B>SearchB> entry a search in the tree can be performed. The <B>Show modules at CPANB> entry is highly experimental - you can download, extract and look at the documentation of all CPAN modules.

SEE ALSO

tkpod, perlpod, pod2man, pod2text, pod2html, Tk::Pod, Tk::Pod::Text, Tk::Pod::Tree, Tk::More, Text::English.

KEYWORDS

pod, browser, tk, hypertext

AUTHOR

Achim Bohnet <ach@mpe.mpg.de>

Current maintainer is Slaven Rezic <slaven@rezic.de>

Copyright (c) 1997-1998 Achim Bohnet. All rights reserved. This documentation is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 POD_USAGE (3) 2012-11-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.