The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
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.