Редакция 69 | Только различия | Не учитывать пробелы | Содержимое файла | Авторство | Последнее изменение | Открыть журнал | RSS
Редакция 69 | Редакция 87 | ||
---|---|---|---|
1 | <commands version="1.0">
|
1 | <commands version="1.0">
|
2 | <install>
|
2 | <install>
|
3 | <summary>Install Package</summary> |
3 | <summary>Install Package</summary> |
4 | <function>doInstall</function> |
4 | <function>doInstall</function> |
5 | <shortcut>i</shortcut> |
5 | <shortcut>i</shortcut> |
6 | <options>
|
6 | <options>
|
7 | <force>
|
7 | <force>
|
8 | <shortopt>f</shortopt> |
8 | <shortopt>f</shortopt> |
9 | <doc>will overwrite newer installed packages</doc> |
9 | <doc>will overwrite newer installed packages</doc> |
10 | </force>
|
10 | </force>
|
11 | <loose>
|
11 | <loose>
|
12 | <shortopt>l</shortopt> |
12 | <shortopt>l</shortopt> |
13 | <doc>do not check for recommended dependency version</doc> |
13 | <doc>do not check for recommended dependency version</doc> |
14 | </loose>
|
14 | </loose>
|
15 | <nodeps>
|
15 | <nodeps>
|
16 | <shortopt>n</shortopt> |
16 | <shortopt>n</shortopt> |
17 | <doc>ignore dependencies, install anyway</doc> |
17 | <doc>ignore dependencies, install anyway</doc> |
18 | </nodeps>
|
18 | </nodeps>
|
19 | <register-only>
|
19 | <register-only>
|
20 | <shortopt>r</shortopt> |
20 | <shortopt>r</shortopt> |
21 | <doc>do not install files, only register the package as installed</doc> |
21 | <doc>do not install files, only register the package as installed</doc> |
22 | </register-only>
|
22 | </register-only>
|
23 | <soft>
|
23 | <soft>
|
24 | <shortopt>s</shortopt> |
24 | <shortopt>s</shortopt> |
25 | <doc>soft install, fail silently, or upgrade if already installed</doc> |
25 | <doc>soft install, fail silently, or upgrade if already installed</doc> |
26 | </soft>
|
26 | </soft>
|
27 | <nobuild>
|
27 | <nobuild>
|
28 | <shortopt>B</shortopt> |
28 | <shortopt>B</shortopt> |
29 | <doc>don't build C extensions</doc> |
29 | <doc>don't build C extensions</doc> |
30 | </nobuild>
|
30 | </nobuild>
|
31 | <nocompress>
|
31 | <nocompress>
|
32 | <shortopt>Z</shortopt> |
32 | <shortopt>Z</shortopt> |
33 | <doc>request uncompressed files when downloading</doc> |
33 | <doc>request uncompressed files when downloading</doc> |
34 | </nocompress>
|
34 | </nocompress>
|
35 | <installroot>
|
35 | <installroot>
|
36 | <shortopt>R</shortopt> |
36 | <shortopt>R</shortopt> |
37 | <arg>DIR</arg> |
37 | <arg>DIR</arg> |
38 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT), use packagingroot for RPM</doc> |
38 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT), use packagingroot for RPM</doc> |
39 | </installroot>
|
39 | </installroot>
|
40 | <packagingroot>
|
40 | <packagingroot>
|
41 | <shortopt>P</shortopt> |
41 | <shortopt>P</shortopt> |
42 | <arg>DIR</arg> |
42 | <arg>DIR</arg> |
43 | <doc>root directory used when packaging files, like RPM packaging</doc> |
43 | <doc>root directory used when packaging files, like RPM packaging</doc> |
44 | </packagingroot>
|
44 | </packagingroot>
|
45 | <ignore-errors>
|
45 | <ignore-errors>
|
46 | <doc>force install even if there were errors</doc> |
46 | <doc>force install even if there were errors</doc> |
47 | </ignore-errors>
|
47 | </ignore-errors>
|
48 | <alldeps>
|
48 | <alldeps>
|
49 | <shortopt>a</shortopt> |
49 | <shortopt>a</shortopt> |
50 | <doc>install all required and optional dependencies</doc> |
50 | <doc>install all required and optional dependencies</doc> |
51 | </alldeps>
|
51 | </alldeps>
|
52 | <onlyreqdeps>
|
52 | <onlyreqdeps>
|
53 | <shortopt>o</shortopt> |
53 | <shortopt>o</shortopt> |
54 | <doc>install all required dependencies</doc> |
54 | <doc>install all required dependencies</doc> |
55 | </onlyreqdeps>
|
55 | </onlyreqdeps>
|
56 | <offline>
|
56 | <offline>
|
57 | <shortopt>O</shortopt> |
57 | <shortopt>O</shortopt> |
58 | <doc>do not attempt to download any urls or contact channels</doc> |
58 | <doc>do not attempt to download any urls or contact channels</doc> |
59 | </offline>
|
59 | </offline>
|
60 | <pretend>
|
60 | <pretend>
|
61 | <shortopt>p</shortopt> |
61 | <shortopt>p</shortopt> |
62 | <doc>Only list the packages that would be downloaded</doc> |
62 | <doc>Only list the packages that would be downloaded</doc> |
63 | </pretend>
|
63 | </pretend>
|
64 | </options>
|
64 | </options>
|
65 | <doc>[channel/]<package> ... |
65 | <doc>[channel/]<package> ... |
66 | Installs one or more PEAR packages. You can specify a package to |
66 | Installs one or more PEAR packages. You can specify a package to |
67 | install in four ways: |
67 | install in four ways: |
68 | 68 | ||
69 | "Package-1.0.tgz" : installs from a local file |
69 | "Package-1.0.tgz" : installs from a local file |
70 | 70 | ||
71 | "http://example.com/Package-1.0.tgz" : installs from |
71 | "http://example.com/Package-1.0.tgz" : installs from |
72 | anywhere on the net. |
72 | anywhere on the net. |
73 | 73 | ||
74 | "package.xml" : installs the package described in |
74 | "package.xml" : installs the package described in |
75 | package.xml. Useful for testing, or for wrapping a PEAR package in |
75 | package.xml. Useful for testing, or for wrapping a PEAR package in |
76 | another package manager such as RPM. |
76 | another package manager such as RPM. |
77 | 77 | ||
78 | "Package[-version/state][.tar]" : queries your default channel's server |
78 | "Package[-version/state][.tar]" : queries your default channel's server |
79 | ({config master_server}) and downloads the newest package with |
79 | ({config master_server}) and downloads the newest package with |
80 | the preferred quality/state ({config preferred_state}). |
80 | the preferred quality/state ({config preferred_state}). |
81 | 81 | ||
82 | To retrieve Package version 1.1, use "Package-1.1," to retrieve |
82 | To retrieve Package version 1.1, use "Package-1.1," to retrieve |
83 | Package state beta, use "Package-beta." To retrieve an uncompressed |
83 | Package state beta, use "Package-beta." To retrieve an uncompressed |
84 | file, append .tar (make sure there is no file by the same name first) |
84 | file, append .tar (make sure there is no file by the same name first) |
85 | 85 | ||
86 | To download a package from another channel, prefix with the channel name like |
86 | To download a package from another channel, prefix with the channel name like |
87 | "channel/Package" |
87 | "channel/Package" |
88 | 88 | ||
89 | More than one package may be specified at once. It is ok to mix these |
89 | More than one package may be specified at once. It is ok to mix these |
90 | four ways of specifying packages. |
90 | four ways of specifying packages. |
91 | </doc>
|
91 | </doc>
|
92 | </install>
|
92 | </install>
|
93 | <upgrade>
|
93 | <upgrade>
|
94 | <summary>Upgrade Package</summary> |
94 | <summary>Upgrade Package</summary> |
95 | <function>doInstall</function> |
95 | <function>doInstall</function> |
96 | <shortcut>up</shortcut> |
96 | <shortcut>up</shortcut> |
97 | <options>
|
97 | <options>
|
98 | <force>
|
98 | <force>
|
99 | <shortopt>f</shortopt> |
99 | <shortopt>f</shortopt> |
100 | <doc>overwrite newer installed packages</doc> |
100 | <doc>overwrite newer installed packages</doc> |
101 | </force>
|
101 | </force>
|
102 | <loose>
|
102 | <loose>
|
103 | <shortopt>l</shortopt> |
103 | <shortopt>l</shortopt> |
104 | <doc>do not check for recommended dependency version</doc> |
104 | <doc>do not check for recommended dependency version</doc> |
105 | </loose>
|
105 | </loose>
|
106 | <nodeps>
|
106 | <nodeps>
|
107 | <shortopt>n</shortopt> |
107 | <shortopt>n</shortopt> |
108 | <doc>ignore dependencies, upgrade anyway</doc> |
108 | <doc>ignore dependencies, upgrade anyway</doc> |
109 | </nodeps>
|
109 | </nodeps>
|
110 | <register-only>
|
110 | <register-only>
|
111 | <shortopt>r</shortopt> |
111 | <shortopt>r</shortopt> |
112 | <doc>do not install files, only register the package as upgraded</doc> |
112 | <doc>do not install files, only register the package as upgraded</doc> |
113 | </register-only>
|
113 | </register-only>
|
114 | <nobuild>
|
114 | <nobuild>
|
115 | <shortopt>B</shortopt> |
115 | <shortopt>B</shortopt> |
116 | <doc>don't build C extensions</doc> |
116 | <doc>don't build C extensions</doc> |
117 | </nobuild>
|
117 | </nobuild>
|
118 | <nocompress>
|
118 | <nocompress>
|
119 | <shortopt>Z</shortopt> |
119 | <shortopt>Z</shortopt> |
120 | <doc>request uncompressed files when downloading</doc> |
120 | <doc>request uncompressed files when downloading</doc> |
121 | </nocompress>
|
121 | </nocompress>
|
122 | <installroot>
|
122 | <installroot>
|
123 | <shortopt>R</shortopt> |
123 | <shortopt>R</shortopt> |
124 | <arg>DIR</arg> |
124 | <arg>DIR</arg> |
125 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT)</doc> |
125 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT)</doc> |
126 | </installroot>
|
126 | </installroot>
|
127 | <ignore-errors>
|
127 | <ignore-errors>
|
128 | <doc>force install even if there were errors</doc> |
128 | <doc>force install even if there were errors</doc> |
129 | </ignore-errors>
|
129 | </ignore-errors>
|
130 | <alldeps>
|
130 | <alldeps>
|
131 | <shortopt>a</shortopt> |
131 | <shortopt>a</shortopt> |
132 | <doc>install all required and optional dependencies</doc> |
132 | <doc>install all required and optional dependencies</doc> |
133 | </alldeps>
|
133 | </alldeps>
|
134 | <onlyreqdeps>
|
134 | <onlyreqdeps>
|
135 | <shortopt>o</shortopt> |
135 | <shortopt>o</shortopt> |
136 | <doc>install all required dependencies</doc> |
136 | <doc>install all required dependencies</doc> |
137 | </onlyreqdeps>
|
137 | </onlyreqdeps>
|
138 | <offline>
|
138 | <offline>
|
139 | <shortopt>O</shortopt> |
139 | <shortopt>O</shortopt> |
140 | <doc>do not attempt to download any urls or contact channels</doc> |
140 | <doc>do not attempt to download any urls or contact channels</doc> |
141 | </offline>
|
141 | </offline>
|
142 | <pretend>
|
142 | <pretend>
|
143 | <shortopt>p</shortopt> |
143 | <shortopt>p</shortopt> |
144 | <doc>Only list the packages that would be downloaded</doc> |
144 | <doc>Only list the packages that would be downloaded</doc> |
145 | </pretend>
|
145 | </pretend>
|
146 | </options>
|
146 | </options>
|
147 | <doc><package> ... |
147 | <doc><package> ... |
148 | Upgrades one or more PEAR packages. See documentation for the |
148 | Upgrades one or more PEAR packages. See documentation for the |
149 | "install" command for ways to specify a package. |
149 | "install" command for ways to specify a package. |
150 | 150 | ||
151 | When upgrading, your package will be updated if the provided new |
151 | When upgrading, your package will be updated if the provided new |
152 | package has a higher version number (use the -f option if you need to |
152 | package has a higher version number (use the -f option if you need to |
153 | upgrade anyway). |
153 | upgrade anyway). |
154 | 154 | ||
155 | More than one package may be specified at once. |
155 | More than one package may be specified at once. |
156 | </doc>
|
156 | </doc>
|
157 | </upgrade>
|
157 | </upgrade>
|
158 | <upgrade-all>
|
158 | <upgrade-all>
|
159 | <summary>Upgrade All Packages</summary> |
159 | <summary>Upgrade All Packages</summary> |
160 | <function>doInstall</function> |
160 | <function>doInstall</function> |
161 | <shortcut>ua</shortcut> |
161 | <shortcut>ua</shortcut> |
162 | <options>
|
162 | <options>
|
163 | <nodeps>
|
163 | <nodeps>
|
164 | <shortopt>n</shortopt> |
164 | <shortopt>n</shortopt> |
165 | <doc>ignore dependencies, upgrade anyway</doc> |
165 | <doc>ignore dependencies, upgrade anyway</doc> |
166 | </nodeps>
|
166 | </nodeps>
|
167 | <register-only>
|
167 | <register-only>
|
168 | <shortopt>r</shortopt> |
168 | <shortopt>r</shortopt> |
169 | <doc>do not install files, only register the package as upgraded</doc> |
169 | <doc>do not install files, only register the package as upgraded</doc> |
170 | </register-only>
|
170 | </register-only>
|
171 | <nobuild>
|
171 | <nobuild>
|
172 | <shortopt>B</shortopt> |
172 | <shortopt>B</shortopt> |
173 | <doc>don't build C extensions</doc> |
173 | <doc>don't build C extensions</doc> |
174 | </nobuild>
|
174 | </nobuild>
|
175 | <nocompress>
|
175 | <nocompress>
|
176 | <shortopt>Z</shortopt> |
176 | <shortopt>Z</shortopt> |
177 | <doc>request uncompressed files when downloading</doc> |
177 | <doc>request uncompressed files when downloading</doc> |
178 | </nocompress>
|
178 | </nocompress>
|
179 | <installroot>
|
179 | <installroot>
|
180 | <shortopt>R</shortopt> |
180 | <shortopt>R</shortopt> |
181 | <arg>DIR</arg> |
181 | <arg>DIR</arg> |
182 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT)</doc> |
182 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT)</doc> |
183 | </installroot>
|
183 | </installroot>
|
184 | <ignore-errors>
|
184 | <ignore-errors>
|
185 | <doc>force install even if there were errors</doc> |
185 | <doc>force install even if there were errors</doc> |
186 | </ignore-errors>
|
186 | </ignore-errors>
|
187 | <loose>
|
187 | <loose>
|
188 | <doc>do not check for recommended dependency version</doc> |
188 | <doc>do not check for recommended dependency version</doc> |
189 | </loose>
|
189 | </loose>
|
190 | </options>
|
190 | </options>
|
191 | <doc>
|
191 | <doc>
|
192 | Upgrades all packages that have a newer release available. Upgrades are |
192 | Upgrades all packages that have a newer release available. Upgrades are |
193 | done only if there is a release available of the state specified in |
193 | done only if there is a release available of the state specified in |
194 | "preferred_state" (currently {config preferred_state}), or a state considered |
194 | "preferred_state" (currently {config preferred_state}), or a state considered |
195 | more stable. |
195 | more stable. |
196 | </doc>
|
196 | </doc>
|
197 | </upgrade-all>
|
197 | </upgrade-all>
|
198 | <uninstall>
|
198 | <uninstall>
|
199 | <summary>Un-install Package</summary> |
199 | <summary>Un-install Package</summary> |
200 | <function>doUninstall</function> |
200 | <function>doUninstall</function> |
201 | <shortcut>un</shortcut> |
201 | <shortcut>un</shortcut> |
202 | <options>
|
202 | <options>
|
203 | <nodeps>
|
203 | <nodeps>
|
204 | <shortopt>n</shortopt> |
204 | <shortopt>n</shortopt> |
205 | <doc>ignore dependencies, uninstall anyway</doc> |
205 | <doc>ignore dependencies, uninstall anyway</doc> |
206 | </nodeps>
|
206 | </nodeps>
|
207 | <register-only>
|
207 | <register-only>
|
208 | <shortopt>r</shortopt> |
208 | <shortopt>r</shortopt> |
209 | <doc>do not remove files, only register the packages as not installed</doc> |
209 | <doc>do not remove files, only register the packages as not installed</doc> |
210 | </register-only>
|
210 | </register-only>
|
211 | <installroot>
|
211 | <installroot>
|
212 | <shortopt>R</shortopt> |
212 | <shortopt>R</shortopt> |
213 | <arg>DIR</arg> |
213 | <arg>DIR</arg> |
214 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT)</doc> |
214 | <doc>root directory used when installing files (ala PHP's INSTALL_ROOT)</doc> |
215 | </installroot>
|
215 | </installroot>
|
216 | <ignore-errors>
|
216 | <ignore-errors>
|
217 | <doc>force install even if there were errors</doc> |
217 | <doc>force install even if there were errors</doc> |
218 | </ignore-errors>
|
218 | </ignore-errors>
|
219 | <offline>
|
219 | <offline>
|
220 | <shortopt>O</shortopt> |
220 | <shortopt>O</shortopt> |
221 | <doc>do not attempt to uninstall remotely</doc> |
221 | <doc>do not attempt to uninstall remotely</doc> |
222 | </offline>
|
222 | </offline>
|
223 | </options>
|
223 | </options>
|
224 | <doc>[channel/]<package> ... |
224 | <doc>[channel/]<package> ... |
225 | Uninstalls one or more PEAR packages. More than one package may be |
225 | Uninstalls one or more PEAR packages. More than one package may be |
226 | specified at once. Prefix with channel name to uninstall from a |
226 | specified at once. Prefix with channel name to uninstall from a |
227 | channel not in your default channel ({config default_channel}) |
227 | channel not in your default channel ({config default_channel}) |
228 | </doc>
|
228 | </doc>
|
229 | </uninstall>
|
229 | </uninstall>
|
230 | <bundle>
|
230 | <bundle>
|
231 | <summary>Unpacks a Pecl Package</summary> |
231 | <summary>Unpacks a Pecl Package</summary> |
232 | <function>doBundle</function> |
232 | <function>doBundle</function> |
233 | <shortcut>bun</shortcut> |
233 | <shortcut>bun</shortcut> |
234 | <options>
|
234 | <options>
|
235 | <destination>
|
235 | <destination>
|
236 | <shortopt>d</shortopt> |
236 | <shortopt>d</shortopt> |
237 | <arg>DIR</arg> |
237 | <arg>DIR</arg> |
238 | <doc>Optional destination directory for unpacking (defaults to current path or "ext" if exists)</doc> |
238 | <doc>Optional destination directory for unpacking (defaults to current path or "ext" if exists)</doc> |
239 | </destination>
|
239 | </destination>
|
240 | <force>
|
240 | <force>
|
241 | <shortopt>f</shortopt> |
241 | <shortopt>f</shortopt> |
242 | <doc>Force the unpacking even if there were errors in the package</doc> |
242 | <doc>Force the unpacking even if there were errors in the package</doc> |
243 | </force>
|
243 | </force>
|
244 | </options>
|
244 | </options>
|
245 | <doc><package> |
245 | <doc><package> |
246 | Unpacks a Pecl Package into the selected location. It will download the |
246 | Unpacks a Pecl Package into the selected location. It will download the |
247 | package if needed. |
247 | package if needed. |
248 | </doc>
|
248 | </doc>
|
249 | </bundle>
|
249 | </bundle>
|
250 | <run-scripts>
|
250 | <run-scripts>
|
251 | <summary>Run Post-Install Scripts bundled with a package</summary> |
251 | <summary>Run Post-Install Scripts bundled with a package</summary> |
252 | <function>doRunScripts</function> |
252 | <function>doRunScripts</function> |
253 | <shortcut>rs</shortcut> |
253 | <shortcut>rs</shortcut> |
254 | <options />
|
254 | <options />
|
255 | <doc><package> |
255 | <doc><package> |
256 | Run post-installation scripts in package <package>, if any exist. |
256 | Run post-installation scripts in package <package>, if any exist. |
257 | </doc>
|
257 | </doc>
|
258 | </run-scripts>
|
258 | </run-scripts>
|
259 | </commands>
|
259 | </commands>
|