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 res mm 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,
               and 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