summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am5
-rw-r--r--doc/Makefile.in191
-rw-r--r--doc/README.acm43
-rw-r--r--doc/README.iBook2.console-tools38
-rw-r--r--doc/README.sfm11
-rw-r--r--doc/fonts/README75
-rw-r--r--doc/fonts/README.Arabic8
-rw-r--r--doc/fonts/README.Cyrillic49
-rw-r--r--doc/fonts/README.Ethiopic30
-rw-r--r--doc/fonts/README.Greek8
-rw-r--r--doc/fonts/README.Hebrew6
-rw-r--r--doc/fonts/README.Sun23
-rw-r--r--doc/fonts/fonts.magic54
-rw-r--r--doc/keymaps/README31
-rw-r--r--doc/keymaps/README.sparc117
-rw-r--r--doc/keymaps/hypermap.m4475
-rw-r--r--doc/keymaps/no-latin1.doc50
-rw-r--r--doc/keymaps/se.readme2
18 files changed, 1216 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..41973e8
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,5 @@
+# -*- makefile -*-
+
+AUTOMAKE_OPTIONS = foreign
+
+EXTRA_DIST = README.* fonts/* keymaps/*
diff --git a/doc/Makefile.in b/doc/Makefile.in
new file mode 100644
index 0000000..3d661b4
--- /dev/null
+++ b/doc/Makefile.in
@@ -0,0 +1,191 @@
+# Makefile.in generated automatically by automake 1.4-p6 from Makefile.am
+
+# Copyright (C) 1994, 1995-8, 1999, 2001 Free Software Foundation, Inc.
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+# -*- makefile -*-
+
+
+SHELL = @SHELL@
+
+srcdir = @srcdir@
+top_srcdir = @top_srcdir@
+VPATH = @srcdir@
+prefix = @prefix@
+exec_prefix = @exec_prefix@
+
+bindir = @bindir@
+sbindir = @sbindir@
+libexecdir = @libexecdir@
+datadir = @datadir@
+sysconfdir = @sysconfdir@
+sharedstatedir = @sharedstatedir@
+localstatedir = @localstatedir@
+libdir = @libdir@
+infodir = @infodir@
+mandir = @mandir@
+includedir = @includedir@
+oldincludedir = /usr/include
+
+DESTDIR =
+
+pkgdatadir = $(datadir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+
+top_builddir = ..
+
+ACLOCAL = @ACLOCAL@
+AUTOCONF = @AUTOCONF@
+AUTOMAKE = @AUTOMAKE@
+AUTOHEADER = @AUTOHEADER@
+
+INSTALL = @INSTALL@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@ $(AM_INSTALL_PROGRAM_FLAGS)
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+transform = @program_transform_name@
+
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+host_alias = @host_alias@
+host_triplet = @host@
+AMTAR = @AMTAR@
+AWK = @AWK@
+CC = @CC@
+COMPRESSOR_EXT = @COMPRESSOR_EXT@
+COMPRESSOR_OPTS = @COMPRESSOR_OPTS@
+CXX = @CXX@
+CYGPATH_W = @CYGPATH_W@
+FONTDIR = @FONTDIR@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+KEYMAPDIR = @KEYMAPDIR@
+MAKEINFO = @MAKEINFO@
+OLDKEYMAPDIR = @OLDKEYMAPDIR@
+PACKAGE = @PACKAGE@
+STRIP = @STRIP@
+TRANSDIR = @TRANSDIR@
+VERSION = @VERSION@
+VIDEOMODEDIR = @VIDEOMODEDIR@
+am__leading_dot = @am__leading_dot@
+am__tar = @am__tar@
+am__untar = @am__untar@
+install_sh = @install_sh@
+mkdir_p = @mkdir_p@
+
+AUTOMAKE_OPTIONS = foreign
+
+EXTRA_DIST = README.* fonts/* keymaps/*
+mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
+CONFIG_CLEAN_FILES =
+DIST_COMMON = Makefile.am Makefile.in
+
+
+DISTFILES = $(DIST_COMMON) $(SOURCES) $(HEADERS) $(TEXINFOS) $(EXTRA_DIST)
+
+TAR = tar
+GZIP_ENV = --best
+all: all-redirect
+.SUFFIXES:
+$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.in $(ACLOCAL_M4)
+ cd $(top_srcdir) && $(AUTOMAKE) --foreign --include-deps doc/Makefile
+
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+ cd $(top_builddir) \
+ && CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status
+
+tags: TAGS
+TAGS:
+
+
+distdir = $(top_builddir)/$(PACKAGE)-$(VERSION)/$(subdir)
+
+subdir = doc
+
+distdir: $(DISTFILES)
+ $(mkinstalldirs) $(distdir)/fonts $(distdir)/keymaps
+ @for file in $(DISTFILES); do \
+ d=$(srcdir); \
+ if test -d $$d/$$file; then \
+ cp -pr $$d/$$file $(distdir)/$$file; \
+ else \
+ test -f $(distdir)/$$file \
+ || ln $$d/$$file $(distdir)/$$file 2> /dev/null \
+ || cp -p $$d/$$file $(distdir)/$$file || :; \
+ fi; \
+ done
+info-am:
+info: info-am
+dvi-am:
+dvi: dvi-am
+check-am: all-am
+check: check-am
+installcheck-am:
+installcheck: installcheck-am
+install-exec-am:
+install-exec: install-exec-am
+
+install-data-am:
+install-data: install-data-am
+
+install-am: all-am
+ @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+install: install-am
+uninstall-am:
+uninstall: uninstall-am
+all-am: Makefile
+all-redirect: all-am
+install-strip:
+ $(MAKE) $(AM_MAKEFLAGS) AM_INSTALL_PROGRAM_FLAGS=-s install
+installdirs:
+
+
+mostlyclean-generic:
+
+clean-generic:
+
+distclean-generic:
+ -rm -f Makefile $(CONFIG_CLEAN_FILES)
+ -rm -f config.cache config.log stamp-h stamp-h[0-9]*
+
+maintainer-clean-generic:
+mostlyclean-am: mostlyclean-generic
+
+mostlyclean: mostlyclean-am
+
+clean-am: clean-generic mostlyclean-am
+
+clean: clean-am
+
+distclean-am: distclean-generic clean-am
+
+distclean: distclean-am
+
+maintainer-clean-am: maintainer-clean-generic distclean-am
+ @echo "This command is intended for maintainers to use;"
+ @echo "it deletes files that may require special tools to rebuild."
+
+maintainer-clean: maintainer-clean-am
+
+.PHONY: tags distdir info-am info dvi-am dvi check check-am \
+installcheck-am installcheck install-exec-am install-exec \
+install-data-am install-data install-am install uninstall-am uninstall \
+all-redirect all-am all installdirs mostlyclean-generic \
+distclean-generic clean-generic maintainer-clean-generic clean \
+mostlyclean distclean maintainer-clean
+
+
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/doc/README.acm b/doc/README.acm
new file mode 100644
index 0000000..f1e2b0c
--- /dev/null
+++ b/doc/README.acm
@@ -0,0 +1,43 @@
+16-bit screen-maps:
+-----------------
+
+ 16-bit screen-maps are used when the screen is in 8-bit mode (the default),
+to define the character-set used by applications, by telling the kernel how
+to interpret these 8-bit chars, in fact by telling to which Unicode character
+they should be mapped.
+
+ The following files are 16-bit screen maps generated from the file
+`UTF-tmpl.8bit', using the `2UTF' program:
+
+ iso{01,02..10} ISO 8859 charsets
+ cp437 IBM codepage 437 (corresponding to the
+ default PC font)
+ straight-to-font Maps all application characters directly to
+ the characters, using the straight-to-font
+ unicodes.
+
+
+8-bit screen-maps:
+-----------------
+
+ 8-bit screen maps should be considered obsolete, and should be rewritten as
+16-bit maps where needed. They are used to map the charset used by the
+application directly to the font in use, bypassing the unicode map describing
+the font. Thus, a new 8bit screen-map has to be set each time the font is
+changed.
+
+
+ The following are 8-bit screen-maps whose usefulness with current version of
+the console driver/tools has to be investigated:
+
+ null
+ space
+ zero
+
+
+ The following are 8-bit screen-maps which may still be useful to some users,
+but, as 8-bit maps, they will bypass the unicode map:
+
+ trivial obsoleted by `straight-to-font' (16-bit)
+ vga2iso
+ koi2alt
diff --git a/doc/README.iBook2.console-tools b/doc/README.iBook2.console-tools
new file mode 100644
index 0000000..45b36de
--- /dev/null
+++ b/doc/README.iBook2.console-tools
@@ -0,0 +1,38 @@
+Brief notes on the iBook2 keyboard
+
+The iBook2 keyboard, at least in the UK version, has certain idiosyncracies
+
+1. It is based on the standard (i386) layout (q=16, a=31, z=45), NOT the mac
+standard, but the keys at the edges of the keyboard are arranged with wilful
+idiosyncracy (e.g. ` and ~ on the key at the left of z), @ not " is on the 2
+key.
+
+2. It has unusual symbols, such as § and ±. There is also the euro symbol ¤
+on the 2 key. But there is no "regular" delete, only backspace, and no #.
+
+3. The num lock key changes the codes returned by the keys designated for
+the number pad, but does not itself transmit any code. Without special in
+the include file, I have not been able to use the numeric part of the
+number pad, although strangely enough the symbols such as + and / worked
+fine.
+
+
+The enclosed map has the following features
+
+1. # mapped to alt-gr ("apple") plus 3, and also alt plus 3.
+
+2. Delete at cursor mapped to alt-gr plus backspace.
+
+3. Compose key mapped to alt plus alt-gr, standard latin1 compose
+definitions, some work with a latin1 font, others need latin0 or latin9.
+
+
+Files:
+
+README.iBook2.console-tools this file
+
+iBook.keypad.gz keypad layout, for keymaps/mac/include
+
+mac-iBook2-uk.kmap.gz the main map file, for keymaps/mac/qwerty
+
+Ken Moffat \ No newline at end of file
diff --git a/doc/README.sfm b/doc/README.sfm
new file mode 100644
index 0000000..497d716
--- /dev/null
+++ b/doc/README.sfm
@@ -0,0 +1,11 @@
+The correspondences given in iso0[1-9].sfm are
+according to The Unicode Standard, Version 1.0, Vol. 1.
+
+Most of the remaining ones are phantasy.
+
+`ethiopic.sfm' is the one used by the `Agafari', `Goha', and `GohaClassic' fonts.
+
+`def.sfm' is the default one, used by the kernel on boot (codepage 437).
+
+`cp437.sfm' is basically quite similar with `def.sfm', but has some
+approximations defined, and a few mappings are a bit different.
diff --git a/doc/fonts/README b/doc/fonts/README
new file mode 100644
index 0000000..ceac46f
--- /dev/null
+++ b/doc/fonts/README
@@ -0,0 +1,75 @@
+Fragment of the "readme" file in Joel Hoffman's codepage.tar.Z
+==============================================================
+
+File readme. June 14, 1992.
+
+...
+I have included two sample fonts, one written by myself and the other
+by Dimitri Vulis (dlv@cunyvms1.BITNET). Both are in the public
+domain. My font, 972.cp, is a Hebrew font. The other is 880.cp, a
+Cyrilic font (Russian etc.).
+
+The Hebrew font uses the same encoding scheme as the VT-100's in
+Israel, so any software that works on those will now run on Linux
+(e.g., my hebrew.el package for GNU Emacs).
+
+I'm told 880.cp follows the relevent Russian standard, so I suppose it
+does.
+
+This package, while (c) 1992 by Joel M. Hoffman, can be used as freely
+as any other part of Linux.
+
+Files:
+ 972.cp Font data for 25-line Hebrew font.
+ 880.cp Font data for Cyrilic font.
+
+===========================================================
+
+Elsewhere I found fonts 880-14.psf, 880-16.psf, 972-14.psf, 972-16.psf,
+but these turn out to come from 880.cp and 972.cp, and since setfont
+now also understands *.cp files I deleted the four abovementioned fonts.
+
+===========================================================
+
+H. Peter Anvin writes:
+...
+I developed the Latin-1 *.psf fonts; Pavel Zaboj did the Latin-2
+ones. SLS took them directly from Pavel's national package.
+A DOS-hosted PSF font editor is available on eecs.nwu.edu.
+
+Daniel Quinlan sent a new version of lat1-16.psf due to hpa and him.
+
+Primoz Peterlin <peterlin@biofiz.mf.uni-lj.si> corrected lat2-??.psf.
+
+===========================================================
+
+The font default8x16 is from my hardware.
+Bruno Haible contributed def2_8x16.
+
+The fonts iso*.* are due to Kosta Kostis (kosta@blues.sub.de)
+and were obtained from
+ftp.uni-erlangen.de:pub/doc/ISO/charset/isofont101.tar.gz
+
+The fonts gr.* are due to Sarantos Kapidakis (sarantos@ics.forth.gr).
+He writes: "I am sending you the greek fonts, for 8x14 and 8x16.
+They follow the ELOT928 standard."
+
+Paul Gortmaker (paul@rasty.anu.edu.au) contributed ugly_l
+(which I removed again because now it can be found as 8x16alt
+in his collection of fonts kbd_fonts.tar.gz obtainable from
+sunsite.unc.edu:/pub/Linux/system/Keyboards/ and from
+tsx-11.mit.edu:/pub/linux/sources/system/ ).
+
+Some more fonts can be found in
+sunsite.unc.edu:/pub/Linux/system/Keyboards/fontpack.tgz
+
+Raul D. Miller (rockwell@nova.umd.edu) made aply16.psf.
+Angelos Karageorgiou (angelos@netaxis.com) contributed gr*.psf.
+Ahmed Naas (ahmed@oea.xs4all.nl) contributed 16[1-5].cp.
+Daniel Yacob contributed the Ethiopic fonts (see README.Ethiopic).
+Ricardas Cepas (rch@pub.osf.lt) contributed LatArCyrHeb-*.psf
+and the lat4* fonts.
+==============================================================
+
+aeb@cwi.nl
+
diff --git a/doc/fonts/README.Arabic b/doc/fonts/README.Arabic
new file mode 100644
index 0000000..1f854b9
--- /dev/null
+++ b/doc/fonts/README.Arabic
@@ -0,0 +1,8 @@
+Arabic fonts:
+
+iso06.* follows ISO 8859-6 (but does not contain the Arabic digits).
+ Only the isolated shapes are given.
+
+N.cp, N=161,162,163,164,165 - MS/DOS code pages with Arabic letters,
+ some line-drawing symbols, and some accented Latin characters.
+
diff --git a/doc/fonts/README.Cyrillic b/doc/fonts/README.Cyrillic
new file mode 100644
index 0000000..32a353d
--- /dev/null
+++ b/doc/fonts/README.Cyrillic
@@ -0,0 +1,49 @@
+Cyrillic fonts:
+
+Type A. Alt
+
+[Reference: codepage 866 (as given in Unicode 1.0, Vol 2, Appendix C).]
+The Alt fonts have the Cyrillic letters in the ranges
+0200-0237: capitals, 0240-0257,0340-0357: lower case,
+0360-0367: some additional letters.
+
+Here we have the alt* fonts (except that the positions 0362-0367 do not
+carry upper and lower case e, yi, short u).
+However, altc has some additional slavic characters
+(and fewer line drawing characters).
+
+Cyr_a8xN follows cp866 in the positions 0200-0257 and
+0340-0357. This means that upper and lower case io
+(cp866 codes 0360, 0361) are also missing.
+
+
+Type B. Koi8
+
+[Reference: RFC 1489]
+
+The koi8* fonts are the koi8 equivalents of the alt*
+fonts above; in particular, koi8c-8x16 also has
+additional slavic characters.
+
+koi8-14.psf follows koi8 in the positions 0300-0377
+(and has some iso-8859-5 symbols in 0240-0277,
+and yat, fita, izhitsa in 0200-0202, 0220-0222).
+In particular, it does not have the io and IO at
+0243, 0263.
+
+
+Type C. ISO 8859-5
+
+iso05.fN precisely follows iso-8859-5 in all positions
+where that norm defines a symbol.
+It has no symbols in the range 0200-0237.
+
+880.cp follows iso-8859-5 in the positions 0240-0377
+except that the four symbols 0244, 0364, 0371, 0372
+[Ukrainian Cyrillic letter ie (upper and lower case),
+and Cyrillic small letter lje, nje] are missing.
+It has a few old Russian symbols in the range 0200-0202,
+0220-222 (yat, fita, izhitsa).
+Thus, in spite of its name it has very little to do
+with the ibm cp880 (as described in GNU recode).
+
diff --git a/doc/fonts/README.Ethiopic b/doc/fonts/README.Ethiopic
new file mode 100644
index 0000000..7502722
--- /dev/null
+++ b/doc/fonts/README.Ethiopic
@@ -0,0 +1,30 @@
+Ethiopic fonts:
+
+ o All fonts contain 353 Ethiopic characters which extends the Unicode
+ specification by 7 characters (extras are relegated to the private use
+ range).
+
+ o Contain their own Unicode mapping table corresponding to "ethiopic.uni"
+ which should be in your "consoletrans" directory.
+
+ o Sizes 14 & 16 are prefixed by 159 Latin characters from iso01.f14 &
+ iso01.f16. Size 12 fonts borrow Latin characters from lat1-12.psf.
+
+ o Are redistributable under the GNU GPL version 2.0; with noted
+ restrictions below:
+
+
+Agafari:
+ Donated by the Ethiopian Science and Technology Commission
+ <ncic@padis.gn.apc.org> or <ncic@telecom.net.et> and may be redistributed
+ for non-commercial use under Unix environments only.
+
+Goha and GohaClassic:
+ Donated by Yitna Firdyiwek <ybf2u@virgina.edu> of GohaTibeb Associates
+ and may be redistributed without restriction under the GNU GPL 2.0.
+
+
+The collection in this directory donated for Linux distributions is otherwise
+maintained by Daniel Yacob <Daniel_Yacob_at_UNECA@un.org> and
+<yacob@padis.gn.apc.org>.
+
diff --git a/doc/fonts/README.Greek b/doc/fonts/README.Greek
new file mode 100644
index 0000000..85aab8e
--- /dev/null
+++ b/doc/fonts/README.Greek
@@ -0,0 +1,8 @@
+Greek fonts:
+
+iso07.* follows ISO 8859-7.
+
+737.cp - the MS/DOS code page 737.
+
+greek.psf and the files gr8x*.psf are very similar, but replace
+ I-diaeresis, Y-diaeresis by integral (upper and lower half).
diff --git a/doc/fonts/README.Hebrew b/doc/fonts/README.Hebrew
new file mode 100644
index 0000000..6cb71f2
--- /dev/null
+++ b/doc/fonts/README.Hebrew
@@ -0,0 +1,6 @@
+Hebrew fonts:
+
+iso08.* follows ISO 8859-8.
+
+972.cp has the Hebrew letters in the same positions, and adds
+ the (isolated) vowels.
diff --git a/doc/fonts/README.Sun b/doc/fonts/README.Sun
new file mode 100644
index 0000000..568969f
--- /dev/null
+++ b/doc/fonts/README.Sun
@@ -0,0 +1,23 @@
+Sun fonts:
+==============
+lat0-sun16.psf
+lat2-sun16.psf
+
+these are fonts which have uniform look and feel compatible with the builtin
+sun font all sparclinux boxes used to have from beginning (currently it is
+font_sun8x16 in fbcon), but add characters for latin0, latin1 and latin2.
+lat0-sun16.psf contains all latin1, latin0 (like latin1, but contains Euro,
+z<, Z<, s<, S<, Y: instead of some useless characters), VT100 linedrawing
+characters and as many as possible CP850 characters, lat2-sun16.psf contains
+full latin2 character set, VT100 linedrawing and most of CP850 characters
+that fit in.
+To use these fonts, you should load the ACM mapping of your desired coding,
+e.g. iso01.acm for latin1, iso15.acm for latin0 with lat0-sun16.psf and
+iso02.acm or iso02+euro.acm (the latter is a hack which just replaces the
+useless currency symbol with Euro, I don't know if anybody is going to
+standardize some ISO character set with CE characters and Euro at the same
+time).
+The linedrawing characters are put into the range VGA displays should paint
+it correctly, so the font should be useful outside of sun boxes as well.
+
+ Jakub Jelinek <jj@ultra.linux.cz>
diff --git a/doc/fonts/fonts.magic b/doc/fonts/fonts.magic
new file mode 100644
index 0000000..ebcade6
--- /dev/null
+++ b/doc/fonts/fonts.magic
@@ -0,0 +1,54 @@
+#
+# PC Screen (console) Fonts
+#
+0 leshort 0x0436 Linux PC Screen Font data,
+>2 byte 0 256 characters, no Unicode map
+>2 byte 1 512 characters, no Unicode map
+>2 byte 2 256 characters, Unicode map
+>2 byte 3 512 characters, Unicode map
+
+#
+# CPI fonts
+#
+# MS-DOS
+1 string FONT\ \ \ MS-DOS Code Page Information,
+>23 uleshort x %u fonts
+
+>41 uleshort x (CP %u,
+>31 uleshort 1 screen
+>31 uleshort 2 printer
+# try to optimize display...
+>37 byte 32 driver
+>>33 string >\0 %.4s
+>37 byte >32 driver
+>>33 string >\0 %.8s
+
+>49 ulelong 0 )
+>49 ulelong >0 ; ...)
+
+# DR-DOS
+1 string DRFONT\ DR-DOS Code Page Information.
+
+#
+# CP fonts
+#
+6 string \001\000EGA\ \ \ \ \ CP font for Linux's setfont(1) (
+>0 leshort 28
+>>30 uleshort 3
+>>>32 uleshort 9746 maybe not
+>0 byte x unusable )
+
+6 string \001\000VIDEO\ \ \ CP font for Linux's setfont(1) (
+>0 leshort 28
+>>30 uleshort 3
+>>>32 uleshort 9746 maybe not
+>0 byte x unusable )
+
+#
+# XPSF fonts - this entry should not be inserted into /etc/magic yet.
+#
+0 leshort 0x0536 Linux Extended PC Screen Font data,
+>2 uleshort x file-format version %d,
+>4 uleshort x requires reader to understand at least version %d,
+>8 ulelong x %d characters,
+>12 uleshort x %d sections.
diff --git a/doc/keymaps/README b/doc/keymaps/README
new file mode 100644
index 0000000..06bc069
--- /dev/null
+++ b/doc/keymaps/README
@@ -0,0 +1,31 @@
+These maps are as contributed. Use at your own risk.
+(But please tell me if something is seriously wrong.)
+Mail corrections, improvements and new maps to:
+
+ <dirson@debian.org> for inclusion in the LCT package.
+ <aeb@cwi.nl> for inclusion in the original `kbd' package.
+
+-----
+
+Several corrections were pointed out by Tom.Kartes@Materna.DE.
+
+mk_modmap is a utility that might help synchronizing
+your keymaps for loadkeys and for xmodmap (but note that
+(since version 2.1 of XFree86) X initialises its keymap using
+the Linux keymap, so that xmodmap will often be superfluous).
+
+Since version 0.87, put a line `charset "iso-8859-x"' in front
+of a map, when you are using symbols outside iso-8859-1.
+
+Since version 0.88, put a line `keymaps 0-1,4-5,8,12' or so
+in front of a map, in order to indicate what keymaps should
+be used.
+
+hypermap.m4 was contributed by shields@tembel.org (Michael Shields).
+Use: m4 hypermap.m4 | loadkeys .
+
+Please, if you submit something that includes compose key
+combinations, uuencode the keymap, since SMTP-compliant
+mailers will strip the eighth bit.
+
+[originally written by Andries]
diff --git a/doc/keymaps/README.sparc b/doc/keymaps/README.sparc
new file mode 100644
index 0000000..42c1c20
--- /dev/null
+++ b/doc/keymaps/README.sparc
@@ -0,0 +1,117 @@
+
+1. SUPPORTED KEYBOARDS
+
+List of supported keyboards:
+
+Sun Type 5:
+ sunt5-es.kmap
+ sunt5-de-latin1.kmap (Contributed by Wolfgang Szöcs <wolfi@tfh-berlin.de>)
+ sunt5-fi-latin1.kmap ( by Riku Meskanen <mesrik@cc.jyu.fi>)
+ sunt5-ru.kmap ( by Alexander V. Lukyanov <lav@video.yars.free.net>)
+ sunt5-uk.kmap ( by Steven Brookes <stevejb@eos18.eos.co.uk>)
+
+Sun Type 4:
+ sunt4-es.kmap ( By Antoni Pàmies Olivé <toni@readysoft.net>)
+
+The other keymaps provided with this package are the original PC ones and are
+included just for reference when creating new ones.
+DO NOT TRY TO LOAD THEM. THEY WILL MAKE YOUR KEYBOARD COMPLETELY UNUSABLE.
+
+Don't forget to check that /etc/sysconfig/keyboard contains the right
+definition. The kbdconfig utility will do it for you. It should be found
+at the same place where you got this package as kbdconfig-1.3-1.sparc.rpm.
+
+Please, send new maps to <eduardo@medusa.es>, so I can include them in new
+releases of this package.
+
+
+
+2. HOW TO CREATE KEYBOARD MAPS
+
+NOTE: Please, send additions, comments and corrections (of ANY kind) to the
+ address above.
+
+2.1 The Hard Way (TM)
+
+ First, execute the dumpkeys command to create a first working keymap:
+
+ $ dumpkeys > sunt5-lang.kmap
+
+ Then, press every key to check if the console shows the symbol it is supposed
+ to. If not, search for the offending keycode into the sunt5-lang.kmap file and
+ change its keysyms to the real ones. (You can get the keycodes using showkey).
+
+ Please read the documentation accompanying this package and check the
+ sunt5-* and PC keymaps provided with this RPM (specially the ones for your
+ native language) if you have any doubt.
+
+2.2 The Easy Way
+
+ Choose one of the provided PC keymaps for your language and do the following:
+
+ $ pc2sun.pl lang.kmap > sunt5-lang.kmap
+
+ Check the file sunt5-lang.kmap as explained in 2.1.
+
+ (pc2sun.pl should work very well in most cases. For the Spanish keyboard,
+ only two keys were misplaced, due to some special characteristics of the
+ Spanish PC keyboard)
+
+
+
+3. CHANGELOG
+
+Release 0.94-1 (16 May 97)
+
+ * kbd-0.94. Andries Brouwer has included most of the SPARC specific code
+ in this version.
+
+Release 0.93-1 (27 Apr 97)
+
+ * Merged to Andries Brouwer's kbd-0.93
+
+ * Added sunt5-uk.kmap keymap.
+
+ * Small fix to sunt5-ru.kmap (Alexander V. Lukyanov)
+
+Release 0.91-12 (18 Jan 97)
+
+ * Added Antoni's sunt4-es.kmap
+
+Release 0.91-11 (13 Jan 97)
+
+ * WARNING WARNING WARNING
+ This was compiled by Antoni Pàmies Olivé <toni@readysoft.net> with a Type 4
+ keymap for Spanish and Catalan.
+
+ This release is NOT complete and won't install the init scripts, for
+ example.
+
+ I won't answer any question about it. Install Release 12 or higher or ask
+ Antoni directly if you have any problems with this one.
+
+Release 0.91-10 (12 Jan 97)
+
+ * Added pc2sun.pl (Thanks to Derrick J Brashear <shadow@dementia.org>)
+
+ * Replaced defkeymap.kmap with system's sunkeymap.kmap (Thanks to Riku Meskanen)
+
+ * Added sunt5-fi-latin1.kmap and sunt5-ru.kmap
+
+ * Improved README.sparc
+
+
+Release 0.91-9a (27 Oct 96)
+
+ * Fixed serious bug in setfont
+
+
+Release 0.91-9 (26 Oct 96)
+
+ * First version for Linux/SPARC with Spanish and German keyboards support.
+ (Same as RedHat kbd-0.91-9 for i386 with Sparc-specific patches)
+
+
+Eduardo Casino
+
+
diff --git a/doc/keymaps/hypermap.m4 b/doc/keymaps/hypermap.m4
new file mode 100644
index 0000000..8083c49
--- /dev/null
+++ b/doc/keymaps/hypermap.m4
@@ -0,0 +1,475 @@
+#
+# hypermap.map 1994/11/11
+# Michael Shields <shields@tembel.org>
+#
+# A keymap redesigned for sanity.
+#
+
+#
+# This keymap is a ground-up reimplementation of the keyboard map,
+# intended to be consistent and rational. It uses an m4 metalanguage to
+# declare the key mappings. Usage is `m4 hypermap.map | loadkeys'.
+#
+# The modifier flags used are `shift' (1), `control' (4), and `alt' (8).
+# Left and right modifiers are not distinguished.
+#
+# In general, Meta is always distinguished, and M-S-KEY is distinct from
+# M-KEY. This is good news for Emacs users. C-S-KEY is consistently
+# folded into C-KEY.
+#
+# Shift is more loosely interpreted than the other modifiers; usually if
+# S-KEY has no special meaning, the action will be the same as KEY.
+# However, if M-KEY or H-KEY is undefined, nothing happens.
+#
+# Because Caps Lock's position is so out of proportion to its utility,
+# it's been totally redefined to a new sort of modifier, which I've
+# arbitrarily named `Hyper'. Shift is ignored with Hyper. Hyper
+# provides dead keys:
+# H-` dead accent grave
+# H-' dead acute accent
+# H-^ dead circumflex
+# H-t dead tilde
+# H-d dead diaeresis
+# and ISO-8859-1 symbols (some more mnemonic than others):
+# H-SPC nobreakspace
+# H-! inverted bang
+# H-h cents (`hundredths')
+# H-# pounds sterling
+# H-$ currency
+# H-y yen
+# H-| broken bar
+# H-s section (the galaxy symbol)
+# H-c copyright
+# H-a feminine ordinal
+# H-< left guillemot
+# H-] not sign (it's angular)
+# H-- soft hyphen
+# H-r registered trademark symbol
+# H-= macron
+# H-0 degrees
+# H-[ plus/minus (near + and -)
+# H-k superior 2 (jkl form a series)
+# H-l superior 3
+# H-u mu
+# H-p pilcrow
+# H-: centered dot
+# H-j superior 1
+# H-o masculine ordinal
+# H-> right guillemot
+# H-q 1/4 fraction (qwe form a series)
+# H-w 1/2 fraction
+# H-e 3/4 fraction
+# H-? inverted question mark
+# H-x multiplication symbol
+# H-% division symbol
+# You can also use Hyper plus Alt to type characters by decimal code on
+# the keypad, as with Alt alone, or in hex on the main keyboard. And
+# H-TAB is a Caps Lock.
+#
+# Function keys work as marked, unless with Alt, in which case they
+# switch to the console with the same number. Shift adds 12 and Hyper
+# adds 24 to the numbers (i.e., they logically switch to other banks).
+# Thus you can easily address up to 48. Control is ignored, for
+# consistency with X.
+#
+# Finally, you can change the behavior of the Caps Lock and Controls
+# with m4 command-line options. The default values are equivalent to
+# `-DCAPSLOCK_K=Hyper -DLEFTCTRL_K=Control -DRIGHTCTRL_K=Control'. You
+# can remove the Hyper code entirely with `-DCAPSLOCK_K=Caps_Lock'.
+#
+# This file is arranged vaguely by key position on the classic PC layout.
+#
+
+
+dnl Set default values.
+ifdef(`CAPSLOCK_K', , `define(`CAPSLOCK_K', `Hyper')')
+ifdef(`LEFTCTRL_K', , `define(`LEFTCTRL_K', `Control')')
+ifdef(`RIGHTCTRL_K', , `define(`RIGHTCTRL_K', `Control')')
+
+dnl Figure out if any key is a Hyper key. If so, define `hyper', both
+dnl for usefulness and `ifdef' testability.
+ifelse(CAPSLOCK_K, `Hyper', `define(`hyper', `ctrlr')',
+ LEFTCTRL_K, `Hyper', `define(`hyper', `ctrlr')',
+ RIGHTCTRL_K, `Hyper', `define(`hyper', `ctrlr')')
+
+define(`Hyper', `CtrlR')
+
+
+keymaps 0,1,4,5,8,9,12,13`'ifdef(`hyper', `,128,129,132,133,136,137,140,141')
+
+
+dnl General usage of these macros is MACRO(KEYCODE, UNSHIFTED, SHIFTED).
+
+dnl We first undefine `shift', which only causes problems.
+undefine(`shift')
+
+define(`SIMPLE', `keycode $1 = $2 $2')
+
+define(`KEY',
+` keycode $1 = $2 VoidSymbol
+shift keycode $1 = $3
+ alt keycode $1 = Meta_$2
+shift alt keycode $1 = Meta_$3')
+
+dnl This macro adds Control variations to a key.
+define(`CONTROL',
+` control keycode $1 = $2
+shift control keycode $1 = $2
+ control alt keycode $1 = Meta_$2
+shift control alt keycode $1 = Meta_$2')
+
+dnl Add Hyper variations to a key.
+define(`HYPER', ifdef(`hyper',
+` hyper keycode $1 = $2
+shift hyper keycode $1 = $2'))
+define(`CONTROLHYPER', ifdef(`hyper',
+` control hyper keycode $1 = $2
+shift control hyper keycode $1 = $2'))
+define(`METAHYPER', ifdef(`hyper',
+` alt hyper keycode $1 = $2
+shift alt hyper keycode $1 = $2'))
+define(`CONTROLMETAHYPER', ifdef(`hyper', dnl Ludicrous.
+` control alt hyper keycode $1 = $2
+shift control alt hyper keycode $1 = $2'))
+
+dnl Special case for letters. Best to be explicit.
+define(`LETTER',
+` keycode $1 = `+'$2 VoidSymbol
+shift keycode $1 = `+'translit($2, `a-z', `A-Z')
+ alt keycode $1 = `Meta_'$2
+shift alt keycode $1 = `Meta_'translit($2, `a-z', `A-Z')
+CONTROL($1, Control_$2)')
+
+dnl For function keys. Call here is FUNCTION(KEYCODE, FKEYNUM).
+define(`BANKSIZE', 12)
+define(`FUNCTION',
+` keycode $1 = `F'$2 VoidSymbol
+shift keycode $1 = `F'eval($2 + BANKSIZE)
+ hyper keycode $1 = `F'eval($2 + BANKSIZE * 2)
+shift hyper keycode $1 = `F'eval($2 + BANKSIZE * 3)
+ alt keycode $1 = `Console_'$2
+shift alt keycode $1 = `Console_'eval($2 + BANKSIZE)
+ hyper alt keycode $1 = `Console_'eval($2 + BANKSIZE * 2)
+shift hyper alt keycode $1 = `Console_'eval($2 + BANKSIZE * 3)')
+
+dnl For the keypad digits. KPDIGIT(KEYCODE, DIGIT).
+define(`KPDIGIT',
+` keycode $1 = KP_$2 VoidSymbol
+shift keycode $1 = KP_$2
+ alt keycode $1 = Ascii_$2
+shift alt keycode $1 = Ascii_$2
+METAHYPER($1, Ascii_$2)')
+
+dnl And a special approximation:
+define(`Meta_Return', `Meta_Control_m')
+
+
+KEY(1, Escape, Escape)
+
+FUNCTION(59, 1)
+FUNCTION(60, 2)
+FUNCTION(61, 3)
+FUNCTION(62, 4)
+FUNCTION(63, 5)
+FUNCTION(64, 6)
+FUNCTION(65, 7)
+FUNCTION(66, 8)
+FUNCTION(67, 9)
+FUNCTION(68, 10)
+FUNCTION(87, 11)
+FUNCTION(88, 12)
+
+KEY(2, one, exclam)
+ HYPER(2, exclamdown)
+ METAHYPER(2, Hex_1)
+KEY(3, two, at)
+ CONTROL(3, nul)
+ METAHYPER(3, Hex_2)
+KEY(4, three, numbersign)
+ HYPER(4, pound)
+ METAHYPER(4, Hex_3)
+KEY(5, four, dollar)
+ HYPER(5, currency)
+ METAHYPER(5, Hex_4)
+KEY(6, five, percent)
+ HYPER(6, division)
+ METAHYPER(6, Hex_5)
+KEY(7, six, asciicircum)
+ CONTROL(7, Control_asciicircum)
+ HYPER(7, dead_circumflex)
+ METAHYPER(7, Hex_6)
+KEY(8, seven, ampersand)
+ METAHYPER(8, Hex_7)
+KEY(9, eight, asterisk)
+ METAHYPER(9, Hex_8)
+KEY(10, nine, parenleft)
+ METAHYPER(10, Hex_9)
+KEY(11, zero, parenright)
+ HYPER(11, degree)
+ METAHYPER(11, Hex_0)
+KEY(12, minus, underscore)
+ CONTROL(12, Control_underscore)
+ HYPER(12, hyphen)
+KEY(13, equal, plus)
+ HYPER(13, macron)
+KEY(14, Delete, Delete)
+ CONTROL(14, BackSpace)
+
+KEY(15, Tab, Tab)
+ HYPER(15, Caps_Lock)
+LETTER(16, q)
+ HYPER(16, onequarter)
+LETTER(17, w)
+ HYPER(17, onehalf)
+LETTER(18, e)
+ HYPER(18, threequarters)
+ METAHYPER(18, Hex_E)
+LETTER(19, r)
+ HYPER(19, registered)
+LETTER(20, t)
+ HYPER(20, dead_tilde)
+LETTER(21, y)
+ HYPER(21, yen)
+LETTER(22, u)
+ HYPER(22, mu)
+LETTER(23, i)
+LETTER(24, o)
+ HYPER(24, masculine)
+LETTER(25, p)
+ HYPER(25, 182) # pilcrow
+KEY(26, bracketleft, braceleft)
+ CONTROL(26, Escape)
+ HYPER(26, plusminus)
+KEY(27, bracketright, braceright)
+ CONTROL(27, Control_bracketright)
+ HYPER(27, notsign)
+
+KEY(28, Return, Return)
+
+LETTER(30, a)
+ HYPER(30, ordfeminine)
+ METAHYPER(30, Hex_A)
+LETTER(31, s)
+ HYPER(31, section)
+LETTER(32, d)
+ HYPER(32, dead_diaeresis)
+ METAHYPER(32, Hex_D)
+LETTER(33, f)
+ METAHYPER(33, Hex_F)
+LETTER(34, g)
+LETTER(35, h)
+ HYPER(35, cent)
+LETTER(36, j)
+ HYPER(36, onesuperior)
+LETTER(37, k)
+ HYPER(37, twosuperior)
+LETTER(38, l)
+ HYPER(38, threesuperior)
+KEY(39, semicolon, colon)
+ HYPER(39, periodcentered)
+KEY(40, apostrophe, quotedbl)
+ HYPER(40, dead_acute)
+KEY(41, grave, asciitilde)
+ HYPER(41, dead_grave)
+
+KEY(43, backslash, bar)
+ CONTROL(43, Control_backslash)
+ HYPER(43, brokenbar)
+LETTER(44, z)
+LETTER(45, x)
+ HYPER(45, multiplication)
+LETTER(46, c)
+ HYPER(46, copyright)
+ METAHYPER(46, Hex_C)
+LETTER(47, v)
+LETTER(48, b)
+ METAHYPER(48, Hex_B)
+LETTER(49, n)
+LETTER(50, m)
+KEY(51, comma, less)
+ HYPER(51, guillemotleft)
+KEY(52, period, greater)
+ HYPER(52, guillemotright)
+KEY(53, slash, question)
+ HYPER(53, questiondown)
+
+KEY(57, space, space)
+ CONTROL(57, nul)
+ HYPER(57, nobreakspace)
+
+KPDIGIT(71, 7)
+KPDIGIT(72, 8)
+KPDIGIT(73, 9)
+SIMPLE(74, KP_Subtract)
+KPDIGIT(75, 4)
+KPDIGIT(76, 5)
+KPDIGIT(77, 6)
+SIMPLE(78, KP_Add)
+KPDIGIT(79, 1)
+KPDIGIT(80, 2)
+KPDIGIT(81, 3)
+KPDIGIT(82, 0)
+SIMPLE(83, KP_Period)
+SIMPLE(96, KP_Enter)
+SIMPLE(98, KP_Divide)
+SIMPLE(55, KP_Multiply)
+SIMPLE(118, KP_MinPlus)
+
+# Modifiers.
+keycode 42 = Shift
+keycode 54 = Shift
+keycode 56 = Alt
+keycode 100 = Alt
+keycode 58 = CAPSLOCK_K
+keycode 29 = LEFTCTRL_K
+keycode 97 = RIGHTCTRL_K
+
+# Everyone needs a compose key. This is C-..
+control keycode 52 = Compose
+
+SIMPLE(69, Num_Lock)
+
+keycode 70 = Scroll_Lock
+ shift keycode 70 = Show_Memory
+ control keycode 70 = Show_State
+ alt keycode 70 = Show_Registers
+
+# SysRq. I suppose there's some reason it's ^\.
+SIMPLE(99, Control_backslash)
+
+SIMPLE(119, Pause)
+# Ctrl-Break seems to have low-level hardware behind it.
+SIMPLE(101, Break)
+
+SIMPLE(110, Insert)
+SIMPLE(102, Find)
+keycode 104 = Prior Scroll_Backward
+SIMPLE(111, Remove)
+SIMPLE(107, Select)
+keycode 109 = Next Scroll_Forward
+
+SIMPLE(103, Up)
+SIMPLE(105, Left)
+alt keycode 105 = Decr_Console
+SIMPLE(106, Right)
+alt keycode 106 = Incr_Console
+SIMPLE(108, Down)
+
+control alt keycode 83 = Boot
+control alt keycode 111 = Boot
+
+
+# Stock VT102 string definitions.
+string F1 = "\033[[A"
+string F2 = "\033[[B"
+string F3 = "\033[[C"
+string F4 = "\033[[D"
+string F5 = "\033[[E"
+string F6 = "\033[17~"
+string F7 = "\033[18~"
+string F8 = "\033[19~"
+string F9 = "\033[20~"
+string F10 = "\033[21~"
+string F11 = "\033[23~"
+string F12 = "\033[24~"
+string F13 = "\033[25~"
+string F14 = "\033[26~"
+string F15 = "\033[28~"
+string F16 = "\033[29~"
+string F17 = "\033[31~"
+string F18 = "\033[32~"
+string F19 = "\033[33~"
+string F20 = "\033[34~"
+string Find = "\033[1~"
+string Insert = "\033[2~"
+string Remove = "\033[3~"
+string Select = "\033[4~"
+string Prior = "\033[5~"
+string Next = "\033[6~"
+string Macro = "\033[M"
+string Pause = "\033[P"
+
+# Stock ISO-8859-1 compositions.
+changequote()dnl
+compose '`' 'A' to 'À'
+compose '`' 'a' to 'à'
+compose '\'' 'A' to 'Á'
+compose '\'' 'a' to 'á'
+compose '^' 'A' to 'Â'
+compose '^' 'a' to 'â'
+compose '~' 'A' to 'Ã'
+compose '~' 'a' to 'ã'
+compose '"' 'A' to 'Ä'
+compose '"' 'a' to 'ä'
+compose 'O' 'A' to 'Å'
+compose 'o' 'a' to 'å'
+compose '0' 'A' to 'Å'
+compose '0' 'a' to 'å'
+compose 'A' 'A' to 'Å'
+compose 'a' 'a' to 'å'
+compose 'A' 'E' to 'Æ'
+compose 'a' 'e' to 'æ'
+compose ',' 'C' to 'Ç'
+compose ',' 'c' to 'ç'
+compose '`' 'E' to 'È'
+compose '`' 'e' to 'è'
+compose '\'' 'E' to 'É'
+compose '\'' 'e' to 'é'
+compose '^' 'E' to 'Ê'
+compose '^' 'e' to 'ê'
+compose '"' 'E' to 'Ë'
+compose '"' 'e' to 'ë'
+compose '`' 'I' to 'Ì'
+compose '`' 'i' to 'ì'
+compose '\'' 'I' to 'Í'
+compose '\'' 'i' to 'í'
+compose '^' 'I' to 'Î'
+compose '^' 'i' to 'î'
+compose '"' 'I' to 'Ï'
+compose '"' 'i' to 'ï'
+compose '-' 'D' to 'Ð'
+compose '-' 'd' to 'ð'
+compose '~' 'N' to 'Ñ'
+compose '~' 'n' to 'ñ'
+compose '`' 'O' to 'Ò'
+compose '`' 'o' to 'ò'
+compose '\'' 'O' to 'Ó'
+compose '\'' 'o' to 'ó'
+compose '^' 'O' to 'Ô'
+compose '^' 'o' to 'ô'
+compose '~' 'O' to 'Õ'
+compose '~' 'o' to 'õ'
+compose '"' 'O' to 'Ö'
+compose '"' 'o' to 'ö'
+compose '/' 'O' to 'Ø'
+compose '/' 'o' to 'ø'
+compose '`' 'U' to 'Ù'
+compose '`' 'u' to 'ù'
+compose '\'' 'U' to 'Ú'
+compose '\'' 'u' to 'ú'
+compose '^' 'U' to 'Û'
+compose '^' 'u' to 'û'
+compose '"' 'U' to 'Ü'
+compose '"' 'u' to 'ü'
+compose '\'' 'Y' to 'Ý'
+compose '\'' 'y' to 'ý'
+compose 'T' 'H' to 'Þ'
+compose 't' 'h' to 'þ'
+compose 's' 's' to 'ß'
+compose '"' 'y' to 'ÿ'
+compose 's' 'z' to 'ß'
+compose 'i' 'j' to 'ÿ'
+
+# ISO-8859-3 compositions for Esperanto.
+compose 'C' 'x' to 'Æ' #198
+compose 'G' 'x' to 'Ø' #216
+compose 'H' 'x' to '¦' #166
+compose 'J' 'x' to '¬' #172
+compose 'S' 'x' to 'Þ' #222
+compose 'U' 'x' to 'Ý' #221
+compose 'c' 'x' to 'æ' #230
+compose 'g' 'x' to 'ø' #248
+compose 'h' 'x' to '¶' #182
+compose 'j' 'x' to '¼' #188
+compose 's' 'x' to 'þ' #254
+compose 'u' 'x' to 'ý' #253
diff --git a/doc/keymaps/no-latin1.doc b/doc/keymaps/no-latin1.doc
new file mode 100644
index 0000000..337d718
--- /dev/null
+++ b/doc/keymaps/no-latin1.doc
@@ -0,0 +1,50 @@
+/usr/lib/kbd/keymaps/i386/qwerty/no-latin1.map
+
+This generally conforms to the keycaps on my keyboard.
+I have deviated a little to make it more useful in a Unix
+environment, e.g. the tilde is not "hidden away" and dead.
+
+Here's a list of the dead keys:
+
+ ----
+ |$¼| dollar and currency
+ |4¤| have switched places
+ ----
+
+ ---- --------------------------
+ |``| added dead grave: | backtick | dead grave |
+ |\'| | backslash | dead acute |
+ ---- --------------------------
+
+ ---- --------------------------
+ |^~| moved dead | caret | dead tilde |
+ |~¨| diaeresis: | tilde | dead diaeresis |
+ ---- --------------------------
+
+ ---- --------------------------------
+ |*×| added dead | asterisk | multiply |
+ |'^| circumflex: | apostrophe | dead circumflex |
+ ---- --------------------------------
+
+In addition special characters have been added to the alphanumerics
+when it seemed natural:
+
+ §¶ !¹ "² #³ $¼ %½ &¾ /÷ ( ) = ?¿ ``
+ |¦ 1¡ 2@ 3£ 4¤ 5½ 6¾ 7{ 8[ 9] 0} +± \'
+
+ Q W EÉ R TÞ Y UÜ IÏ OÒ P Å] ^~
+ q w eé r® tþ yÿ uü iï oò p¶ å} ~¨
+
+ AÁ S DÐ Fª G H J K L Ø\ Æ[ *×
+ aá sß dð fª g h j k l ø| æ{ '^
+
+ >» Z X C© V B NÑ Mº ;« :» _
+ <« z x× cç v b nñ mµ ,¸ .· -­
+
+ Space NoBreakSpace
+ Space NoBreakSpace
+
+Send comments to Kjetil T. Homme <kjetilho@ifi.uio.no>
+
+[ These characters can not be typed directly with the keyboard:
+ cent notsign macron degree acute(bug) diaeresis(bug) Ccedilla ]
diff --git a/doc/keymaps/se.readme b/doc/keymaps/se.readme
new file mode 100644
index 0000000..e1a888f
--- /dev/null
+++ b/doc/keymaps/se.readme
@@ -0,0 +1,2 @@
+The swedish maps are identical to the finnish ones.
+Use fi*.map.