"be consistent" | |
PerlMonks |
Re: Annotations for Perlby RonW (Parson) |
on Jun 02, 2015 at 18:14 UTC ( [id://1128833]=note: print w/replies, xml ) | Need Help?? |
As it happens, the @ notation is used by several code documentation "generators". A somewhat popular one is Doxygen. You might want to look at its notations for the purpose of making your usage compatable. Also, as I recently discovered, the Perl6 project has extended POD syntax to include similar comments as code annotations, using #| or #= to introduce these annotations. However, the markup in these comments is "just" more POD. However, it validates the concept you are proposing. There is a module that partially implements Perl6 POD syntax, but it appears to not implement #| and #= comments. If this is the case, I am considering enhancing it. FWIW, I am working on a Doxygen to POD filter. An early version is Convert Doxygen to POD. Update: Fixed a grammar error.
In Section
Seekers of Perl Wisdom
|
|