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 _s_o_u_r_c_e. The _s_o_u_r_c_e can be any compiled keymap (.xkm) file that includes a geometry description or an X display specification. If an _o_u_t_p_u_t___f_i_l_e is specified, xkbprint writes to it. If no output file is specified, xkbprint creates replaces the extension of the source file with _._p_s or _._e_p_s 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 _r_e_s
Print a grid with _r_e_smm resolution over the keyboard.
-if _f_o_n_t_N_a_m_e
Specifies an internal PostScript type 1 font to dump to the specified output file or to _f_o_n_t_N_a_m_e.pfa, if no output file is specified. No keyboard description is printed if an internal font is dumped.
-label _t_y_p_e
Specifies the labels to be printed on keys; legal types are: _n_o_n_e, _n_a_m_e,_c_o_d_e,_s_y_m_b_o_l_s.
-lc _<_l_o_c_a_l_e_>
Specifies a locale in which KeySyms should be resolved.
-level1
Generate level 1 PostScript.
-level2
Generate level 2 PostScript.
-lg _g_r_o_u_p
Print symbols in keyboard groups starting from _g_r_o_u_p.
-ll _l_e_v_e_l
Print symbols starting from shift level _l_e_v_e_l.
-mono
Generate black-and-white image of keyboard (default).
-n _n_u_m
Print _n_u_m copies.
-nkg _n_u_m
Print the symbols in _n_u_m keyboard groups.
-npk _n_u_m
Number of keyboard images to print on each page; for EPS files, this specifies the total number of keyboard images to print.
-o _f_i_l_e
Write output to _f_i_l_e.
-R_d_i_r_e_c_t_o_r_y
Use _d_i_r_e_c_t_o_r_y as the root directory; all path names are interpreted relative to _d_i_r_e_c_t_o_r_y.
-pict _w_h_i_c_h
Controls use of pictographs instead of keysym names where available. _w_h_i_c_h can be any of _a_l_l, _n_o_n_e, or _c_o_m_m_o_n(default).
-synch
Forces synchronization for X requests.
-w _l_e_v_e_l
Sets warning level (0 for no warning, 10 for all warnings).

SEE ALSO

X(7),xkbcomp(1) 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