NAME

feature::qw_comments - DEPRECATED - Pragma to allow comments in qw()

DEPRECATED

Use Syntax::Feature::QwComments instead. It uses a safer mechanism to provide the feature, and this module will eventually be deleted to free up the feature:: namespace for Perl itself.

VERSION

Version 1.10.1

SYNOPSIS

    use feature::qw_comments;
    
    @a = qw(
       foo  # Now with comments!
       bar
    );

DESCRIPTION

Allows comments inside of qw().

qw() should work identically with and without this pragma in all other respects except one: In addition to escaping delimiters and itself, \ will escape #.

use feature::qw_comments;

Allow comments inside of qw() until the end of the current lexical scope.

no feature::qw_comments;

The standard qw() syntax is restored until the end of the current lexical scope.

WARNING: Uses Experimental Features

This module relies on the experimental keyword plugin and lexer interface features which "may change or be removed without notice".

WARNING: Re-implements parts of Perl

This feature is implemented by completely replacing the parser/compiler's handling of qw() when the pragma is in effect. There may be discrepencies in how certain edge cases are handled, and new discrepencies may surface as Perl changes over time. Please contact me or file a bug report if you encounter any discrepencies.

BUGS

Please report any bugs or feature requests to bug-feature-qw_comments at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=feature-qw_comments. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc feature::qw_comments

You can also look for information at:

• Search CPAN

  http://search.cpan.org/dist/feature-qw_comments

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=feature-qw_comments

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/feature-qw_comments

• CPAN Ratings

  http://cpanratings.perl.org/d/feature-qw_comments

AUTHOR

Eric Brine, <ikegami@adaelis.com>

COPYRIGHT & LICENSE

No rights reserved.

The author has dedicated the work to the Commons by waiving all of his or her rights to the work worldwide under copyright law and all related or neighboring legal rights he or she had in the work, to the extent allowable by law.

Works under CC0 do not require attribution. When citing the work, you should not imply endorsement by the author.