@alias can refer to a method in any package (using Standard#notation), but will most commonly be used to refer to another method in the same package.
This fixes a bug where comments from inside the previous method body were being considered docstrings.
All the way across the sky.
This allows us to leverage the syntax file to do better manipulation of multiple comment lines.
Now it won't try to coalesce multiple packages together quite as often.
Hopefully, there's now enough information present to adequately parse Perl properly.
This will be automatically picked up on by syntax highlighting routines for the class' docstring, so it actually is important that we set it.
should now properly appear!
… A better fix would be to make sure the Ruby parser is never used, but that's a longer term issue.
… for automatically determining method scope from the name of the initial parameter. Parameter names are found by the first occurance of the pattern `my \((.*)\) = @_;`, including in a comment. Scope can be overridden with the @scope tag.