Commands Reference, Volume 6

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

-? \| -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

Related Information

The X command and xkbcomp command.