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

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.