File: debpear.1

package info (click to toggle)
debpear 0.5
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster, sid, stretch
  • size: 48 kB
  • sloc: sh: 238; makefile: 2
file content (110 lines) | stat: -rw-r--r-- 2,966 bytes parent folder | download | duplicates (2)
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
.TH debpear 1
.SH NAME
debpear \- automatically builds and installs PEAR packages as Debian packages

.SH SYNOPSIS
.B debpear
.B [options]
.B <pear\-package\-name>

.SH DESCRIPTION
.LP
.I debpear
is a tool to automatically create and build a Debian package out of
a PHP PEAR package. It will download the PEAR package from pear.php.net,
then by looking into it, create the corresponding Debian package, and
eventually also installs it.

.SH PARAMETERS
.LP
.B <pear\-package\-name>
.IP
Defines the PEAR package name you want to install, as seen on the
http://pear.php.net/ site. Make sure respect the case in the name of
the package (for example: Package_NAME).

.SH OPTIONS
.LP
\-\-build\-dir|\-b
.IP
Specify the directory where the Debian package will be built.

.LP
\-\-verbose|\-v
.IP
Makes debpear more verbose.

.LP
\-\-channel|\-c
.I channel-alias
.IP
Specify the 
.I channel-alias
which provide from the pear-channels package, pear and pecl channel.

.LP
\-\-tarball|\-t
.I tarball
\-\-pkg\-version|\-pv
.I pkg\-version
[ \-\-wget|\-w
.I URL
]
.IP
Do not use "pear download" to optain the PEAR package from upstream authors.
Instead, use
.I tarball
and use
.I pkg\-version
when building the package.
Eventually also download the tarball from
.I URL
using wget before building.

.LP
\-\-install|\-i
.IP
Install the resulting debian package in your system. Note that you must be root
to use this option. If you aren't root, then debpear will try to get root using
sudo.

.SH EXAMPLE
.LP
debpear \-i Auth_RADIUS
.IP
This will create a php\-auth\-radius package in ./build\-area, and
automatically install it. Because it's written in the package.xml shipped with
Auth_RADIUS at pear.php.net, php\-auth\-radius will depend on php5\-radius.

.LP
debpear \-t current.tgz \-pv 1.3.1 \-w http://downloads.jasig.org/cas\-clients/php/current.tgz CAS
.IP
Downloads cas\-clients from http://downloads.jasig.org/cas\-clients/php/current.tgz,
as current.tgz in the current directory, then builds it as if it was
downloaded as CAS\-1.3.1.tgz by "pear download".

.LP
debpear \-c pecl gnupg
.IP
This will create a php\-gnupg package from the pecl.php.net channel.

.LP
debpear \-c phpunit DbUnit
.IP
This will create a php\-dbunit package from the pear.phpunit.de channel.

.SH IMPORTANT
.IP
Note that the debian/copyright file generated by debpear isn't good enough
for redistribution of the created packages. You should carefuly review the
PEAR package license before doing so. Also, debpear has been created for
convenience, but it will never replace the manual work of an experienced
Debian maintainer for creating PEAR packages. It can, however, be used to
create a template package quickly, before a careful review, in order to save
time building a Debian PEAR package.

.SH AUTHORS
.IP
debpear has been written by Thomas Goirand <zigo@debian.org>, and is
maintained inside the PKG PHP PEAR Debian team, that can be reached at:
<pkg\-php\-pear@lists.alioth.debian.org>.