This is a preliminary version of hanterm manual. Much should be added here.
Hanterm is a Hangul terminal emulator. It is intended to replace XTerm whenever Hangul input/output is needed.
Hanterm uses X11 JOHAB* (johab, johabs, johabsh, and NZ series fonts) encoded fonts as well as X11 KSC5601.1987 encoded font(aka Wansung). Since the johab* fonts can represent all the Hangul syllables in modern use as well as some archaic syllables, you can use JOHAB encoding specified as a supplementary encoding in KS X 1001:1997 annex 3 as well as more widely used EUC-KR and newly added UTF-8 encoding.
Moreover, JOHAB* fonts are much smaller than usual KSC5601.1987-* encoded fonts, so you can run hanterm in more restrictive environment. You can also use johab844 encoded fonts to enjoy a kind of ``modernized'' look.
Since this version of the program is based on X11R5 XTerm code, all XTerm options (including Xt options) and VT100 Menus are retained in hanterm. You can find more information of the basic features from xterm(1) man page.
Getting started - Compiling and Installing
You can get the tar'ed and gzip'ed source from http://hanterm.org/download/. After storing the file, you can issue
$ gzip -dc hanterm-<version>.tar.gz | tar xf -
commands to extract the source tree. After extracting the source, on most OS/X-window system combinations
% xmkmf; make % su $ make install
will do the job.
On some systems hanterm must be installed suid root. Compare the permissions of your xterm and hanterm carefully. Their permissions should be identical.
With some OS/compiler/X server combinations installing
Solaris 2.x + OpenWindows 4
Config files of OpenWindows are set up to use
Sun CC package, which is not bundled with basic Solaris
package. If you want to install
Here is the config files for those want to do the second option. WARNING: these files are not written by hanterm-dev team, nor do we know the creator. Any problems you might encounter has nothing to do with us.
SunOS 4.x + OpenWindows 3
At the last stage of
ld: Undefined symbol _sin _cos _pow _floor _get_wmShellWidgetClass _get_applicationShellWidgetClass
You can safely ignore these messages.
DG/UX users should try
Installing the fonts
If you previously installed hanterm, then somewhere you should have JOHAB* encoded fonts. Of course, you can always use KSC5601.1987 encoded fonts with hanterm, but if you want to enjoy various look and feel, you might want to install hanterm-fonts.tar.gz package.
CAUTION: remove the old johab844 fonts, which has wrong XLFD names. do
% xlsfonts "*johab844*"
and carefully count the number of "-" in the font
names. If it is not 14, you're in trouble. Run
You can get hanterm-fonts.tar.gz package from
the same place where you got hanterm. Note that included
Most features of
Switching between Korean/English input method
For rare cases in which the X server cannot accept the LeftShift-Space combination, F2 key also switches between the input methods.
Switching between 2-bul and 3-bul(390) Korean input method
You must click the second -cell. No key combinations exists as of current version.
Switching between EUC-KR and KSC-5601:1991 Annex 3 (aka johab) code
You must click the third -cell. No key combinations exists as of current version.
The Chatting mode
You can toggle Chatting mode with F3 key. It is a buffered mode which can be useful when you do IRC-type chatting or using a horridly slow connection.
Note that the line editing can be different from the usual shell mode you might be using.
Ctrl-H(Backspace) or DEL erases one ``character(English or Korean)'' backwards, Ctrl-W erases one word, Ctrl-U deletes the whole buffer.
Pressing Enter flushes out the input buffer, with trailing CR/LF. ESC also flushes out the buffer, but without trailing CR/LF.
Hanja (Chinese) input
You can input Hanja part of EUC-KR. To do this, after typing all syllables of a Korean character and while the cursor is still on freshly input character, press F9. The list of Hanjas with the pronunciation corresponding to the syllable under the curosr will show up in the status line at the bottom, from which you can select appropriate Hanja. If the number of selections is larger than 9, you should use cursor key (Left or Right) to select among additional set of Hanja.
To input special characters, or Japanese or Russian characters included in EUC-KR, press F7. You can input the hexadecimal EUC-KR codepoint value directly.
Cut & PasteSelecting some text with mouse copies to X selection buffer. To paste to