XKBPRINT(1)							  XKBPRINT(1)



NAME
       xkbprint - print an XKB keyboard description

SYNOPSIS
       xkbprint [options] source [ output_file ]

DESCRIPTION
       The  xkbprint  comman 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 spec-
       ified,  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 key-
	       board.

       -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 
	       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 inter-
	       preted 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.

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

SEE ALSO
       X(7x),xkbcomp(1)

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

AUTHOR
       Erik Fortune, Silicon Graphics



								  XKBPRINT(1)

UNIX/Linux commands referenced on this page:

1. file
2. display
3. as
4. at
5. dump
6. locale
7. which
8. groups