Table of Contents
=================

1. What is SKK?
2. Files
3. Installation
4. Personal setting
5. SKK Mailing List

1. What is SKK?
===============

SKK is a very fast and efficient Japanese input system written entirely in
emacs lisp and runs under Nemacs (which is a Japanese version of
GNU Emacs, developed by Mr. Ken'ichi Handa <handa@etl.go.jp> et al.),
under Mule (which is a Multi-lingual version of GNU Emacs, also
developed by Mr. Ken'ich Hand et al.) and under Demacs (which is a DOS
version of GNU Emacs developed by Manabu Higashida
<manabu@sigmath.osaka-u.ac.jp> and HIRANO Satoshi
<hirano@tkl.iis.u-tokyo.ac.jp>).

The author of skk.el and other emacs lisp libraries is Masahiko Sato
(masahiko@sato.riec.tohoku.ac.jp) and the author of skkserv.c is
Yukiyoshi Kameyama (kam@sato.riec.tohoku.ac.jp).

SKK is free software distributed under the terms of the GNU General
Public License.

ReadMe and SKK.tex explain SKK in more details.

2. Files
========

This package contains SKK 8.6 and consists of the following files:

	COPYING
	Configure
	Configure.euc
	List-of-Files
	Makefile
	ReadMe
	ReadMe.English
	SKK-JISYO.JIS2
	SKK-JISYO.L
	SKK-JISYO.M
	SKK-JISYO.S
	SKK.tut
	SKK.tut.E
	emacs-sort
	jisyo-tools/Makefile
	jisyo-tools/README
	jisyo-tools/skkjisyo-entries.c
	jisyo-tools/skkjisyo-expr.c
	jisyo-tools/skkjisyo-sort.c
	latexinfo.el
	latexinfo.sty
	skk
	skk-is-m.el
	skk-is-n.el
	skk-romkan.tex
	skk-tools.el
	skk-tut.el
	skk.el
	skk.ps
	skk.tex
	skkserv/Makefile
	skkserv/README
	skkserv/add-rc.local
	skkserv/add-services
	skkserv/skkserv.c
	skkserv/skkserv.h
	skktools/Makefile
	skktools/READ.ME
	skktools/README
	skktools/adddummy.t
	skktools/alpha-kana.pl
	skktools/atok2skk.pl
	skktools/codeconv.pl
	skktools/convprog.t
	skktools/kana2roma.pl
	skktools/list2skk.t
	skktools/pubdic2list.t
	skktools/removedummy.t
	skktools/roma2kana.pl
	skktools/skk2list.t
	skktools/skkconv.t
	skktools/sub.t
	skktools/wx2skk.pl
	tabular.sty

3. Installation
===============

Run Configure.euc in this directory and follow the instructions.  If
you can become a superuser, then login as root and run the configure
file.

4.  Personal setting
====================

There are two ways to use the common dictionary (SKK-JISYO.L):

	(i)  Read in the dictionary into an Emacs buffer.
	(ii) Use the SKK dictionary server.

If you will be using the common dictionary by method (i) then follow
the steps described in 4.1, and if not, follow the steps described in
4.2.

4.1
---

[i-1] Add the following lines to your .emacs file:

        (global-set-key "\C-x\C-j" 'skk-mode)
        (global-set-key "\C-xj" 'skk-auto-fill-mode)
        (global-set-key "\C-xJ" 'register-to-point)
        (global-set-key "\C-xt" 'skk-tutorial)
        (autoload 'skk-mode "skk" nil t)
        (autoload 'skk-tutorial "skk-tut" nil t)
        (autoload 'skk-check-jisyo "skk-tools" nil t)
        (autoload 'skk-merge "skk-tools" nil t)
        (autoload 'skk-diff "skk-tools" nil t)

Moreover, if you are going to run skk under Nemacs or Mule based on
Emacs version 18, then add the following lines to .emacs

        (global-set-key "\C-s" 'skk-isearch-forward)
        (global-set-key "\C-r" 'skk-isearch-backward)
        (autoload 'skk-isearch-forward "skk-isearch" nil t)
        (autoload 'skk-isearch-backward "skk-isearch" nil t)

If you are going to run SKK under Mule based on Emacs version 19, then
add the following lines to .emacs

        (autoload 'skk-isearch-mode-setup "skk-isearch" nil t)
        (autoload 'skk-isearch-mode-cleanup "skk-isearch" nil t)
        (add-hook 'isearch-mode-hook
                  (function (lambda ()
                              (and (boundp 'skk-mode) skk-mode
                              (skk-isearch-mode-setup)))))
        (add-hook 'isearch-mode-end-hook
                  (function (lambda ()
                              (and (boundp 'skk-mode) skk-mode
                              (skk-isearch-mode-cleanup)))))

[i-2] Create the file ~/.skk and the put the following line in it:

        (setq skk-large-jisyo ".../SKK-JISYO.L")

where `...' denotes the directory where you installed the common
dictionary.

4.2
---

[ii-1] Add the following lines to your .emacs file:

        (global-set-key "\C-x\C-j" 'skk-mode)
        (global-set-key "\C-xj" 'skk-auto-fill-mode)
        (global-set-key "\C-xJ" 'register-to-point)
        (global-set-key "\C-xt" 'skk-tutorial)
        (autoload 'skk-mode "skk" nil t)
        (autoload 'skk-tutorial "skk-tut" nil t)
        (autoload 'skk-check-jisyo "skk-tools" nil t)
        (autoload 'skk-merge "skk-tools" nil t)
        (autoload 'skk-diff "skk-tools" nil t)

Moreover, if you are going to run SKK under Nemacs or Mule based on
Emacs version 18, then add the following lines to .emacs

        (global-set-key "\C-s" 'skk-isearch-forward)
        (global-set-key "\C-r" 'skk-isearch-backward)
        (autoload 'skk-isearch-forward "skk-isearch" nil t)
        (autoload 'skk-isearch-backward "skk-isearch" nil t)

If you are going to run skk under Mule based on Emacs version 19, then
add the following lines to .emacs

        (autoload 'skk-isearch-mode-setup "skk-isearch" nil t)
        (autoload 'skk-isearch-mode-cleanup "skk-isearch" nil t)
        (add-hook 'isearch-mode-hook
                  (function (lambda ()
                              (and (boundp 'skk-mode) skk-mode
                              (skk-isearch-mode-setup)))))
        (add-hook 'isearch-mode-end-hook
                  (function (lambda ()
                              (and (boundp 'skk-mode) skk-mode
                              (skk-isearch-mode-cleanup)))))


[ii-2] Put the following lines in your .skk file:

        (setq skk-server-host "...") ;; `...' is the name of the server host
        (setq skk-serv "/usr/local/soft/nemacs/etc/skkserv")
        (setq skk-aux-large-jisyo ".../SKK-JISYO.L") ;; ... is the
        ;; directory where you installed the common dictionary

4.3
---

If you will be using SKK under Demacs, follow the steps in 4.1 and
then add the following line in your _emacs file:

        (setq skk-init-file "~/_skk")

4.4
---

You can learn the usage of SKK by the tutorial program, which you can
invoke by typing 'C-x t'.  If you wish to use the English tutorial
text, put the following line in your .emacs file:

        (setq skk-tut-file ".../SKK.tut.E") ;; ... is the directory
        ;; you installed SKK.tut.E

5. SKK Mailing List
===================

SKK mailing list has been created to discuss various aspects of SKK, and
to exchange information about SKK.  Questions and answers to them, problems
and solutions to them, bugs and fixes to them, suggestions, contributions
of utilities etc. are the main topics so far.

Discussions are mainly done in Japanese. If you cannot enter Japanese
texts for some reasons, you can send your articles in English, but you will
probably get replies in Japanese.  We are assuming that you have Nemacs
and a terminal which can display Japanese.

(1) To join the mailing list, send an email to the following address.

	skk-join@sato.riec.tohoku.ac.jp

(2) Contributions to the list should be sent to:

	skk@sato.riec.tohoku.ac.jp

(Articles in Japanese must be encoded in JIS.)

(3) To leave the mailing list, send an email to the following address.

	skk-leave@sato.riec.tohoku.ac.jp

------------------------------------------------------------------------------

				Masahiko Sato (masahiko@sato.riec.tohoku.ac.jp)
				and
				Yukiyoshi Kameyama (kam@sato.riec.tohoku.ac.jp)
				Research Institute of Electircal Communication
				Tohoku University
				2-1-1, Katahira, Aoba-ku
				Sendai 980
				Japan
