1Welcome to the new tn3270 - version 4.1.1.
2
3This version consists entirely of bug fixes to the August 1987 beta release
4of tn3270.  This version will now deal with CICS and VM/XA on the IBM
5side, and with SunOS 4.0 on Sun 3's and Sun 4's.
6
7This version has been tested on various versions of BSD Unix, including
84.2 and 4.3 (but there are never vanilla versions) and the post-4.3 systems
9running at Berkeley.  It has been tested on CCI's, Vaxen, Sun 3's and Sun 4's.
10However, it doesn't necessarily work on all systems (nor has the testing
11been as intensive as one might like).
12
13This version should build on any Berkeley-derived system.
14
15There are two alternate make files:  ./makefile_4.2 and telnet/Makefile_ultrix.
16
17****    Try ./makefile_4.2 if you get compile-time errors, or get
18	"multiply defined" messages for "_putchar" from the loader.
19
20****    Try telnet/Makefile_ultrix if your make(1) utility doesn't
21	support VPATH.  Also try this makefile if your ld(1) doesn't
22	support the -r flag correctly.
23
24The bad news is that I've had to drop MS-DOS support.  The good news here is
25that there are various versions available for MS-DOS (from FTP Software in
26Cambridge, Mass.; from IBM; from Excelan; and probably from others).  The
27hooks are still there, as well as some code to update the screen.  However,
28I just haven't had the time to produce a fully integrated version that would
29"just make".  I suspect that a future release may have MS-DOS support back
30in it.
31
32There is no Mac support.  Contact Peter DiCamillo at Brown University if
33you need a Mac tn3270.
34
35The main code change in this version is to what used to be called "telnet.c".
36This is now replaced with a version of telnet (substantially what appeared
37in the "4.3tahoe" release from CSRG) which is broken into separate files.
38
39Here is an overview of the directory structure:
40
41    api/		General library of function needed by API
42			(and, to some extent, by the rest of tn3270).
43
44    arpa/		Location of "telnet.h" (for non-4.3 systems).
45
46    ascii/		Routines necessary to handle the case of running
47			from an ASCII-oriented system (ie: unix).
48
49    ctlr/		The main part of the emulator.  Handles 3270 scan
50			codes, 3270 data stream, 3270 display codes,
51			and EBCDIC.  Also, the internal API function
52			lives here.
53
54    general/		Some general subroutines and data structures of
55			interest to the emulator only.
56
57    sys_curses/		System-dependent code for a curses-based environment.
58
59    sys_dos/		System-dependent code for an MS-DOS-base environment.
60			Remember that this is included for your developmental
61			needs (ie: it doesn't work).
62
63    telnet/		Where the telnet portion of tn3720 is built.
64
65    tools/		Various tools.  Most of these are used during the
66			build process.  One (prt3270) is a debugging tool.
67			One (mkmake.y) is quite horrible, and attempts to
68			transform Unix makefiles into PC makefiles.
69
70    utilities/		The source for tnrecv, which receives files
71			(fairly slowly) from an IBM host.  We don't
72			include the IBM side, because we really aren't
73			happy with very much of it (except that it does,
74			sometimes, work).  Hopefully, when we get past
75			the beta stage we will have more robust (and
76			complete) code to share.
77
78The fact that system dependancies are isolated should make it easy
79to port to other systems.  I would like to hear about problems porting
80to new areas.
81
82In the August, 1987 README file, the following appeared:
83
84> WHAT IS NOT IN THIS VERSION (sigh):
85
86> 1)	We don't have a native X version yet.  I am waiting for X version 11
87> 	(though this is mostly an excuse; I could have done version 10,
88> 	but I haven't had the time).
89
90> 2)	We don't process structured fields.
91
92> 3)	We don't do 3270-style graphics (ala 3193, say).
93
94> The above three items WILL be in the next version, which should come
95> along "any day now" (say 6 months) (but, they WON'T be in the production
96> release of this version).
97
98The next piece of bad news is that none of the above have happened yet,
99and I don't know when they might occur.
100