This is 0.02

[perl/modules/LaTeX-TikZ.git] / lib / LaTeX / TikZ / Mod.pm

diff --git a/lib/LaTeX/TikZ/Mod.pm b/lib/LaTeX/TikZ/Mod.pm
index 87cec117c14162236baeeff5f8dbf6ca6811f994..8095e44192727dc0568c4f320f4075af2cbca4a4 100644 (file)
--- a/lib/LaTeX/TikZ/Mod.pm
+++ b/lib/LaTeX/TikZ/Mod.pm
@@ -9,11 +9,11 @@ LaTeX::TikZ::Mod - Base role for LaTeX::TikZ modifiers.
 
 =head1 VERSION
 
-Version 0.01
+Version 0.02
 
 =cut
 
-our $VERSION = '0.01';
+our $VERSION = '0.02';
 
 =head1 DESCRIPTION
 
@@ -34,17 +34,27 @@ These methods are required by the interface :
 
 C<tag>
 
+Returns an identifier for the mod object.
+It is used to gather mods together when calling C<covers> on them.
+
 =item *
 
-C<cover>
+C<covers $mod>
+
+Returns true if and only if the effects of the mod C<$mod> are already ensured by the current mod object, in which case no actual TikZ code will be emitted for C<$mod>.
+Both mod objects are guaranteed to have the same C<tag>.
 
 =item *
 
-C<declare>
+C<declare $formatter>
+
+Returns an array reference of TikZ code lines required to declare this mod before using it, formatted by the L<LaTeX::TikZ::Formatter> object C<$formatter> ; or C<undef> if no declarations are needed for this mod.
 
 =item *
 
-C<apply>
+C<apply $formatter>
+
+Returns the TikZ code that activates the current mod as a string formatted by the L<LaTeX::TikZ::Formatter> object C<$formatter>.
 
 =back
 
@@ -52,7 +62,7 @@ C<apply>
 
 requires qw(
  tag
- cover
+ covers
  declare
  apply
 );
@@ -61,6 +71,10 @@ coerce 'LaTeX::TikZ::Mod'
     => from 'Str'
     => via { LaTeX::TikZ::Mod::Raw->new(content => $_) };
 
+=head1 SEE ALSO
+
+L<LaTeX::TikZ>.
+
 =head1 AUTHOR
 
 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.