From de7b145ac3cb9fff9bcbff9e1832f400ca905d88 Mon Sep 17 00:00:00 2001 From: "Bradley M. Kuhn" Date: Wed, 9 Dec 2015 18:37:26 -0800 Subject: [PATCH] Some documentation for existing methods. --- Supporters/lib/Supporters.pm | 39 ++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/Supporters/lib/Supporters.pm b/Supporters/lib/Supporters.pm index a099fba..8137c35 100644 --- a/Supporters/lib/Supporters.pm +++ b/Supporters/lib/Supporters.pm @@ -28,6 +28,29 @@ our @EXPORT = qw( our $VERSION = '0.02'; ###################################################################### + +=begin new + +Create new Supporters object. + +Arguments: + +=over + +=item $dbh + + Scalar references for the database handle, already opened and pointing to + the right database. + +=item $ledgerCmd + + Scalar string that contains the main ledger command (without arguments) to + run for looking up Supporter donation data. + +=back + +=cut + sub new ($$) { my $package = shift; my($dbh, $ledgerCmd) = @_; @@ -36,10 +59,26 @@ sub new ($$) { $package); } ###################################################################### + +=begin dbh + +Accessor method, returns the database handle currently used by this +Supporters object. + +=cut + sub dbh ($) { return $_[0]->{dbh}; } ###################################################################### + +=begin ledgerCmd + +Accessor method, returns the ledger command currently used by this Supporters +object. + +=cut + sub ledgerCmd ($) { return $_[0]->{ledgerCmd}; }