/usr/share/perl5/Padre/Help.pm is in padre 1.00+dfsg-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | package Padre::Help;
use 5.008;
use strict;
use warnings;
our $VERSION = '1.00';
# Constructor.
# No need to override this, just override help_init
sub new {
my $self = bless {}, $_[0];
# Initialize
$self->help_init;
return $self;
}
# Initialize help
sub help_init {
warn "help_init, You need to override this to do something useful with help search";
}
# Renders the help topic content into XHTML
sub help_render {
warn "help_render, You need to override this to do something useful with help search";
}
# Returns the help topic list
sub help_list {
warn "help_list, You need to override this to do something useful with help search";
}
1;
__END__
=head1 NAME
Padre::Help - Padre Help Provider API
=head1 DESCRIPTION
The C<Padre::Help> class provides a base class, default implementation
and API documentation for help provision support in L<Padre>.
In order to setup a help system for a document type called C<XYZ> one has to do the following:
Create a module called C<Padre::Help::XYZ> that subclasses the C<Padre::Help> module
and override 3 methods: C<help_init>, C<help_list> and C<help_render>.
In the class representing the Document (C<Padre::Document::XYZ>) one should override the
C<get_help_provider> method and return an object of the help provide module.
In our case it should contain
require Padre::Help::XYZ;
return Padre::Help::XYZ->new;
(TO DO: Maybe it should only return the name of the module)
The C<help_init> method is called by the new method of C<Padre::Help> once for every
document of C<XYZ> kind. (TO DO: maybe it should be only once for every document type, and not
once for every document of that type).
C<help_list> should return a reference to an array holding the possible strings the system can
provide help for.
C<help_render> is called by one of the keywords, it should return the HTML to be displayed
as help and another string which is the location of the help. Usually a path to a file
that will be used in the title of the window.
=cut
# Copyright 2008-2013 The Padre development team as listed in Padre.pm.
# LICENSE
# This program is free software; you can redistribute it and/or
# modify it under the same terms as Perl 5 itself.
|