dh-exec-filter.1 2.11 KB
Newer Older
1
.TH "DH\-EXEC\-FILTER" "1" "2015-10-12" "" "dh-exec"
2 3 4 5 6 7 8 9
.ad l
.nh
.SH "NAME"
dh\-exec\-filter \- Debhelper executable file filtering scripts
.SH "SYNOPSIS"
\fB#! /usr/bin/dh\-exec\fR
.br
[hurd-i386 kfreebsd-any] debian/non-linux/some-file /usr/lib/my-package
10
.br
Gergely Nagy's avatar
Gergely Nagy committed
11
<stage1> src/compiler1 /usr/bin
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

.SH "DESCRIPTION"
Being a sub\-command of \fIdh\-exec\fR(1), this program must not be
ran directly, but through \fIdh\-exec\fR, which automatically runs all
available sub\-commands if run bare; or explicitly with \fBdh\-exec
\-\-with=subst\fR.

It is a wrapper around the various other filtering helpers, and will
pipe the input file through all the available filtering helpers. It is
up to these scripts to do the actual work.

.SH "SCRIPTS"

.TP
.B dh\-exec\-filter\-arch
Filters out lines that are not for the current architecture. A line
can be pre\- or post\-fixed with a bracketed list of architectures,
and it will be kept only if building on one of the architectures.

The filter supports negation and wildcards, with the same syntax as
32
\fIdpkg\-architecture\fR(1).
33

34 35
Introduced in version \fI0.13\fR.

36 37 38 39 40 41 42 43 44 45
.TP
.B dh\-exec\-filter\-build\-profiles
Filters out lines that do not match the build profiles in effect. One
can use the same syntax as in \fIdebian/control\fR files. If any of
the profiles match, the line will be kept, otherwise it gets filtered
out.

If a profile is specified, but \fBDEB_BUILD_PROFILES\fR is unset, an
error will be thrown.

46 47
Introduced in version \fI0.13\fR.

48 49 50 51
.TP
.B dh\-exec\-filter\-comments
Removes commented and empty lines.

52 53
Introduced in version \fI0.13\fR.

54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
.SH "ENVIRONMENT"
.PP
\fIDH_EXEC_SCRIPTDIR\fR
.RS 4
Indicates which directory the command\-specific scripts should be
sought for. If not specified, scripts will be searched for in
\fI/usr/share/dh\-exec/\fR.
.RE

.SH "FILES"
.PP
\fI$DH_EXEC_SCRIPTDIR/dh\-exec\-filter\-*\fR
.RS 4
The various scripts for the higher\-level program.
.RE

70 71 72 73
.SH "VERSIONS"

The sub\-command was introduced in dh\-exec version \fI0.13\fR.

74 75 76 77
.SH "SEE ALSO"
\fIdebhelper\fR(1), \fIdh\-exec\fR(1)

.SH "AUTHOR"
Gergely Nagy's avatar
Gergely Nagy committed
78
dh\-exec\-filter is copyright \(co 2011-2015 by Software Freedom Conservancy, Inc.