xkbprint Command

Purpose

Prints an XKB keyboard description.

Syntax

xkbprint [ -? | -help ] [ -color ] [ -dflts ] [ -diffs ] [ -eps ] [ -fit ] [ -full ] [ -grid Resolution ] [ -if FontName ] [ -label Type ] [ -lc Locale ] [ -level1 ] [ -level2 ] [ -lg Group ] [ -ll Level ] [ -mono ] [ -n Number ] [ -nkg Number ] [ -npk Number ] [ -o File ] [ -R Directory [ -pict Which] ] Source [ OutputFile ]

Description

The xkbprint command generates a printable or encapsulated PostScript description of the XKB keyboard description specifed by Source. The Source can be any compiled keymap, .xkm file, that includes a geometry description or an X display specification. If an OutputFile is specified, xkbprint writes to it. Otherwise, xkbprint creates the output file, replacing the extension of the source file with .ps or .eps depending on the requested format. If the source is a non-local X display, for example :0, xkbprint appends the appropriate prefix to the display specification, replacing the colon with a - (dash). For a local display, xkprint uses server-n where n is the number of the display.

Flags

Item Description
-? | -help Prints a usage message.
-color Prints using the colors specified in the geometry file; by default, xkbprint prints a black-and-white image of the keyboard.
-dflts Attempts to compute default names for any missing components, such as keys.
-diffs Shows symbols only where they are explicitly bound.
-eps Generates an encapsulated PostScript file.
-fit Fits the keyboard image on the page, this is the default.
-full Prints the keyboard at full size.
-grid Resolution Prints a grid with Resolutionmm resolution over the keyboard.
-if FontName Specifies an internal PostScript type 1 font to dump to the specified output file or to fontName.pfa, if no output file is specified. No keyboard description is printed if an internal font is dumped.
-label Type Specifies the labels to be printed on keys. Valid types are:
  • none
  • name
  • code
  • symbols
-lc Locale Specifies a locale in which KeySyms should be resolved.
-level1 Generates a level 1 PostScript.
-level2 Generates a level 2 PostScript.
-lg Group Prints symbols in keyboard groups starting from Group.
-ll Level Prints symbols starting from shift level Level.
-mono Generates a black-and-white image of keyboard, this is the default.
-n Number Prints Number of copies.
-nkg Number Prints the symbols in Number keyboard groups.
-npk Number Specifies the Number of keyboard images to print on each page. For EPS files, this specifies the total number of keyboard images to print.
-o File Writes the output to File.
-R Directory Use Directory as the root directory; all path names are interpreted relative to Directory.
-pict Which Controls the use of pictographs instead of keysym names where available. Valid values for Which are:
  • all
  • none
  • common (default).
-synch Forces synchronization for X requests.
-w Level Sets warning level.
  • 0 for no warning
  • 10 for all warnings