Return to README CVS log

Up to [Research Unix] / researchv9 / jtools / src / sunlib

Annotation of researchv9/jtools/src/sunlib/README, revision 1.1

1.1     ! root        1: This is a single library that allows jerq(AT&T 5620 Terminal)
        !             2: code to run on X11 or sunwindows.  It should be useful for porting
        !             3: jerq code to suns and educational for comparing the three
        !             4: different window systms.  The improved getrect routine
        !             5: (ngetrect) that does optional blocking and clipping, and the
        !             6: jerq hierarchical menus are courtesy of Jon Helfman.
        !             7: The suntools code avoids all calls to sunview except "fullscreen" in order
        !             8: to minimize the size of the executables (which are still twice as big as
        !             9: the X11 programs).
        !            10: 
        !            11: Care was taken to make the library code look just like the jerq code.
        !            12: But there are still a couple of problems that require source code changes.
        !            13: These are documented in great detail in the T.M.:
        !            14: 
        !            15: D. A. Kapilow and J. I. Helfman, "A 5620 Emulator Library for Version
        !            16: 11 X Windows abd Suntools", 11228-880525-06TMS.
        !            17: 
        !            18: For example, Cursors and Textures must be registered with the server in X11
        !            19: before use, although this is not necessary with the sun library. Fonts are
        !            20: also different, although defont can still be used in most cases.
        !            21: A new macro: defontheight can be used instead of defont.height to get
        !            22: the maximum height of characters in the default font. Most of the
        !            23: differences should be clear by glancing at the test programs:
        !            24: 
        !            25: t0:    tests bitblt, rectf, screenswap, point, texture, balloc
        !            26: t1:    tests circle, ellipse, disc, eldisc, arc, elarc, segment,
        !            27:                string, and cursswitch
        !            28: t2:    tests non-hierarchical menus, string, and keyboard input
        !            29: t3:    a simple slider bar
        !            30: t4:    tests ngetrect (an improved getrect), getrect, texture, and rectf
        !            31: t5:    tests hierarchical menus
        !            32: t6:    alarm and ngetrect
        !            33: 
        !            34: Preprocessor defines are used to compile the library and applications
        !            35: for different environments.  Possible window system flags are
        !            36:        -DSUNTOOLS or -DX11
        !            37: while operating system switches are
        !            38:        -DBSD (for a Sun) and -DV9 (for Ninth Edition)
        !            39: The x11 and suntools subdirectories include the appropriate mk and make files.
        !            40: Type "mk all" in each directory to build the libraries and tests if you
        !            41: have A. Hume's mk, or "make all" if you don't.
        !            42: 
        !            43: There is a companion T.M. describing some of the tools that have been
        !            44: ported with the library:
        !            45: D. A. Kapilow, "A Set of (Old 5620) Tools for Version 11 X Windows
        !            46: and Suntools", 11228-880706-09TMS.
        !            47: 
        !            48: Dave Kapilow           alice!dak
        !            49: Jon Helfman            alice!jon

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