dh_auto_configure

   1 #!/usr/bin/perl -w
   2
   3 =head1 NAME
   4
   5 dh_auto_configure - automatically configure a package prior to building
   6
   7 =cut
   8
   9 use strict;
  10 use Debian::Debhelper::Dh_Buildsystems;
  11
  12 =head1 SYNOPSIS
  13
  14 B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
  15
  16 =head1 DESCRIPTION
  17
  18 B<dh_auto_configure> is a debhelper program that tries to automatically
  19 configure a package prior to building. It does so by running the
  20 appropriate command for the build system it detects the package uses.
  21 For example, it looks for and runs a F<./configure> script, F<Makefile.PL>,
  22 F<Build.PL>, or F<cmake>. A standard set of parameters is determined and passed
  23 to the program that is run. Some build systems, such as make, do not
  24 need a configure step; for these B<dh_auto_configure> will exit without
  25 doing anything.
  26
  27 This is intended to work for about 90% of packages. If it doesn't work,
  28 you're encouraged to skip using B<dh_auto_configure> at all, and just run
  29 F<./configure> or its equivalent manually.
  30
  31 In order to override standard build flags, export appropriate environment
  32 variables as documented in the L<dpkg-buildflags(1)> manual page. They will be
  33 preferred over directly exported their counterparts (CFLAGS, CXXFLAGS, LDFLAGS
  34 etc.).
  35
  36 =head1 OPTIONS
  37
  38 See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build
  39 system selection and control options.
  40
  41 =over 4
  42
  43 =item B<--> I<params>
  44
  45 Pass I<params> to the program that is run, after the standard
  46 parameters that B<dh_auto_configure> passes. This can be used to supplement
  47 or override those parameters. For example:
  48
  49   dh_auto_configure -- --with-foo --enable-bar
  50
  51 =back
  52
  53 =cut
  54
  55 buildsystems_init();
  56 buildsystems_do();
  57
  58 =head1 SEE ALSO
  59
  60 L<debhelper(7)>
  61
  62 This program is a part of debhelper.
  63
  64 =head1 AUTHOR
  65
  66 Joey Hess <joeyh@debian.org>
  67
  68 =cut