test: Move test_data_file() to test.h
[dpkg.git] / scripts / Dpkg / Build / Info.pm
blob0d4641a52dd325ebf631ea03461d6c8d1f71b614
1 # Copyright © 2016-2022 Guillem Jover <guillem@debian.org>
3 # This program is free software; you can redistribute it and/or modify
4 # it under the terms of the GNU General Public License as published by
5 # the Free Software Foundation; either version 2 of the License, or
6 # (at your option) any later version.
8 # This program is distributed in the hope that it will be useful,
9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 # GNU General Public License for more details.
13 # You should have received a copy of the GNU General Public License
14 # along with this program. If not, see <https://www.gnu.org/licenses/>.
16 =encoding utf8
18 =head1 NAME
20 Dpkg::Build::Info - handle build information
22 =head1 DESCRIPTION
24 The Dpkg::Build::Info module provides functions to handle the build
25 information.
27 This module is deprecated, use Dpkg::BuildInfo instead.
29 =cut
31 package Dpkg::Build::Info 1.02;
33 use strict;
34 use warnings;
36 our @EXPORT_OK = qw(
37 get_build_env_whitelist
38 get_build_env_allowed
41 use Exporter qw(import);
43 use Dpkg::BuildInfo;
45 =head1 FUNCTIONS
47 =over 4
49 =item @envvars = get_build_env_allowed()
51 Get an array with the allowed list of environment variables that can affect
52 the build, but are still not privacy revealing.
54 This is a deprecated alias for Dpkg::BuildInfo::get_build_env_allowed().
56 =cut
58 sub get_build_env_allowed {
59 #warnings::warnif('deprecated',
60 # 'Dpkg::Build::Info::get_build_env_allowed() is deprecated, ' .
61 # 'use Dpkg::BuildInfo::get_build_env_allowed() instead');
62 return Dpkg::BuildInfo::get_build_env_allowed();
65 =item @envvars = get_build_env_whitelist()
67 This is a deprecated alias for Dpkg::BuildInfo::get_build_env_allowed().
69 =cut
71 sub get_build_env_whitelist {
72 warnings::warnif('deprecated',
73 'Dpkg::Build::Info::get_build_env_whitelist() is deprecated, ' .
74 'use Dpkg::BuildInfo::get_build_env_allowed() instead');
75 return Dpkg::BuildInfo::get_build_env_allowed();
78 =back
80 =head1 CHANGES
82 =head2 Version 1.02 (dpkg 1.21.14)
84 Deprecate module: replaced by Dpkg::BuildInfo.
86 =head2 Version 1.01 (dpkg 1.20.1)
88 New function: get_build_env_allowed().
90 Deprecated function: get_build_env_whitelist().
92 =head2 Version 1.00 (dpkg 1.18.14)
94 Mark the module as public.
96 =cut