dh_testversion.1

   1 .TH DH_TESTVERSION 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_testversion \- ensure that the correct version of debhelper is installed
   4 .SH SYNOPSIS
   5 .B dh_testversion [debhelper options] [operator] [version]
   6 .SH "DESCRIPTION"
   7 Note: This program is rapidly becoming obsolete. Soon you will be able to
   8 use build dependanices instead.
   9 .P
  10 dh_testversion compares the version of debhelper against the version you
  11 specify, and if the condition is not met, exits with an error message.
  12 .P
  13 You should use this in your debian/rules files if a new debhelper feature is
  14 introduced, and your package requires that feature to build correctly. Use
  15 debhelper's changelog to figure out the version you need.
  16 .P
  17 Be sure not to overuse dh_testversion. If debhelper version 9.5
  18 introduces a new dh_autofixbugs command, and your package uses it, then if
  19 someone tries to build it with debhelper 1.0, the build will fail anyway when
  20 dh_autofixbugs cannot be found, so there is no need for you to use
  21 dh_testversion.
  22 .SH OPTIONS
  23 .TP
  24 .B debhelper options
  25 See
  26 .BR debhelper (1)
  27 for a list of options common to all debhelper commands.
  28 .TP
  29 .B operator
  30 Optional comparison operator used in comparing the versions. If not
  31 specified, ">=" is used. For descriptions of the comparison operators, see
  32 dpkg --help.
  33 .TP
  34 .B version
  35 Version number to compare against the current version of debhelper. If not
  36 specified, dh_testversion does nothing.
  37 .SH EXAMPLES
  38 .TP
  39 .I dh_testversion 1.0
  40 Make sure debhelper version 1.0 or higher is installed.
  41 .TP
  42 .I dh_testversion ge 1.0
  43 Another way to make sure debhelper version 1.0 or higher is installed.
  44 .TP
  45 .I dh_testversion lt 1.0
  46 Make sure a version of debhelper less than version 1.0 is installed.
  47 .SH ENVIRONMENT
  48 See
  49 .BR debhelper (1)
  50 for a list of environment variables that affect all debhelper commands.
  51 .SH "SEE ALSO"
  52 .BR debhelper (1)
  53 .SH AUTHOR
  54 Joey Hess <joeyh@debian.org>