NAME
    ProjectBuilder::Filter, part of the project-builder.org

DESCRIPTION
    This module provides filtering functions suitable for pbinit calls.

    pb_get_filters
        This function gets all filters to apply. They're cumulative from the
        less specific to the most specific.

        Suffix of those filters is .yml. Filter all.yml applies to whatever
        distribution. The pbfilter directory may be global under pbconf or per
        package, for overloading values. Then in order filters are loaded for
        distribution type, distribution family, distribution name,
        distribution name-version.

        The first parameter is the package name. The second parameter is OS
        hash

        The function returns a pointer on a hash of filters.

    pb_filter_file
        This function applies all filters to files.

        It takes 4 parameters.

        The first parameter is the file to filter. The second parameter is the
        pointer on the hash of filters. If undefined no filtering will occur.
        The third parameter is the destination file after filtering. The
        fourth parameter is the pointer on the hash of variables to filter
        (tag, ver, ...)

    pb_filter_file_inplace
        This function applies all filters to a file in place.

        It takes 3 parameters.

        The first parameter is the pointer on the hash of filters. The second
        parameter is the destination file after filtering. The third parameter
        is the pointer on the hash of variables to filter (tag, ver, ...)

    pb_filter_var_print
        This function prints every variable expanded in order to help debug
        stacking issues with conf files. If a VM/VE/RM is given restrict
        display to this distribution. If parameters are passed, restrict again
        the display to that package only.

WEB SITES
    The main Web site of the project is available at
    <http://www.project-builder.org/>. Bug reports should be filled using the
    trac instance of the project at <http://trac.project-builder.org/>.

USER MAILING LIST
    None exists for the moment.

AUTHORS
    The Project-Builder.org team <http://trac.project-builder.org/> lead by
    Bruno Cornec <mailto:bruno@project-builder.org>.

COPYRIGHT
    Project-Builder.org is distributed under the GPL v2.0 license described in
    the file "COPYING" included with the distribution.