diff options
author | Modestas Vainius <modestas@vainius.eu> | 2009-06-08 21:32:27 +0300 |
---|---|---|
committer | Modestas Vainius <modestas@vainius.eu> | 2009-06-08 23:01:02 +0300 |
commit | f897611a77726655aea258af0c4d52a8ce759ebc (patch) | |
tree | 7e89d87f0a98706d4b7864eb571d341e1ade7542 /debhelper.pod | |
parent | 9c95d2ea547f3566f1bf8b67c08da57845325341 (diff) |
Improvements in DH_OPTIONS handling and DH_AUTO_OPTIONS envvar support.
* DH_AUTO_OPTIONS is like existing DH_OPTIONS, just only for dh_auto
stuff. This also avoids "explosion" of separate DH_AUTO_* environment
variables (i.e. exports in debian/rules) and encourages usage of dh_auto
command line option names. DH_AUTO_OPTIONS is passed via "extra_args" to
Dh_Lib::init() (API addition).
* When splitting options from DH_OPTIONS and its flavours, allow arguments
to include whitespaces if they are escaped with backslash (\) (see
split_options_string()). Document this in debhelper.pod.
* Short option for --buildsystem is -c (aka class).
* Provide API to cancel option specs from default debhelper options.
It will be used in the feature.
Diffstat (limited to 'debhelper.pod')
-rw-r--r-- | debhelper.pod | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/debhelper.pod b/debhelper.pod index 388453c3..8c232d28 100644 --- a/debhelper.pod +++ b/debhelper.pod @@ -491,8 +491,14 @@ Anything in this variable will be prepended to the command line arguments of all debhelper commands. Command-specific options will be ignored by commands that do not support them. -This is useful in some situations, for example, if you need to pass -p to -all debhelper commands that will be run. One good way to set DH_OPTIONS is +Arguments are separated by whitespaces unless a whitespace is escaped +with a backslash character (\). Then the whitespace is treated literally. +Likewise, the backslash character is treated literally unless it is followed +by a single whitespace. If a backslash is followed by two or more spaces, +it will be considered as the last symbol of the argument. + +DH_OPTIONS is useful in some situations, for example, if you need to pass -p +to all debhelper commands that will be run. One good way to set DH_OPTIONS is by using "Target-specific Variable Values" in your debian/rules file. See the make documentation for details on doing this. |