Return to README CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / tn3270 / distribution

Annotation of 43BSDReno/usr.bin/tn3270/distribution/README, revision 1.1

1.1     ! root        1: Welcome to the new tn3270 - version 4.1.1.
        !             2: 
        !             3: This version consists entirely of bug fixes to the August 1987 beta release
        !             4: of tn3270.  This version will now deal with CICS and VM/XA on the IBM
        !             5: side, and with SunOS 4.0 on Sun 3's and Sun 4's.
        !             6: 
        !             7: This version has been tested on various versions of BSD Unix, including
        !             8: 4.2 and 4.3 (but there are never vanilla versions) and the post-4.3 systems
        !             9: running at Berkeley.  It has been tested on CCI's, Vaxen, Sun 3's and Sun 4's.
        !            10: However, it doesn't necessarily work on all systems (nor has the testing
        !            11: been as intensive as one might like).
        !            12: 
        !            13: This version should build on any Berkeley-derived system.
        !            14: 
        !            15: There 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: 
        !            24: The bad news is that I've had to drop MS-DOS support.  The good news here is
        !            25: that there are various versions available for MS-DOS (from FTP Software in
        !            26: Cambridge, Mass.; from IBM; from Excelan; and probably from others).  The
        !            27: hooks are still there, as well as some code to update the screen.  However,
        !            28: I 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
        !            30: in it.
        !            31: 
        !            32: There is no Mac support.  Contact Peter DiCamillo at Brown University if
        !            33: you need a Mac tn3270.
        !            34: 
        !            35: The main code change in this version is to what used to be called "telnet.c".
        !            36: This is now replaced with a version of telnet (substantially what appeared
        !            37: in the "4.3tahoe" release from CSRG) which is broken into separate files.
        !            38: 
        !            39: Here 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: 
        !            78: The fact that system dependancies are isolated should make it easy
        !            79: to port to other systems.  I would like to hear about problems porting
        !            80: to new areas.
        !            81: 
        !            82: In 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: 
        !            98: The next piece of bad news is that none of the above have happened yet,
        !            99: and I don't know when they might occur.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.