.TH cs-tools 1 "12 Feb 1996" "CS Tools" "NLS Manual"
.\"SKIP_SECTION"
.SH NAME
cs-tools \-\- Czech & Slovak national environment
.\"SKIP_SECTION"
.SH DESCRIPTION
.LP
This is a set of packages to make writing/reading/printing of
Czech and Slovak texts available under Linux. All of these tools
use ISO-8859-2 character encoding (aka ISO-Latin 2).
It consists from four parts:

\fBconsole\fP: There are two files, \fIcz-lat2.map\fP and \fIsk-lat2.map\fP
for setting Czech/Slovak keyboard on text console. To use it,
you can simply do:

$ loadkeys (cz|sk)-lat2.map

(Yes, you need Andries Brouwer's  kbd-0.84 or newer package.)
Then you can switch between US (default) keyboard and the local 
(Czech or Slovak) one using \fIPause\fP key. You can temporarily
flip keyboard to the opposite mode by holding \fIAltGr\fP key.

\fBcstocs\fP: This is a new version of reencoding utility. It allows
to translate texts between different encodings (8859-2, Kamenicky, ASCII, ...)
For details see the manpage.

\fBemacs\fP: There are Lisp files written by Milan Zamazal, which
allows to use Czech keyboard in emacs(1). Unfortunately, there is no
support for Slovak keyboard, and I will not make one, because i do not
use emacs. If you write it, please send me a copy.

\fBX11\fP: I have finally patched Xlib to handle Compose keys correctly.
For actually using it, you must load proper Xmodmap via xmodmap(1).
Scroll Lock (and Right Alt too) switches from primary to secondary
keymap, Print Screen  key works as compose (e.g. PrtSc+l+/ gives
Polish lslash, or PrtSc+U+o gives Uring). This should work
for every X client that uses dynamically linked X11R6's Xlib
(both ELF and a.out).

In this package you can find some ISO-8859-2 encoded X11 fonts
too. 

In adition to this, I have left in cs-tools also Czech and Slovak
resource file for xterm(1).  Using \fIPause\fP key,
you can switch into your national keyboard. If you press AltGr
when in national mode, you temporarily obtain US keyboard.
Of course, you can switch back to US keyboard by pressing \fIPause\fP
once again.

.SH KEYBOARD LAYOUT
All keyboards are qwerty (instead of "official" qwertz), because I prefere
this layout. But this can be simply changed. All other keys
are the same as on most Czech keyboard I have seen. Key \fIPause\fP
is used to switch between US and national mode. In national mode
(and on console also in US mode) you can switch to the opposite
keyboard mode temporarily using key \fIAltGr\fP (it is the right Alt).

Since I am not Slovak, I had only few informations about Slovak
keyboard layout. See the file SLOVAK_KEYBOARD.mail in the distribution.
Slovak Xmodmaps were contributed by Stano Meduna.

.SH SEE ALSO
cstocs(1), emacs(1), X(1), xterm(1), cstex(7), loadkeys(1), mpage(1), gs(1).
.SH AUTHORS
Milan Zamazal (Czech emacs)

Libor Skarvada (Czech xterm, some X11 fonts)

Petr Mejzlik (additions to Czech xterm)

Jan "Yenya" Kasprzak (more things, completation of this package).
 
Stano Meduna (Slovak Xmodmaps)

.SH BUGS
There's no Slovak emacs support. If you make it, please send me a copy.

.PP
.SH "BUG REPORTS AND SUGGESTIONS"
If you will have any problem with this software, do:
.TP
1) RTFM,
.TP
2) if this does not help you, feel free to mail me to kas@muni.cz
.TP
Suggestions are welcome at kas@muni.cz.
.SH COPYRIGHT
Copyright (C) 1994-1996  Jan "Yenya" Kasprzak <kas@muni.cz>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.