~ubuntu-branches/ubuntu/breezy/kterm/breezy

1 by ISHIKAWA Mutsumi
Import upstream version 6.2.0
1
---------------------------
2
README file for kterm-6.2.0
3
---------------------------
4
5
Kterm is an X11 terminal emulator that can handle multi-lingual text.
6
This release is based on xterm of X11R6.1.
7
8
9
Changes in this release
10
-----------------------
11
 o Kterm now handles multi-lingual text in addition to Japanese.
12
 o Kterm now supports X Input Method protocol in addition to kinput2 protocol.
13
 o Fonts are loaded dynamically by default.
14
 o Tektronix emulation is disabled by default configuration.
15
 o Many bug fixes.
16
17
18
Configuration
19
-------------
20
You can disable any of the features added to xterm by editing Imakefile
21
and kterm.h.
22
23
Imakefile:
24
 o KTERM:           enables kterm features. see kterm.h part.
25
 o STATUSLINE:      enables statusline support.
26
 o KEEPALIVE:       enables keepalive socket option for the server connection.
27
28
kterm.h:
29
 o KTERM_MBCS:      enables support for MBCS text.
30
 o KTERM_MBCC:      enables MB character class support. It is used for word
31
		    selection.  KTERM_MBCS must be defined.
32
 o KTERM_KANJIMODE: enables support for Kanji specific encodings, Japanese EUC
33
		    and Shift-JIS.  KTERM_MBCS must be defined.
34
 o KTERM_XIM:       enables support for Kanji text input using X Input Method
35
		    protocol.  KTERM_MBCS must be defined.
36
 o KTERM_KINPUT2:   enables support for Kanji text input using kinput2
37
		    protocol.  KTERM_MBCS must be defined.
38
 o KTERM_COLOR:	    enables colored text support.
39
 o KTERM_NOTEK:	    disables Tektronix emulation.
40
 o KTERM_XAW3D:	    enables kterm to work with the Xaw3d library compiled
41
		    with -DARROW_SCROLLBAR option (disables by default).
42
43
44
Compilation
45
-----------
46
This kterm basically needs X11R6.1 libraries and include files.
47
In X11R6.1 environment, just type:
48
 % xmkmf -a; make
49
50
In X11R6 environment, if you have some luck (your system supports fd_set
51
type and FD_* macros), you can compile kterm without modification.
52
53
54
Installation
55
------------
56
Install kterm and KTerm.ad:
57
 % make install
58
59
Install kterm.man manual page:
60
 % make install.man
61
62
If your system supports Japanese manual pages and you want to install
63
kterm.jman, copy it to an appropriate directory/filename in an
64
appropriate encoding by hand.  Note that kterm.jman is encoded in JIS
65
code.
66
67
If your system does not have kterm entry in the termcap or terminfo,
68
you may want to install termcap.kt or terminfo.kt by hand.
69
70
71
Supported Systems
72
-----------------
73
kterm-6.2.0 should be successfully built on the following systems:
74
75
    sparc
76
	SunOS 4.1.x (*1)
77
	SunOS 4.1.x-JLE*
78
	Solaris 2.x
79
	Solaris 2.xJ
80
	NetBSD-1.1B/sparc
81
	NetBSD/sparc-1.2_ALPHA
82
	UXP/DS V20L10 Y96021 [Fujitsu DS/90 7000]
83
84
    i386
85
	Solaris 2.5 x86
86
	NetBSD1.1
87
	NetBSD/{i386,pc98} 1.2_ALPHA
88
	FreeBSD(98)2.1R Alpha (XFree86 3.1.2Eb) (*2)
89
	FreeBSD 2.2-96{0323,0612}-SNAP (XFree86 3.1.2E) (*2) (*3)
90
	BSD/OS 2.1
91
	Linux-2.0.0 ELF libc 5.3.12
92
93
    sony
94
	NEWS-OS 4.2.1a+RD
95
	NEWS-OS 6.0.2
96
97
    sgi
98
	IRIX 5.3 {,IP22}
99
	IRIX 6.1
100
101
    hp
102
	HP-UX 9.0[57] (with -DX_LOCALE, cc)
103
	HP-UX 10.01
104
105
    dec
106
	OSF/1 3.0 [DEC 7000 AXP system 620]
107
	OSF/1 3.2A [DEC 3000/500]
108
	Digital UNIX 3.2C [DEC AlphaStation 200 4/100]
109
	Digital UNIX 3.2D [DEC AlphaServer 2100 4/275]
110
	*** does not work on DEC 3000 running DEC OSF/1 2.0 ***
111
112
    *1	Kterm and X libraries must be compiled with -DX_LOCALE to use XIM.
113
    *2	Kterm must be compiled with -DUSE_POSIX_WAIT to eliminate a warning.
114
    *3	Kterm must be linked with -lxpg4 to use XIM.
115
116
117
CAUTION
118
-------
119
Killing an IM server while it is establishing connection with a kterm,
120
or on a kterm which is connected with the server may hang the kterm
121
(because of imperfection around IM handling in Xlib).
122
123
124
To Do
125
-----
126
 o Use of fontSet resources.
127
 o More ISO6429 attributes.
128
129
130
Bug report
131
----------
132
If you find any bug, please make sure that it is not an xterm's bug, then
133
report it to kagotani@in.it.okayama-u.ac.jp.  Don't forget to include
134
the version of kterm (see kterm.h or do "kterm -version") and information
135
about your system.
136
137
138
Enhancement
139
-----------
140
If you would like to distribute your local enhancement, please change
141
the version number to something like "6.2.0-yourname1".
142
143
144
						July 12, 1996
145
						Hiroto Kagotani
146
						kagotani@in.it.okayama-u.ac.jp