NAME

       xkbprint - print an XKB keyboard description

SYNOPSIS

       xkbprint [options] source [ output_file ]

DESCRIPTION

       The  xkbprint  command  generates  a printable or encapsulated PostScript description of the XKB keyboard
       description specified by source.  The source can be any compiled  keymap  (.xkm)  file  that  includes  a
       geometry  description  or an X display specification.  If an output_file is specified, xkbprint writes to
       it.  If no output file is specified, xkbprint creates replaces the extension of the source file with  .ps
       or  .eps  depending  on  the requested format.  If the source is a non-local X display (e.g.: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.

OPTIONS

       -?, -help
               Prints a usage message.

       -color  Print  using the colors specified in the geometry file;  by default, xkbprint prints a black-and-
               white image of the keyboard.

       -dflts  Attempt to compute default names for any missing components, such as keys.

       -diffs  Show symbols only where they are explicitly bound.

       -eps    Generate an encapsulated PostScript file.

       -fit    Fit the keyboard image on the page (default).

       -full   Print the keyboard at full size.

       -grid res
               Print a grid with resmm 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;  legal types are: none, name,code,symbols.

       -lc <locale>
               Specifies a locale in which KeySyms should be resolved.

       -level1 Generate level 1 PostScript.

       -level2 Generate level 2 PostScript.

       -lg group
               Print symbols in keyboard groups starting from group.

       -ll level
               Print symbols starting from shift level level.

       -mono   Generate black-and-white image of keyboard (default).

       -n num  Print num copies.

       -nkg num
               Print the symbols in num keyboard groups.

       -npk num
               Number of keyboard images to print on each page; for EPS files, this specifies the  total  number
               of keyboard images to print.

       -o file Write output to file.

       -Rdirectory
               Use directory as the root directory; all path names are interpreted relative to directory.

       -pict which
               Controls  use  of  pictographs instead of keysym names where available.  which can be any of all,
               none, or common(default).

       -synch  Forces synchronization for X requests.

       -version
               Print out the program version and exit.

       -w level
               Sets warning level (0 for no warning, 10 for all warnings).

SEE ALSO

       X(7),xkbcomp(1)

COPYRIGHT

       Copyright 1995, Silicon Graphics Computer Systems Copyright 1995, 1998  The Open Group
       See X(7) for a full statement of rights and permissions.

AUTHOR

       Erik Fortune, Silicon Graphics