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.
AUTHOR¶
Written by Gunnar Wolf <gwolf@gwolf.org>
COPYRIGHT¶
Copyright ?? 2009-2012 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/>.