home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 2 / AUCD2.iso / program / vista.arc / ReadMe
Text File  |  1996-02-01  |  5KB  |  124 lines
  1.  **************************************************************************
  2.                      Copyright 1996 David Allison
  3.  
  4.              VV    VV    IIIIII     SSSSS     TTTTTT       AA
  5.              VV    VV      II      SS           TT       AA  AA
  6.              VV    VV      II        SSSS       TT      AA    AA
  7.               VV  VV       II           SS      TT      AAAAAAAA
  8.                 VV       IIIIII     SSSS        TT      AA    AA
  9.  
  10.                     MULTI-THREADED C++ WIMP CLASS LIBRARY
  11.                                 for RISC OS
  12.  **************************************************************************
  13.  
  14.              P U B L I C    D O M A I N    L I C E N C E
  15.              -------------------------------------------
  16.  
  17.      This library is copyright. You may not sell the library for
  18.      profit, but you may sell products which use it providing
  19.      those products are presented as executable code and are not
  20.      libraries themselves.  The library is supplied without any
  21.      warranty and the copyright owner cannot be held responsible for
  22.      damage resulting from failure of any part of this library.
  23.  
  24.           See the User Manual for details of the licence.
  25.  
  26.  *************************************************************************
  27.  
  28. Welcome to Vista.  Vista is a library written in C++ for use
  29. when writing desktop applications on Acorn RISC OS machines.
  30. The library is supplied in 2 versions:
  31.  
  32. EasyVista  - A version compiled using Easy C++
  33. AcornVista - A version compiled using Acorn C/C++
  34.  
  35. It is important that you use the correct version for your system as
  36. the two C++ systems are not compatible at the object code level.
  37. The libraries are located in the directory <Vista$Dir>.Library.
  38.  
  39. The disk also contains a module called DrawFile.  This is written
  40. by Acorn and is public domain.  This should be loaded before running
  41. a program written using Vista as some of the Vista code uses the
  42. SWIs it provides.
  43.  
  44. The disk contains the following:
  45.  
  46. 1. !Hyperview
  47.    An HTML viewer application.  This is used to view the Vista user
  48.    manual.
  49.    
  50. 2. !Manual
  51.    Double-click on this to view the hypertext User Manual.
  52.    
  53. 3. !Vista
  54.    This small application sets up the required paths for use with
  55.    a C++ compiler.  The directory contains the Vista libraries
  56.    and all header files.  Please make sure that you choose the correct
  57.    library for your C++ compiler.
  58.  
  59. 4. Examples
  60.    This is an archive containing a set of example programs.  These
  61.    were written in Easy C++ using Vista and are supplied with
  62.    full source code.  Because of lack of disk space, they are
  63.    supplied without executable code.  You will need to compile
  64.    them to use them.  See the section below for further details:
  65.    
  66. 5. Source
  67.    An archive containing the source code for the Vista library.
  68.    
  69. 6. Utilities
  70.    This consists of public domain support utilities which are
  71.    useful (and necessary) when using Vista.  It contains:
  72.    
  73.    DrawFile:  A relocatable module written by Acorn.  It is used to
  74.               display draw files on the screen.  It must be loaded
  75.               before the Vista can be used properly.
  76.  
  77.    Templates: A set of templates written by Acorn from the
  78.               RISC OS Style Guide.  They can be copied into
  79.               your own template files using a template editor.
  80.               
  81. Please read the manual before using Vista - it will make
  82. your life much easier.
  83.  
  84.  
  85. Example Programs
  86. ----------------
  87.  
  88. The example programs supplied are compilable under both Easy C++ and
  89. Acorn C++.  Easy C++ uses the files in the 'c' directory and
  90. doesn't care if they are C or C++ files.  Acorn C++ requires the
  91. files to be in a directory called 'c++'.  The programs are
  92. set up for use with Easy C++, so if you want to use Acorn C++
  93. you will need to rename the 'c' directory to 'c++'.
  94.  
  95.  
  96.  
  97. Use with Acorn C/C++
  98. --------------------
  99.  
  100. Vista was written for use with Easy C++, but can be used
  101. with Acorn C++.  Versions compiled using both systems
  102. are supplied.
  103.  
  104. To use Acorn C++ you will need to link with the library 
  105. Vista:Library.AcornVista (along with stubs and c++lib).  With
  106. Easy C++, select the library EasyVista from the library
  107. menu on the front end.
  108.  
  109. Vista defines a macro called 'throw' which calls a function __throw()
  110. if you are using Acorn C++.  This simply prints the error to the
  111. screen and exits.  With Easy C++, the exception is properly caught.
  112.  
  113. If you examine the source code for the examples you will see that
  114. the predefined macro __EASY_C is used to switch on the exception
  115. handling within the program.  This macro is not defined by
  116. Acorn C++ so the exceptions will not be used.  The __EASY_C
  117. macro is only available in Easy C++ version 1.55/2.35 or later.
  118.  
  119. When compiling with Acorn C++ you will find a number of spurious
  120. warnings with certain Vista header files.  These are not problems
  121. with the library, but are because of the AT&T Cfront translator
  122. being over zealous with its warnings.
  123.  
  124.