From 7b3eb8ab44f855bf38291032587867db38e118fe Mon Sep 17 00:00:00 2001
From: Jesse Luehrs <doy@tozt.net>
Date: Wed, 17 Jul 2013 14:41:53 -0400
Subject: document the generator side of things

---
 lib/Spreadsheet/Template/Generator/Parser.pm | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

(limited to 'lib/Spreadsheet/Template/Generator/Parser.pm')

diff --git a/lib/Spreadsheet/Template/Generator/Parser.pm b/lib/Spreadsheet/Template/Generator/Parser.pm
index d1d7735..ec22f9f 100644
--- a/lib/Spreadsheet/Template/Generator/Parser.pm
+++ b/lib/Spreadsheet/Template/Generator/Parser.pm
@@ -4,6 +4,32 @@ use Moose::Role;
 
 requires 'parse';
 
+=head1 SYNOPSIS
+
+  package MyParser;
+  use Moose;
+
+  with 'Spreadsheet::Template::Generator::Parser';
+
+  sub parse {
+      # ...
+  }
+
+=head1 DESCRIPTION
+
+This role should be consumed by any class which will be used as the
+C<parser_class> in a L<Spreadsheet::Template::Generator> instance.
+
+=cut
+
+=method parse($filename) (required)
+
+This method should parse the spreadsheet specified by C<$filename> and return
+the intermediate data structure containing all of the data in that spreadsheet.
+The intermediate data format is documented in L<Spreadsheet::Template>.
+
+=cut
+
 no Moose::Role;
 
 1;
-- 
cgit v1.2.3-54-g00ecf