Permalink
Browse files

documenting limitation described in RT/81365

  • Loading branch information...
1 parent 832c913 commit fff40a4452cc71fc5e60fdcd1de784e5ab57c438 @barefootcoder barefootcoder committed Dec 24, 2012
Showing with 21 additions and 0 deletions.
  1. +21 −0 lib/Method/Signatures.pm
View
@@ -1401,6 +1401,27 @@ If you want to write "use Method::Signatures" in a one-liner, do a
C<-MMethod::Signatures> first. This is due to a bug/limitation in
Devel::Declare.
+=head2 Close parends in comments
+
+Because of the way L<Devel::Declare> parses things, a close parend
+inside a comment could throw off the signature parsing. For instance:
+
+ func foo (
+ $foo, # $foo might contain )
+ $bar
+ )
+
+is going to produce a syntax error, because the parend inside the
+comment is perceived as the end of the signature. On the other hand,
+this:
+
+ func foo (
+ $foo, # (this is the $foo parend)
+ $bar
+ )
+
+is fine, because the parends in the comments are balanced.
+
=head2 No source filter
While this module does rely on the black magic of L<Devel::Declare> to

0 comments on commit fff40a4

Please sign in to comment.