NAME

     gen_keymap — generate a keyboard map decision tree

SYNOPSIS

     gen_keymap list ...

DESCRIPTION

     gen_keymap generates a decision tree from a set of keyboard maps which can be used to help a
     user decide which keyboard map to use.  The program using the decision tree typically asks
     the user to press some keys; at each step, it examines the returned keycode and uses it to
     prune the list of possible keyboard maps until there is only one left.

OPTIONS

     --version
           Show program's version number and exit.

     -?, --help
           Show help text.

     -v, --verbose
           Be more verbose.

     -mMINLEN, --minlen=MINLEN
           Too-short keymaps are skipped (default: 30 entries).

     -g, --graph
           Generate a hopefully-nice-looking .dot file.

     --maps
           Print the to-be-processed keymaps

     -i, --installer
           Input files are in d-i map form.

     -IDIRS, --inc=DIRS, --include=DIRS
           Add a directory to the search path.

     -oFILENAME, --output=FILENAME
           Set output file (default: stdout).

     -fFILTER, --filter=FILTER
           Include only the branches leading to these keymaps.

     -uUSEONLY, --useonly=USEONLY
           Start generating the tree based only on these keymaps.  (The difference between
           --filter and --useonly is that the former generates the whole tree and then prunes it,
           while the latter only generates a reduced tree to begin with.  This may have
           implications for performance on large trees.)

     -sSKIP, --skip=SKIP
           Keymaps to skip.

     -t, --test
           Test the generated maps.

     --interactive
           Ask user to choose among indistinguishable keymaps.

AUTHORS

     gen_keymap was written by Matthias Urlichs <smurf@debian.org>.  This manual page was written
     by Colin Watson <cjwatson@ubuntu.com>.