VERSION

version 0.004

SYNOPSIS

    # either
    use syntax 'foo';

    # or
    use syntax foo => { ... };

    # or
    use syntax qw( foo bar ), baz => { ... };

DESCRIPTION

This module activates community provided syntax extensions to Perl. You pass it a feature name, and optionally a scalar with arguments, and the dispatching system will load and install the extension in your package.

The import arguments are parsed with Data::OptList. There are no standardised options. Please consult the documentation for the specific syntax feature to find out about possible configuration options.

The passed in feature names are simply transformed: \*(C`function\*(C' becomes Syntax::Feature::Function and \*(C`foo_bar\*(C' would become \*(C`Syntax::Feature::FooBar\*(C'.

METHODS

import

syntax->import( @spec );

This method will dispatch the syntax extension setup to the specified feature handlers for the calling package.

import_into

syntax->import_into( $into, @spec );

Same as \*(L"import\*(R", but performs the setup in $into instead of the calling package.

unimport

syntax->unimport( @features );

This method will trigger uninstallations of the @features from the calling package.

unimport_from

syntax->unimport_from( $from, @features );

Same as \*(L"unimport\*(R", but will uninstall the @features from $from.

RECOMMENDED FEATURES

  • Syntax::Feature::Function Activates functions with parameter signatures.

RELATED TO syntax…

Syntax::Feature::Function, Devel::Declare

BUGS

Please report any bugs or feature requests to [email protected] or through the web interface at: http://rt.cpan.org/Public/Dist/Display.html?Name=syntax

AUTHOR

Robert 'phaylon' Sedlacek <[email protected]>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Robert 'phaylon' Sedlacek.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.