My personal favorite is Smart::Comments.
use strict;
use warnings;
# Enable special comments for debugging and reporting:
use Smart::Comments;
my $data_structure = {
a => [ 1, 2, 3 ],
b => [
{ X => 1, Y => 2 },
{
X => [ 1, 2, 3 ],
Y => [ 4, 5, 6 ],
Z => [ 7, 8, 9 ]
},
],
};
# the following is a "smart comment" which causes a dump of the expres
+sion, using Data::Dumper:
### $data_structure
Produces this output:
### $data_structure: {
### a => [
### 1,
### 2,
### 3
### ],
### b => [
### {
### X => 1,
### Y => 2
### },
### {
### X => [
### 1,
### 2,
### 3
### ],
### Y => [
### 4,
### 5,
### 6
### ],
### Z => [
### 7,
### 8,
### 9
### ]
### }
### ]
### }
Smart::Comments does much, much more than this, too.
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.