emacs/lisp/language/korea-util.el
Lars Ingebrigtsen 21c4a3dfb4 Doc string improvements around `default-korean-keyboard'
* lisp/language/korea-util.el (default-korean-keyboard): Mention
"Hangul" here for easier discoverability.
(toggle-korean-input-method, quail-hangul-switch-symbol-ksc)
(quail-hangul-switch-hanja): Mention the variable.
2021-01-31 08:12:10 +01:00

148 lines
5.1 KiB
EmacsLisp

;;; korea-util.el --- utilities for Korean -*- lexical-binding: t; -*-
;; Copyright (C) 1997, 1999, 2001-2021 Free Software Foundation, Inc.
;; Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
;; 2007, 2008, 2009, 2010, 2011
;; National Institute of Advanced Industrial Science and Technology (AIST)
;; Registration Number H14PRO021
;; Keywords: mule, multilingual, Korean
;; This file is part of GNU Emacs.
;; GNU Emacs 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 3 of the License, or
;; (at your option) any later version.
;; GNU Emacs 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 GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary:
;;; Code:
;;;###autoload
(defvar default-korean-keyboard
(purecopy (if (string-match "3" (or (getenv "HANGUL_KEYBOARD_TYPE") ""))
"3"
""))
"The kind of Korean keyboard for Korean (Hangul) input method.
\"\" for 2, \"3\" for 3, and \"3f\" for 3f.")
;; functions useful for Korean text input
(defun toggle-korean-input-method ()
"Turn on or off a Korean text input method for the current buffer.
The keyboard layout variation used is determined by
`default-korean-keyboard'."
(interactive)
(if current-input-method
(deactivate-input-method)
(activate-input-method
(concat "korean-hangul" default-korean-keyboard))))
(defun quail-hangul-switch-symbol-ksc (&rest _ignore)
"Switch to/from Korean symbol package.
The keyboard layout variation used is determined by
`default-korean-keyboard'."
(interactive "i")
(and current-input-method
(if (string-equal current-input-method "korean-symbol")
(activate-input-method (concat "korean-hangul"
default-korean-keyboard))
(activate-input-method "korean-symbol"))))
(defun quail-hangul-switch-hanja (&rest _ignore)
"Switch to/from Korean hanja package.
The keyboard layout variation used is determined by
`default-korean-keyboard'."
(interactive "i")
(and current-input-method
(if (string-match "korean-hanja" current-input-method)
(activate-input-method (concat "korean-hangul"
default-korean-keyboard))
(activate-input-method (concat "korean-hanja"
default-korean-keyboard)))))
;; The following three commands are set in isearch-mode-map.
(defun isearch-toggle-korean-input-method ()
(interactive)
(let ((overriding-terminal-local-map nil))
(toggle-korean-input-method))
(setq isearch-input-method-function input-method-function)
(setq-local input-method-function nil)
(isearch-update))
(defun isearch-hangul-switch-symbol-ksc ()
(interactive)
(let ((overriding-terminal-local-map nil))
(quail-hangul-switch-symbol-ksc))
(setq isearch-input-method-function input-method-function)
(setq-local input-method-function nil)
(isearch-update))
(defun isearch-hangul-switch-hanja ()
(interactive)
(let ((overriding-terminal-local-map nil))
(quail-hangul-switch-hanja))
(setq isearch-input-method-function input-method-function)
(setq-local input-method-function nil)
(isearch-update))
;; Information for setting and exiting Korean environment.
(defvar korean-key-bindings
`((global [?\S- ] toggle-korean-input-method nil)
(global [Hangul] toggle-korean-input-method nil)
(global [C-f9] quail-hangul-switch-symbol-ksc nil)
(global [f9] hangul-to-hanja-conversion nil)
(global [Hangul_Hanja] hangul-to-hanja-conversion nil)
(,isearch-mode-map [?\S- ] isearch-toggle-korean-input-method nil)
(,isearch-mode-map [Hangul] isearch-toggle-korean-input-method nil)
(,isearch-mode-map [C-f9] isearch-hangul-switch-symbol-ksc nil)
(,isearch-mode-map [f9] isearch-hangul-switch-hanja nil)))
;;;###autoload
(defun setup-korean-environment-internal ()
(use-cjk-char-width-table 'ko_KR)
(let ((key-bindings korean-key-bindings))
(while key-bindings
(let* ((this (car key-bindings))
(key (nth 1 this))
(new-def (nth 2 this))
old-def)
(if (eq (car this) 'global)
(progn
(setq old-def (global-key-binding key))
(global-set-key key new-def))
(setq old-def (lookup-key (car this) key))
(define-key (car this) key new-def))
(setcar (nthcdr 3 this) old-def))
(setq key-bindings (cdr key-bindings)))))
(defun exit-korean-environment ()
"Exit Korean language environment."
(use-default-char-width-table)
(let ((key-bindings korean-key-bindings))
(while key-bindings
(let* ((this (car key-bindings))
(key (nth 1 this))
(new-def (nth 2 this))
(old-def (nth 3 this)))
(if (eq (car this) 'global)
(if (eq (global-key-binding key) new-def)
(global-set-key key old-def))
(if (eq (lookup-key (car this) key) new-def)
(define-key (car this) key old-def))))
(setq key-bindings (cdr key-bindings)))))
;;
(provide 'korea-util)
;;; korea-util.el ends here