carta
dh-exec-illiterate(1)

dh-exec-illiterate1

Write literate debhelper config files!

Usage

literate programming!

x86_64-linux-gnu.

write this rule as:

named `rename-me', to `/usr/share/foo/new-name' - we renamed it

in the process!

Overview

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.

It is a program that will translate its input from pretty much free-form text into something that resembles an install file. At least, that's the only supported output format for now.

Everything that's not recognised, will be ignored, and not printed. The recognised constructs are:

`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_SCRIPTDIR

Indicates 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.

Versions

The sub-command was introduced in dh-exec version 0.1.

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm) to Debian 9 (Stretch)
  • Debian 8 (Jessie) to Debian 7 (Wheezy)

From dh-exec 0.30 in Debian 13 (Trixie). Parsed by carta from the page's man source.