NAME

       Prima::HelpViewer - the built-in pod file browser

USAGE

       The module presents two packages, "Prima::HelpViewer" and "Prima::PodViewWindow". Their
       sole purpose is to serve as a mediator between "Prima::PodView" package, the toolkit help
       interface and the user.  "Prima::PodViewWindow" includes all the user functionality,
       including ( but not limited to :) text search, color and font setup, printing etc.
       "Prima::HelpViewer" provides two methods - "open" and "close", used by
       "Prima::Application" for help viewer invocation.

Help

       The browser can be used to view and print POD ( plain old documentation ) files. See the
       command overview below for more detailed description:

       File
           Open
               Presents a file selection dialog, when the user can select a file to browse in the
               viewer. The file must contain POD content, otherwise a warning is displayed.

           Goto
               Asks for a manpage, that is searched in PATH and the installation directories.

           New window
               Opens the new viewer window with the same context.

           Run Commands in this group call external processes

               p-class
                   p-class is Prima utility for displaying the widget class hierachies.  The
                   command asks for Prima class to display the hierachy information for.

           Print
               Provides a dialog, when the user can select the appropriate printer device and its
               options.

               Prints the current topic to the selected printer.

               If "Full text view" menu item is checked, prints the whole manpage.

           Close window
               Closes the window.

           Close all windows
               Closes all help viewer windows.

       View
           Increase font
               Increases the currently selected font by 2 points.

           Decrease font
               Decreases the currently selected font by 2 points.

           Full text view
               If checked, the whole manpage is displayed. Otherwise, its content is presented as
               a set of topic, and only one topic is displayed.

           Find
               Presents a find dialog, where the user can select the text to search and the
               search options - the search direction, scope, and others.

           Find again
               Starts search for the text, entered in the last find dialog, with the same search
               options.

           Fast find
               The following commands provide a simple vi-style text search functionality -
               character keys ?,/,n,N bound to the commands below:

               Forward
                   Presents an input line where a text can be entered; the text search is
                   performed parallel to the input.

               Backward
                   Same as Forward option, except that the serach direction is backwards.

               Repeat forward
                   Repeat the search in the same direction as the initial search was being
                   invoked.

               Repeat backward
                   Repeat the search in the reverse direction as the initial search was being
                   invoked.

           Setup
               Presents a setup dialog, where the user can select appropriate fonts and colors.

       Go
           Back
               Displays the previously visited manpage ( or topic )

           Forward
               Displays the previously visited manpage ( or topic ), that was left via Back
               command.

           Up  Displays the upper level topic within a manpage.

           Previous
               Moves to the previous topic within a manpage.

           Next
               Moves to the next topic within a manpage.

       Help
           About
               Displays the information about the help viewer.

           Help
               Displays the information about the usage of the help viewer

AUTHOR

       Dmitry Karasik, <dmitry@karasik.eu.org>.

COPYRIGHT

       This program is distributed under the BSD License.