NAME

Perl::ToPerl6::TransformerSummary - Descriptions of the Transformer modules included with Perl::ToPerl6 itself.

DESCRIPTION

The following Transformer modules are distributed with Perl::ToPerl6. (There are additional Transformers that can be found in add-on distributions.) Each Transformer is listed here with its default necessity. If you don't agree with the default necessity, you can change it in your .perlmogrifyrc file (try perlmogrify --profile-proto for a starting version). See the documentation of each module for its specific details.

POLICIES

END_HEADER

my $format = <<'END_TRANSFORMER'; =head2 %s

%s [Default necessity %d]

END_TRANSFORMER

eval { foreach my $transformer (@transformers) { my $module_abstract = $transformer->get_raw_abstract();

    printf
        {$pod_file}
        $format,
        $transformer->get_short_name(),
        $transformer->get_long_name(),
        $module_abstract || '',
        $transformer->default_necessity();
}

1;
}
or do {
    # Yes, an assignment and not equality test.
    if (my $exception = $EVAL_ERROR) {
        if ( ref $exception ) {
            $exception->show_trace(1);
        }

        print {*STDERR} "$exception\n";
    }
    else {
        print {*STDERR} "Failed printing abstracts for an unknown reason.\n";
    }

    exit 1;
};

print {$pod_file} <<'END_FOOTER';

VERSION

This is part of Perl::ToPerl6 version 0.040

AUTHOR

Jeffrey Goff <drforr@pobox.com>

AUTHOR EMERITUS

Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

COPYRIGHT

Copyright (c) 2015 Jeffrey Goff, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of this license can be found in the LICENSE file included with this module.

NAME

Perl::ToPerl6::TransformerSummaryGenerator - Create TransformerSummary.pod file.

DESCRIPTION

This module contains subroutines for generating the Perl::ToPerl6::TransformerSummary POD file. This file contains a brief summary of all the Transformers that ship with Perl::ToPerl6. These summaries are extracted from the NAME section of the POD for each Transformer module.

This library should be used at author-time to generate the TransformerSummary.pod file before releasing a new distribution. See also the transformersummary action in Perl::ToPerl6::Module::Build.

IMPORTABLE SUBROUTINES

generate_transformer_summary()

Generates the TransformerSummary.pod file which contains a brief summary of all the Transformers in this distro. Returns the relative path this file. Unlike most of the other subroutines here, this subroutine should be used when creating a distribution, not when building or installing an existing distribution.

AUTHOR

Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

COPYRIGHT

Copyright (c) 2009-2011 Imaginative Software Systems. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of this license can be found in the LICENSE file included with this module.