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

                           hanterm installation guide

                             (edited by amateras)

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

* This document standard width is 80 column and tabstep size is 8
* At first You must compile hanterm and install basic font.
  This can be done by reading article under this line. This is same
  as a doc/README.0 file.
* If you want other documentation and have problem to install program
  please read document in doc/*
* If you have problem to compile program read a documentation about 
  my edition ( this is in Korean so.. you must read from other hanterm ) ^^;

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

You need X Window System 11 Release 4 or Release 5 to install hanterm.
(I didn't checked on R4).

1. Do "xmkmf".
    It makes Makefile from Imakefile in the directory.

    [ OpenWindows 3 User ]
    Do "imake -DOpenWindows /usr/openwin/lib/config"

    Some systems have no xmkmf. Even worse, they have it
    with incorrect configuration files. Ask your system
    admin to install it correctly.

    For HP users, I included "Makefile.hp". Try "make -f Makefile.hp"
    if you dont have xmkmf.

    For DGUX users, try "make -f Makefile.dgux". It is from dkim@cwc.com.

2. Do "make".
    It makes "hanterm" in the directory.

    [ OpenWindows 3 User ]
    They says error messages like:
	ld: Undefined symbol
	   _sin
	   _cos
	   _pow
	   _floor
	   _get_wmShellWidgetClass
	   _get_applicationShellWidgetClass
    Don't worry, hanterm works anyway.

3. Install "hanterm" to a system directory.
    "su root"
    "make install"

    Normally it will install hanterm to /usr/bin/X11/hanterm, and
    Hanterm.ad to /usr/lib/X11/app-defaults/Hanterm.

    [ Non Super User ]
    Just place hanterm where you like.

Now let's install Hangul fonts.
( If you does not have hanterm font you must download this from other site..)

4. Do "bdftopcf johabg16.bdf > johabg16.pcf",
      "bdftopcf johabm16.bdf > johabm16.pcf",
      "bdftopcf johabp16.bdf > johabp16.pcf".
      "bdftopcf johabsg16.bdf > johabsg16.pcf".
      "bdftopcf johabsm16.bdf > johabsm16.pcf".
      "bdftopcf johabsp16.bdf > johabsp16.pcf".

    If you have insufficient disk space, install johabm16 only.
    "johabs" fonts include graphic characters in KSC5601.
    If you dont need them, dont install.

    [ X11 R4 User ]
    Change "bdftopcf" to "bdftosnf" and "*.pcf" to "*.snf"

    [ OpenWindows User ]
    Skip to 13.

5. Become super user.
    "su root"

   If you are a user of X Terminal like NCD 16,
   you probably need to become a super user to install fonts.
   If you are using X Window System at console,
   you can install fonts in your private directory.
   
6. Copy *.pcf(or *.snf) file to the system directory
   (usually /usr/lib/X11/fonts/misc).
    Do "cp *.pcf /usr/lib/X11/fonts/misc" (Release 5)
    or "cp *.snf /usr/lib/X11/fonts/misc" (Release 4)

    [ Non Super User ]
    Make a font directory and move "*.pcf" files (or *.snf) to the directory.
    "mv *.pcf hanterm_font" or
    "mv *.snf hanterm_font"

7. Do "mkfontdir ." in the font directory.
    "cd /usr/lib/X11/fonts/misc"
    "mkfontdir ."

    [ Non Super User ]
    "cd hanterm_font"
    "mkfontdir ."

8. Do "xset fp rehash".

    [ Non Super User ]
    "xset fp+ `pwd`"
    It add a user directory to system font search path.
    If your are using X Terminal, "xset fp+" will fail.
    Please try to install fonts to system directory (usually under /tftpboot).

    You can test whether fonts are well installed by typing
    "xlsfonts|grep johab"
    It will shows 3 or 6 lines of fonts name.
    If there is no output from above commands, please ask
    your root or friends how to install fonts.

9. OK, run "hanterm" and read below lines, thanks.

    [ OpenWindows 3 ]

    If it says "ld.so.1: hanterm: can't find file libXaw.so.5",
    do "setenv LD_LIBRARY_PATH /usr/openwin/lib".

10. If you're using OpenWindows, try the following procedures to install
    fonts.

    [assume you're running OpenWindows]
    [in hanterm source directory]
    % mkdir ofont
    % cd ofont
    % convertfont -n -kaist-myeongjo-16 ../johabm16.bdf
    % convertfont -n -kaist-gothic-16 ../johabg16.bdf
    % convertfont -n -kaist-philgi-16 ../johabp16.bdf
    % bldfamily
    [It says "cat: ./Compat.list: No such file or directory", don't worry.]
    [now, quit OpenWindows]
    % setenv FONTPATH hanterm/ofont:/usr/openwin/lib/fonts
    [`hanterm/ofont' is the directory where you did `bldfamily']
    [now, restart OpenWindows]
    % openwin
    % xlsfonts|grep kaist
    [3 fonts should appear here]
    [run hanterm]
    % hanterm -hfn -kaist-myeongjo-16

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

* Under this line it explain about hanterm with hangul.

------------------------------------------------------------------------------
				-------------
				   Ұ
				-------------

 xterm ѱ ǵ xterm  Դϴ.
xterm ٸ   ϴ.

1.  ǥ

    â  ٿ  Է ° ɴϴ.

    [ѱ]/[] : ѱ Է   Է  Ÿ.
    [ϼ]/[] : ѱ ڵ尡 ϼ Ÿ.
    [2]/[3] : ѱ  2 3 Ÿ.

    콺  ° ȯ˴ϴ.

2. ä 

    äø ä/ũ  մϴ. ä 忡  Ű
     ϴ.

    ^H, DEL :   
    ^W :  ܾ 
    ^U :  
    Esc : Ͼ äùۿ ִ   .
    Return : ϰ Բ äù   .

3. "-hfn" ɼ

    ѱ Ʈ ̸ ϴ ɼԴϴ.
      ü Ʈ ˴ϴ.
    .Xdefault  Ϸ "hanterm*hangulFont"  մϴ.
      ִ Ʈ̸    ֽϴ.

    -kaist-myeongjo-bold-r-normal--16-160-75-75-c-160-johab-1 ()
    -kaist-gothic-medium-r-normal--16-160-75-75-c-160-johab-1 ()
    -kaist-philgi-bold-r-normal--16-160-75-75-c-160-johab-1   (ʱ)

    ڸ ǥϷ johab ſ johabs  մϴ.

4. "-h" ɼ

    ޾ ̴ ɼǰ   ɴϴ.

5. KSC5601-1992   ϼ  մϴ.
   X resource  hangulCode Դϴ.  0(=ϼ) 1(=) Դϴ.

   : Hanterm*hangulCode: 1

   ɼδ -hc Դϴ.

   *  *
    ڵ Unix 󿡼   Ƿ
   뿡 Ǹ մϴ.

6.   մϴ.
   X resource  hangulKeyboard Դϴ.  2(=2) Ȥ 3(=3) Դϴ.

   : Hanterm*hangulKeyboard: 2

   ߿ 콺 ư [2] ̶   ٲ  ֽϴ.
     2Դϴ.

7. Ctrl+F10   ڵ带  Է  ֽϴ.

8. Į ÷  Į մϴ.

   Escape sequence  ESC, "[", Pm, "m" Դϴ.
   Pm  30: , 31: , 32: ʷ, 33: ,
         34: Ķ, 35: ȫ, 36: ϴ, 37: Ͼ
         40: , 41: , 42: ʷ, 43: ,
         44: Ķ, 45: ȫ, 46: ϴ, 47: Ͼ
         30-37 ̸ ڻ ٲߴϴ
         40-47 ̸  ٲߴϴ.

-------------
   
-------------
<> 3.0  2.2.1 ǰ ޶ ?

   *  Ѵ.
   * 3  Ѵ.
   * Ưڸ ڵ尪 Է  ִ.
   * Į Ѵ.
   * -tk, -c ɼ .

<> ѱ/ Է 带 ٲٷ?

   Shift   ¿ space  ų
   콺 â  Ʒ ִ []/[ѱ]  .

<> ϼ/ ڵ带 ٲٷ?

   F2  ų
   콺 â  Ʒ ִ [ϼ]/[]  .

<> 3/2  ٲٷ?

   콺 â  Ʒ ִ [3]/[2]  .

<>  ڸ ԷϷ?

   Ctrl   ¿ F10   â  Ʒ "ڵ>" 
    ´. ⿡ ϼ ڵ  16 ԷѴ.

<> ä   ų  ?

   Meta   ¿ c  .

<> ä 忡 ̴ Ű?

   ^H, DEL :   .
   ^W :  ܾ .
   ^U :  .
   Esc : Է  .
   Enter : Է   CR  .

<>   ⺻  Ϸ?

   ~/.Xdefaults 
     Hanterm*hangulCode: 1
   ̶ ش.

<>   ⺻ 3 Ϸ?

   ~/.Xdefaults 
     Hanterm*hangulKeyboard: 3
   ̶ ش.

<> ѿ ȯ Ű ڵ ȯ Ű, äø ȯ Ű, ڵԷ Ű ٲٷ?

   ~/.Xdefaults  Hanterm*VT100*translations ҽ ϸ ȴ.
    ѿ ȯ Ű F10, ڵ ȯ Ű Meta+F2, ä  ȯ Ű Ctrl+c,
   ڵ Է Ű Shift+space  ٲٷ

   Hanterm*VT100*translations: #override\
    <KeyPress>F10: toggle-hangul()\n\
    Meta<KeyPress>F2: change-code()\n\
    Ctrl<KeyPress>c: toggle-chat()\n\
    Shift<KeyPress>space: code-input()

   ̶ ָ ȴ.

<> ѿ ȯ Ű Meta+space  ٲٰ ʹ.

   .Xdefaults     ش.

   Hanterm*VT100*translations: #override\
    Meta<KeyPress>space: toggle-hangul()\n\
    Shift<KeyPress>space: insert-seven-bit()

<> nemacs  -nw ɼ µ Meta+c  äø  Ű
   capitalize-word   ȴ.

   ~/.Xdefaults     ش. äø  Ű
   Meta+F3  ٲپ.

   Hanterm*VT100*translations: #override\
    Meta<KeyPress>c:insert-eight-bit()\n\
    Meta<KeyPress>F3:toggle-chat()

<> X Terminal  µ Meta Ű   ʴ´.

   ~/.Xdefaults     ش.

   Hanterm*VT100*translations: #override\
    Mod1<KeyPress>:insert-eight-bit()

<> ֿܼ  Ǵµ X Terminal  Ʈ ٰ ´.

   X Terminal  Ʈ Ư 丮( /tftpboot) ´.
    Ʈ   νѴ.

<> "ѱ"̶ Էߴµ "GQ1["̶ ´.

   
   stty -istrip cs8 -parenb
   ̶ غ.

<> bash  µ "ѱ"̶ Էϸ Ҹ .

   bash  8 bit Է  Ƿ ѱ   .
   tcsh  ѱ ȴ.

<> vi  ѱ  ȴ.

    vi  ѱ  Ƿ ѱ   ִ ͸
   Ѵ. Anonymous ftp  cair.kaist.ac.kr  pub/Hangul/editor
     .

<>  ϴ ʹ?

    ϴ ʹ helvis  ִ. cair.kaist.ac.kr 
   /hangul/editor/helvis-17h1.tar.gz    ִ.
   ( ̾߱)

<> E-mail  ѱ  ȴ.

   E-mail  ѱ  ѱ E-mail Ʈ ƾ Ѵ.
   Anonymous ftp  cair.kaist.ac.kr  pub/Hangul/mail  
   .

<> rn  ѱ  ȴ.

   tin ̳ trn  .

<>  ߴµ who   ʴ´.

    ۹̼ǰ /etc/utmp  ȮѴ.
    setuid bit  Ǿ   owner /etc/utmp
     ־ ϰ ƴϸ /etc/utmp      ־
   Ѵ.

<> nemacs  -nw ɼ µ M-x  ġ ɾ °  ʰ
   M-x-  ´.

   ~/.Xdefaults     ش.

   Hanterm*eightBitInput: False

<>  BBS  ϴµ ڵ  δ.

   ѱ Ʈ ̸ johabs    ٲ۴.

   Hanterm*hangulFont: *-myeongjo-bold-r-*-16-*-johabs-1

<> ۾ ũ ϰ ʹ.

   ϴ X  X11R5 ̶ X  Ʈ Ȯ/Ҹ
   ϹǷ ~/.Xdefaults     ָ ȴ. (Courier 18 
    )

   Hanterm*font:       -*-courier-bold-r-normal--18-180-75-75-m-110-iso8859-1
   Hanterm*hangulFont: -*-myeongjo-bold-r-*--*-180-95-75-c-*-johabs-1

    "-"   ߿ϴ (14 ). -180-95-75-  ڴ 
   ٲ  ִµ -pixel-x-y- ̴. pixel  Ʈ height  
    x   ػ, y   ػ󵵸 Ѵ.  pixel 
   y   Ʈ ߰, ѱ  2 谡 ǵ x  Ѵ.

<> ѱ ȭ ͷ  ʹ.

   hpscat ̳ ѱ LaTeX  Ѵ. Anonymous ftp  cair.kaist.ac.kr
    pub/Hangul/{print,latex}   .

<> 3   ˰ ʹ.

    ҽ  ִ KEYBOARD3 ̶ ȭ  .

<>     ʹ.

   hangul@cair.kaist.ac.kr mailing list    .

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

ó(1991  )  ó ϴ.  1.7...
    ׷ٰ ũ ,  ũ, α ȭ    Ϸ
     xterm ġ   ڴٰ Ǿ 2.0 ʹ xterm
    ϰ Ǿϴ.

2.1  äø带  ־ϴ.  1.7  äø
     ־, 2.0  1.7 Ұ   α׷̾...
    · äø尡 1.7 ٴ ϴ. ¿ ũѵ ǰ...

2.2  2.0  2.1     -tk ɼǰ -c ɼ
    ٽ ϴ. ׸ iso-2022  ڵ ȭ 
       ִ  ÷߽ϴ.

    Ʈ ̸ ٲϴ. ׵ Ʈ̸ sjk  ־ 
    Ҵ  ϴ. ׷ kaist  ٲپϴ.   Ʈ
    Ư ڰ ־µ  Ⱦ̴  Ƽ ݽϴ. X Terminal
     쿡 Ʈ ϴµ ɸ ð  ˴ϴ.

    R4   ϵ ʴ  ƽϴ.

3.0 (1993  9 )  , 3 , Į , Linux 
    HPUX 

3.0.1 (1993  9  28 ) 3  "/"  .
    README . DGUX 

3.0.2 (1993  11  12 ) Solaris 2.2 porting.
    Imakefile.R4  Imakefile  .
    Imakefile.ow  Imakefile  .

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

X11R4   ,
Linux   ִ(yunju@camars.kaist.ac.kr),
HP   ߺ(jbkang@csone.kaist.ac.kr),
IRIX3.3.2   ش(koma@vortex.kaist.ac.kr),
IRIX4.0.5 ð Ÿ ׽Ʈ  ӵö(lim@rani.chem.yale.edu),
3.0    ֵ ݷ  ڿ뼷(park@casbah.acns.nwu.edu),
 Ĵ(jshin@minerva.cis.yale.edu),
DGUX   Ĵ(dkim@cwc.com),
ѱ Ʈ   ֵ   ѱ۰ ǻ,
README  öڸ ٷ  ¼(hyun@ils.nwu.edu),
Resource ȭ translations  ٷ  Marcus S. Yoo(msy@scr.siemens.com),
 (cdpark@piri.kaist.ac.kr)
׿  ϴ  е鲲 帳ϴ.

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

ϴ ϴٰ Ǵ , ؾ    ø
  ֽʽÿ.   ݿϵ ϰڽϴ.
 ּҴ jksong@hnc.re.krԴϴ.



                   *******************************
                   *             *
                   *******************************

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

* Now I began to explain about my edition ( by amateras )
------------------------------------------------------------------------------

.. ȳϽʴϱ..  ׸ ġ ؼ ʻ ⸻絵  ԰
ġ ԰ ÿ ణ (?)  Ƹ׶ Դϴ.
   ̽ (kils:̻) jo844 ϰ ֽϴ.
׸  ҽ   ֽϴ. 
  ⺻ ҽ hanterm 3.0 beta 3 with jo844 Դϴ. 
켱 ġ ׸ 캸..

1. Patched bug from hanterm 3.0 beta 3

- ѱ ȭ鿡 exposure    ڸ exposeǴ  ©  ȭ
    ҽϴ.
- ansi  α׷ cursor   color   ׸
  ƽϴ.
- Ŀ ġ ѱ ι°     ݽϴ.
  ( Ŀ ؿ ׸  ׾ ݴϴ. )

2. Changed

- Chat忡 带 Ÿ   ĭ ڿ ϴ êڽ
  ĭ ܼ ʿ  ٿϴ. ̴    ؼ 
  Դϴ. ׸ Ϲ ؽƮ Ÿ κа Ʒ ê̳ ¸ Ÿ
    ణ  ξ   κ ȳŸ ߽ϴ.

- ؽƮ ȭ 濡 ׸   ֵ ϴ. pixmapۿ 
  ϰ ణ  ҽ  Դ     
  ϰ ÿ   Ⱦ    ٸ  ϴ.

- ̻  jo844  մϴ. ̰ doc/README.jo844(?)  
  Ͻñ ٶϴ.

3. Compile

- Ϲ    ϴ.  xpm̺귯 ߰  
   ų  ֽϴ. xpm library   xpm library 
  Ŀ ν Ͻñ ٶϴ.
- Xpm Link Error    -lXpm  Makefile ļ ֱ ٶϴ.
-  Solaris  Linux ׽Ʈ ǾǷ  ӽſ  
  ڰ Ͻñ ٶϴ. ^^;
- Imlib ðų ٸ  file Ͻñ Ͻø.. xmkmfϽ
  Ŀ Makefile -lIm κ ãƼ UncommentϽð -DIMLIBκе
  UncommentϽ  background.o main.o ð   Ͻø
   ̴ϴ.

4. Use.

-    ΰ Դϴ. Command line -pixmap/-pic ɼ 
  Ͻø Ǳ. ƴϸ ȯ  HANTERM_BACKGROUND  ˸ 
  ׸  νø ڵ 򸳴ϴ.
- XPM  Xpm̺귯  ϹǷ  ׷ 
   -half ɼ̳ HANTERM_BACKGROUND_HALF  1̳ ׿ܷ
   νø Ӱ ؼ 濡 򸮰 ˴ϴ. ׸. -nohalf
  ȯ溯 overrideմϴ.

- ׸ Imlib   imlib ϴ  ׸  Ͻ
   ֽϴ.
- test ./hanterm -pixmap lightb.xpm   ʽÿ.

- ׸ ε ϰ     ׸ ȭ ʹ  
   ְų ȭ鿡 Netscape     α׷ 
     ϴ.

-     Ϲ Ұ    ϸ ƹ
   ϴ.


ٸ)
	vim  ѱȭ  ϱ ߴµ  ø? . ^^;
	 ̷ .  ⸻ ¾?. T.T

	1997. 6. 16 

------------------------------------------------------------------------------
	 by Amateras at POSTECH email:amateras@snow.postech.ac.kr
	 homepage:http://core.postech.ac.kr/~amateras/
------------------------------------------------------------------------------
