Devel-Comments version 1.1.4
"I get the feeling that the computer just skips over all the comments."
-- a grad student
Devel::Comments is a source filter for your Perl code, intended to be used
only during development. Specially-formatted 'smart' comments are replaced by
executable code to dump variables to screen or to file, display loop
progress bars, or enforce conditions. These smart comments can all be
disabled at once by commenting out the 'use Devel::Comments' line, whereupon
they return to being simple, dumb comments. Your debugging code can remain in
place, guaranteed harmless, ready for the next development cycle.
Devel::Comments is a fork of Smart::Comments; the intention is to add new
features without breaking backward compatibility. Version 1.1.2 implements the
'any filehandle' feature, allowing smart output to go to any filehandle
opened for writing. You may instead pass in a filename, which DC will open for
you. Future plans include extended calling syntax, numerical level enabling,
improved progress bars, dump method callback, and execution of arbitrary code.
Bugs raised against Smart::Comments 1.0.4 will be fixed in DC.
INSTALLATION
To install this module, run the following commands:
perl Build.PL
./Build
./Build test
./Build install
DEPENDENCIES
# 'requires'
perl 5.8.0
version 0.77
Text::Balanced 2.0
Data::Dumper
Filter::Simple 0.80
List::Util
# 'build_requires'; only for 'Build test'
Test::More
# 'recommends'; only for full test suite
perl 5.10.1
Test::More 0.94
Test::Deep
Try::Tiny
IO::Capture::Stdout::Extended
IO::Capture::Stderr::Extended
IO::Capture::Sayfix
IO::Capture::Tellfix
COPYRIGHT AND LICENCE
Copyright (C) 2010, 2011 Xiong Changnian
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.