home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Libraries / stdwin / README < prev   
Encoding:
Text File  |  1993-07-30  |  7.3 KB  |  218 lines  |  [TEXT/????]

  1. STDWIN ESSENTIAL INFORMATION
  2. ****************************
  3.  
  4. [last edit: 30 July 1993]
  5.  
  6.  
  7. What Is STDWIN
  8. ==============
  9.  
  10. STDWIN (STanDard Window INterface -- similar to STDIO) is a simple
  11. windowing interface for C programs, that is implemented on various
  12. platforms.  The "flagship" implementations support the Macintosh and
  13. X11 windowing environments.  The emphasis is on portability between
  14. platforms and a simple interface to the application, not on getting
  15. the maximum performance or functionality of one particular platform.
  16.  
  17. For a longer introduction, read the (still outdated) file Doc/ABOUT.
  18. For more information on the Macintosh version, read Ports/mac/README.
  19. For MS-DOS, read Ports/msdos/README.
  20.  
  21.  
  22. Supported Platforms
  23. ===================
  24.  
  25. Currently, programs using STDWIN can be made to run on Unix under X11,
  26. on alphanumeric terminals (using termcap -- obviously with some loss
  27. of functionality), on the Apple Macintosh (using THINK C 5.0), or on
  28. MS-DOS with a dumb display (using Microsoft C).  I am working on
  29. patches to get the Mac port running under MPW 3.x (which is quite
  30. different in some respects from MPW 2.x); contact me if you need this
  31. urgently.  If you insist, I also have two versions for the Atari ST
  32. (one for MWC and one for TurboC) that need a lot of dusting off, and
  33. haven't been upgraded to all the lovely new features.
  34.  
  35.  
  36. Copyright
  37. =========
  38.  
  39. Copyright 1988, 1989, 1991, 1992, 1993 by Stichting Mathematisch
  40. Centrum, Amsterdam, The Netherlands.
  41.  
  42.                         All Rights Reserved
  43.  
  44. Permission to use, copy, modify, and distribute this software and its 
  45. documentation for any purpose and without fee is hereby granted, 
  46. provided that the above copyright notice appear in all copies and that
  47. both that copyright notice and this permission notice appear in 
  48. supporting documentation, and that the names of Stichting Mathematisch
  49. Centrum or CWI not be used in advertising or publicity pertaining to
  50. distribution of the software without specific, written prior permission.
  51.  
  52. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
  53. THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  54. FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
  55. FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  56. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  57. ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  58. OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  59.  
  60.  
  61. This is Version 0.9.8
  62. =====================
  63.  
  64. I believe it is a mature product, except for the lack of complete
  65. documentation.  When I have finished the manual I'll release version
  66. 1.0, and post it to an appropriate comp.sources group.
  67.  
  68. *** News since 0.9.7: bitmap support; wsetfont returns error;
  69. wlistfontnames; wsetwinpos, wsetwinsize.
  70.  
  71.  
  72. Where To Get STDWIN
  73. ===================
  74.  
  75. I have placed a copy of the tar image named stdwin0.9.8.tar.Z on the
  76. ftp server ftp.cwi.nl (IP address 192.16.184.180) in directory pub.
  77.  
  78. Don't forget to specify binary file transfer mode when transferring
  79. compressed or tar files!  ("type binary")
  80.  
  81. If you don't have ftp access, send mail containing only the word HELP
  82. to ftpmail@decwrl.dec.com or bitftp@pucc.princeton.edu, and the
  83. server will send you instructions on how to make requests.
  84.  
  85.  
  86. Getting Started Right Now
  87. =========================
  88.  
  89. For some common systems, the system knows how to configure itself
  90. automatically.  This works for:
  91.  
  92.     Hardware            Operating System
  93.  
  94.     DEC VAX, DECstation        Ultrix 2.2 or 3.0
  95.     Sun3, Sun4            SunOS 4.0 or 4.1
  96.     Silicon Graphics Personal IRIS    IRIX 3.2 or 3.3
  97.     Harris HCX-7 (tahoe)        BSD 4.3
  98.  
  99. (For other OS versions on these or similar machines, give it a try
  100. anyway, it may work as well, especially if there is a program called
  101. "arch" or "machine" that prints the machine type.)  To build STDWIN
  102. for X11 on such systems:
  103.  
  104.     cd Conf
  105.     ./mkmf                # answer all questions with yes
  106.     cd ..
  107.     cd Build/<arch>/x11/lib        # <arch> is `machine` or `arch`
  108.     make
  109.  
  110. This creates the STDWIN library for X11 on a file named "lib.a".
  111. To build the standard test/demo application, "miniedit" (first chdir
  112. back to the top of the STDWIN source tree):
  113.  
  114.     cd Conf
  115.     ./mkmf miniedit
  116.     cd ..
  117.     cd Build/<arch>/x11/miniedit
  118.     make
  119.  
  120. To try it out, use it to have a look at the Makefile:
  121.  
  122.     miniedit Makefile
  123.  
  124.  
  125. If It Doesn't Work Right Away
  126. =============================
  127.  
  128. You may have to create new Makefile prototypes in subdirectory Conf, or
  129. fix the mkmf script there.
  130.  
  131. The configuration system works as follows.  Sources and objects live in
  132. separate directories.  There are no tools like "imake" nor nonstandard
  133. make features like "VPATH" used.  Instead, all Makefiles are generated
  134. by simple, easy-to-understand shell scripts living in Conf.  It is
  135. possible to say "make" in any leaf subdirectory of Build.
  136.  
  137. Read Conf/README for more information.
  138.  
  139.  
  140. The STDWIN source tree
  141. ======================
  142.  
  143. The STDWIN tree is organized as follows.  Starting from the top of the
  144. tree (where this README file lives), we have:
  145.  
  146.     .        Top-level directory.
  147.  
  148.     README        The file you are now reading.
  149.  
  150.     H/        Public header files of STDWIN ports and
  151.             packages.  Stdwin applications should pass this
  152.             directory to the compiler in a "-I" option.
  153.  
  154.     Tools/        Subroutines used by various ports and
  155.             applications; not STDWIN-specific.
  156.             (This has now been truncated to the bare
  157.             minimum.)
  158.  
  159.     Gen/        (Almost) generic versions of some STDWIN
  160.             functions, used by more than one port.  (Some
  161.             are dummies that ignore the request or always
  162.             fail.)
  163.  
  164.     Ports/        Source for various ports.
  165.             Note: not all subdirectories are distributed!
  166.  
  167.     Ports/x11/    Port to X11 R4; uses Xlib only.
  168.     Ports/alfa/    Port for alphanumeric displays using termcap/terminfo.
  169.     Ports/vtrm/    VTRM (virtual terminal) package used by Ports/alfa.
  170.     Ports/atrm/    Amoeba support or verion for VTRM (old).
  171.     Ports/proto/    Dummy routines to start a new port (ancient).
  172.     Ports/stubs/    RPC-style stubs (ancient).
  173.     Ports/mg1/    Obsolete Whitechapel MG-1 port.
  174.     Ports/atari/    Atari ST port, for Mark Williams C compiler.
  175.     Ports/atari_turbo/    (Newer) Atari ST port, for TurboC.
  176.     Ports/mac/    Apple Macintosh port (both MPW and THINK C).
  177.     Ports/msdos/    MS-DOS port (uses the alfa port mostly).
  178.     (etc)
  179.  
  180.     Packs/        Source for packages (libraries) on top of STDWIN.
  181.  
  182.     Packs/textedit/    Standard text-editing package.
  183.     Packs/vt/    Virtual terminal package (needs some work).
  184.     packs/buttons/    Probably not useful, and broken.
  185.  
  186.     Appls/        Source for test programs and real applications.
  187.  
  188.     Appls/README    Read this for more information.
  189.  
  190.     Doc/        Documentation for STDWIN and packages.
  191.             Unfortunately this is terribly out of date.
  192.  
  193.     Doc/ABOUT    Blurb to be sent to prospective users.
  194.     Doc/paper.ms    The original paper (CWI report CS-R8817) (*troff -ms).
  195.     (etc)
  196.  
  197.     Conf/        Configuration scripts and prototype Makefiles.
  198.  
  199.     Conf/README    Read this before twiddling the configuration.
  200.     Conf/mkmf    Script to build Makefiles.
  201.     Conf/mkall    Script to build Makefiles for allo applications.
  202.     Conf/proto.*    Makefile fragments used by mkmf.
  203.     Conf/*        Scripts used by mkmf.
  204.  
  205.     Build/        Contains subdirectories where the various
  206.             ports are built for various architectures.
  207.  
  208.     Build/sun3/    Sun3 (680x0) under SunOS 4.1
  209.     Build/sun4/    Sun4 (SPARC) under SunOS 4.1
  210.     Build/sgi/    Silicon Graphics under IRIX 3.2
  211.     Build/mips/    DEC RISC architecture under Ultrix 3.0
  212.     Build/vax/    DEC VAX under Ultrix 2.2
  213.     (etc)
  214.  
  215.  
  216. --Guido van Rossum, CWI, Amsterdam <Guido.van.Rossum@cwi.nl>
  217. "The life of a Repo Man is always intense"
  218.