NAME

Parrot::BuildUtil - Utilities for building Parrot

DESCRIPTION

This package holds pre-configure time subroutines, which are not exported and should not require Parrot::Config. Each must be requested by using a fully qualified name.

SUBROUTINES

parrot_version()

Determines the current version number for Parrot from the VERSION file and returns it in a context-appropriate manner.

    $parrot_version = Parrot::BuildUtil::parrot_version();
    # $parrot_version is '0.4.11'

    @parrot_version = Parrot::BuildUtil::parrot_version();
    # @parrot_version is (0, 4, 11)

slurp_file($filename)

Slurps up the filename and returns the content as one string. While doing so, it converts all DOS-style line endings to newlines.

generated_file_header($filename, $style)

Returns a comment to mark a generated file and detail how it was created. $filename is the name of the file on which the generated file is based, $style is the style of comment--'perl' and 'c' are permitted, other values produce an error.

get_bc_version()

Return an array of ($bc_major, $bc_minor) from PBC_COMPAT. This is used in the native_pbc tests.

See also tools/dev/pbc_header.pl and tools/build/pbcversion_h.pl.