X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FLaTeX%2FTikZ%2FMod.pm;h=46c61f734824e09d1852fec1ae630d026cfc5cd9;hb=a27d2f20c230552d8207b08c13d6d7f73408261b;hp=dbee13dbeef4db32039a8cdde8de9661b120c311;hpb=e8f0879ade07eed4f58cd52c0771f4e1ecc90b09;p=perl%2Fmodules%2FLaTeX-TikZ.git

diff --git a/lib/LaTeX/TikZ/Mod.pm b/lib/LaTeX/TikZ/Mod.pm
index dbee13d..46c61f7 100644
--- a/lib/LaTeX/TikZ/Mod.pm
+++ b/lib/LaTeX/TikZ/Mod.pm
@@ -9,25 +9,71 @@ 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
+
+This role should be consumed by all the modifier classes.
+
+=cut
 
 use Any::Moose 'Role';
 use Any::Moose 'Util::TypeConstraints';
 
-requires qw(
+=head1 METHODS
+
+These methods are required by the interface :
+
+=over 4
+
+=item *
+
+C<tag>
+
+Returns an identifier for the mod object.
+It is used to gather mods together when calling C<covers> on them.
+
+=item *
+
+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 $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 $formatter>
+
+Returns the TikZ code that activates the current mod as a string formatted by the L<LaTeX::TikZ::Formatter> object C<$formatter>.
+
+=back
+
+=cut
+
+requires qw<
  tag
- cover
+ covers
  declare
  apply
-);
+>;
 
 coerce 'LaTeX::TikZ::Mod'
     => from 'Str'
-    => via { LaTeX::TikZ::Mod::Raw->new($_) };
+    => via { LaTeX::TikZ::Mod::Raw->new(content => $_) };
+
+=head1 SEE ALSO
+
+L<LaTeX::TikZ>.
 
 =head1 AUTHOR