table of contents
other versions
- wheezy 0.4
- jessie 0.14
- jessie-backports 0.23~bpo8+1
- testing 0.23+b1
- unstable 0.23+b1
DH-EXEC-ILLITERATE(1) | dh-exec | DH-EXEC-ILLITERATE(1) |
NAME¶
dh-exec-illiterate - Write literate debhelper config files!SYNOPSIS¶
#! /usr/bin/dh-exec --with=illiterate,subst,install Greetings, my dear reader, and welcome to the awesome world of literate programming! Today, we're going to explore how to write a debhelper install file in a literate manner. Trust me, it's going to be lots and lots of fun! So, what exactly are we trying to accomplish? We're going to try installing a file from `src/this-file' in the source tree, to a multi-arched path in the binary file. Lets say, to `/usr/lib/foo/${DEB_HOST_MULTIARCH}/'. Of course, ${DEB_HOST_MULTIARCH} is a variable, and will be expanded later in the dh-exec pipeline. It'll be something like x86_64-linux-gnu. Furthermore, we want to install all files from the 'usr/lib' directory under debian/tmp. If we were writing an illiteral install file, we'd write this rule as: usr/lib But the above description is much easier to understand, isn't it? We're almost finished! One thing left to do, is to install a script named `rename-me', to `/usr/share/foo/new-name' - we renamed it in the process!
DESCRIPTION¶
The dh-exec-illiterate sub-command, unlike the others, does not serve any particular case, except to serve as a warning to all, that things can be taken to an extreme, even with dh-exec. On the other hand, it is just like the other sub-commands in that it must not be called directly, but through dh-exec(1), which automatically runs all available sub-commands if run bare; or explicitly with dh-exec --with=illiterate.- `source' ... `destination'
- The first string between a backtick and a single quote will
be treated as the source file, the next such string will be the
destination. If the destination ends with a slash, dh-exec-illiterate will
consider it a directory, otherwise it will output a construct that
dh-exec-install can recognise as a rename operation.
- 'source'
- A string, without whitespace, between two single quotes is
treated as a source, whose destination is unspecified, and is left up to
dh_install(1) to figure out.
ENVIRONMENT¶
DH_EXEC_SCRIPTDIRIndicates which directory the command-specific
scripts should be sought for. If not specified, scripts will be searched for
in /usr/share/dh-exec/.
FILES¶
$DH_EXEC_SCRIPTDIR/dh-exec-illiterate-*The various scripts for the higher-level
program.
SEE ALSO¶
debhelper(1), dh-exec(1)AUTHOR¶
dh-exec-illiterate is copyright © 2011-2012 by Gergely Nagy <algernon@madhouse-project.org>.2012-05-03 |