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::FINDPODS (3)

.ds Aq ’

NAME

Tk::Pod::FindPods - find Pods installed on the current system

CONTENTS

SYNOPSIS



    use Tk::Pod::FindPods;

    my $o = Tk::Pod::FindPods->new;
    $pods = $o->pod_find(-categorized => 1, -usecache => 1);



DESCRIPTION

    pod_find

The <B>pod_findB> method scans the current system for available Pod documentation. The keys of the returned hash reference are the names of the modules or Pods (:: substituted by / --- this makes it easier for Tk::Pod::Tree, as the separator may only be of one character). The values are the corresponding filenames.

If -categorized is specified, then the returned hash has an extra level with four categories: <B>perlB> (for core language documentation), <B>pragmaB> (for pragma documentation like var or strict), <B>modB> (core or CPAN modules), and <B>scriptB> (perl scripts with embedded Pod documentation). Otherwise, -category may be set to force the Pods into a category.

By default, @INC is scanned for Pods. This can be overwritten by the -directories option (specify as an array reference).

If -usecache is specified, then the list of Pods is cached (see cache directory). -usecache is disabled if -categorized is not set or -directories is set.

    WriteCache

Write the Pod cache. The cache is written to the cache directory. The file name is constructed from the perl version, operation system and user id.

LoadCache()

Load the Pod cache, if possible.

    Cache directory

By default the cache file is written to the directory ~/.tkpod_cache (Unix systems), or the data directory as determined by File::HomeDir (Windows, MacOSX). If everything fails, then the temporary directory (/tmp or the OS equivalent) is used.

If necessary, then the last path component will be created (that is, .tkpod_cache will be created if the directory does not exist).

To use another cache directory set the environment variable TKPODCACHE.

ENVIRONMENT

TKPODCACHE Use a custom cache file instead of a file in the cache directory. The following placeholders are recognized:
%v The perl version.
%o The OS (technically correct: the archname, which can include tokens like 64int or thread).
%u The user id.

Example for using /some/other/directory for the cache file location:



        TKPODCACHE=/some/other/directory/pods_%v_%o_%u; export TKPODCACHE



or



        setenv TKPODCACHE /some/other/directory/pods_%v_%o_%u



depending on your shell (sh-like or csh-like).

SEE ALSO

Tk::Tree.

AUTHOR

Slaven ReziX <slaven@rezic.de>

Copyright (c) 2001,2003,2004,2005,2007,2009 Slaven ReziX. All rights reserved. This program 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::FINDPODS (3) 2012-11-16

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