NAME¶
dh-make-drupal - Builds a Debian package for the requested Drupal project
DESCRIPTION¶
The purpose of this program is to generate Debian packages for any Drupal
projects (that is, modules, themes or translations) - Please note note that as
of October 2010 the infrastructure for publishing translations has changed, so
its current support status through this program is suboptimal
Given that Drupal developers publish their work through the main Drupal site
(
http://drupal.org), this program fetches the information for the latest
available versions (for the right Drupal release, and with the specified
stability level), and prepares a Debian package from it.
This Debian package can be locally installed using 'dpkg', or uploaded to your
Apt repository.
Keep in mind that this package only goes as far as it can, being an automated
tool. The generated packages will probably require verification/tweaking to be
of production quality.
This program has been inspired
-and named in a similar fashion to-
Debian's pkg-perl group's dh-make-perl.
-v, --version
- -h, --help
- Display this screen
- -d, --drupal-version VERSION
- Drupal version
- -r, --report-only
- Check only for project availability, don't download or perform any other
actions locally. Implies -D.
- -f, --force
- Proceed even if this will overwrite currently existing files
- --debug LEVEL
- Debug level for generated messages (0=highest, 5=lowest)
- -s, --min-status STATUS
- Minimum status to consider for packaging. Accepted values: 'recommended',
'supported', 'developer'. Defaults to recommended.
- -D, --dont-debianize
- Do not attempt to debianize the project, only download the tarball
- -b, --no-build
- Prepare the debianized directory, but omit the actual package build
process. This option is incompatible with either -D and
-r.
- -R, --no-recommends
- Omits the generation of the Recommends: line, which is built by scanning
of submodule-provided .info files and may be misleading or introducing too
much noise
- --build-switches SWITCHES
- Switches to pass to dpkg-buildpackage. Defaults to "-us
-uc" (do not sign the generated package). In order not to give
any switches, specify an empty quoted string (i.e.
--build-switches='').
- -t, --tarball FILE
- Use the specified tarball as the original project tar.gz, don't look for
any other available versions and don't download from the Drupal website.
This will require you also to provide a project version number with
-V and the project type with -T
- -T, --proj-type TYPE
- Type of project we are packaging. This option is only meaningful when
working on a local tarball ( -t), and will be ignored otherwise.
Accepted values: %s. Defaults to ["Modules", "Themes",
"Translations"].
- -V, --proj_version VERSION
- Provide a project version number. This option is only meaningful when
working on a local tarball ( -t), and will be ignored
otherwise
- -m, --mangle-version PATTERN
- Debian versioning logic includes the ??~?? character meaning ??anything
below?? the preceding version number. This is most useful when dealing
with pre-release qualificators (in order, 1.x-dev, 1.0-alpha1, 1.0-beta,
1.0rc3). dh-make-drupal will try to recognize such patterns and mangle
them so they sort correctly in Debian (and so that when a stable version
is released it appears as higher - For the above mentioned version
numbers, they would result in 1~~dev, 1.0~alpha1, 1.0~beta, 1.0~rc3). You
can use this switch to tell dh-make-drupal to omit this mangling.
- -P, --provides SUBMODULES
- generate the Provides: line, which is built from specified comma-separated
submodules. They will all be converted to what would amount to their
Debian package name -- i.e. "-P foo,bar" becomes
"Provides: drupal7-mod-foo, drupal7-mod-bar" (when building a
Drupal7 module).
AUTHOR¶
Written by Gunnar Wolf <gwolf@gwolf.org>
COPYRIGHT¶
Copyright ?? 2009-2013 Gunnar Wolf
- Instituto de Investigaciones Econ??micas, UNAM
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program. If not, see <
http://www.gnu.org/licenses/>.