This file is indexed.

/usr/bin/dh_phppear is in pkg-php-tools 1.11.

This file is owned by root:root, with mode 0o755.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
#!/usr/bin/perl -w

=head1 NAME

dh_phppear - calculates PHP PEAR dependencies

=head1 SYNOPSIS

B<dh_phppear> [S<I<debhelper options>>]

=head1 DESCRIPTION

B<dh_phppear> is a debhelper program that is responsible for generating
the B<${phppear:*}> substitutions and adding them to substvars files.

The program will look at F<package.xml> (or F<package2.xml>) in your package,
and will use this information to generate:

=over 2

=item *

B<${phppear:summary}>, B<${phppear:description}> and B<${phppear:channel}>

=item *

B<${phppear:Debian-Depends}>, B<${phppear:Debian-Recommends}> and B<${phppear:Debian-Breaks}>

=back

The program will look at F<channel.xml> in your package,
and will use this information to generate:

=over 2

=item *

B<${phppear:channel-name}>, B<${phppear:channel-summary}> and B<${phppear:channel-alias}>

=item *

B<${phppear:channel-common-description}>

=back

Those variables will be substituted into your package's F<control>
file wherever you place the token B<${phppear:*}>.

=head1 FILES

=over 4

=item debian/pkg-php-tools-overrides

Package that don't want to follow automatic PEAR package name to Debian package
name conversion can override the conversion by creating this file.

It can be installed in B</usr/share/pkg-php-tools/overrides/>I<src:package>.

This feature requires pkg-php-tools (>= 1~).

The format is a set of lines, with each line having the following fields:

=over 6

=item I<channel_url>

The channel URL as found in package.xml (example: I<pear.phpunit.de>).

=item I<pear_package_name>

The PEAR package name (example: I<phpunit>).

=item I<debian_package_name>

The resulting Debian package name (example: I<phpunit>).

Use I<builtin> if the package is compiled from the php5 sourcepackage.

Use I<none> if the PEAR package can't be simply translated to Debian name.

=back

=back

=cut

use strict;
use Config;
use Debian::Debhelper::Dh_Lib;
use Text::Wrap;


sub _shell_exec {
	my $command=shift;
	my $output = `$command`;
	if ($? == -1) {
		error("$command failed to execute: $!");
	}
	elsif ($? & 127) {
		error("$command died with signal ".($? & 127));
	}
	elsif ($? != 0) {
		error("$command returned exit code ".($? >> 8));
	}
	return $output;
}

init();

foreach my $package (@{$dh{DOPACKAGES}}) {
	if (-e "package.xml" || -e "package2.xml") {
		my $deps = _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d debian_deps .');
		for (split /^/, $deps) {
			/^(\w+):\s*(.*)$/;
			addsubstvar($package, "phppear:Debian-".$1, $2);
		}
		my $summary = _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d summary .');
		$summary =~ s/\.$//;
		addsubstvar($package, "phppear:summary", $summary);
		my $description = _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d description .');
		$description =~ s/^\s*//mg;
		$description =~ s/^\*/ */mg;
		local($Text::Wrap::separator) = '${Newline}';
		# Wrap and replace empty lines with a dot
		$description = join('${Newline}.${Newline}', split('${Newline}${Newline}', wrap("", "", $description)));
		$description =~ s/\t+/ /g;
		addsubstvar($package, "phppear:description", $description);
		addsubstvar($package, "phppear:channel", _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d channel .'));
	}
	if (-e "channel.xml") {
		addsubstvar($package, "phppear:channel-name", _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d channel_name channel.xml'));
		addsubstvar($package, "phppear:channel-summary", _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d channel_summary channel.xml'));
		my $alias = _shell_exec('/usr/share/pkg-php-tools/scripts/phppkginfo -d channel_alias channel.xml');
		addsubstvar($package, "phppear:channel-alias", $alias);
		my $common_desc = "This is the PEAR channel registry entry for $alias.\n\n".
			"PEAR is a framework and distribution system for reusable PHP components. ".
			"A PEAR channel is a website that provides package for download and a few extra meta-information for files.";
		local($Text::Wrap::separator) = '${Newline}';
		# Wrap and replace empty lines with a dot
		$common_desc = join('${Newline}.${Newline}', split('${Newline}${Newline}', wrap("", "", $common_desc)));
		addsubstvar($package, "phppear:channel-common-description", $common_desc);
	}
}

=head1 CONFORMS TO

Debian policy, version 3.9.4

PHP PEAR policy, version yet-to-be-written

=head1 SEE ALSO

F</usr/share/doc/pkg-php-tools/README.PEAR>, L<pkg-php-tools(7)>

L<debhelper(7)> (Note: This program is not part of debhelper)

=head1 AUTHOR

Mathieu Parent <sathieu@debian.org>