home *** CD-ROM | disk | FTP | other *** search
/ Power DOS 1995 July / Power_DOS_CD-ROM_Walnut_Creek_July_1995.iso / program / oberon_3 / readme.txt < prev    next >
Text File  |  1993-06-30  |  9KB  |  259 lines
  1. System 3  Version 1.2, 11. 6. 93
  2. Copyright (C) 1993 by Institut fuer Computersysteme ETH Zuerich
  3.  
  4.  
  5. Introduction
  6.  
  7. Oberon is both a programming language and an operating environment. It is the 
  8. final outcome of a research project whose aim was an extensible, highly 
  9. integrated and compact  operating platform for single-user personal 
  10. workstations.
  11.  
  12. The original project was launched and carried out by N. Wirth and J. Gutknecht 
  13. for the Ceres workstation. Ported versions of the Oberon language and system 
  14. are now available for numerous commercial machines, among them MacIntosh, IBM 
  15. RS/6000, DEC station, SPARC station and IBM PC/386 compatibles.
  16.  
  17. System 3 is an object-oriented evolution of the original system. It supports a 
  18. generic mechanism for the management of end-user objects and comes with a 
  19. graphical user interface called Gadgets (TM).
  20.  
  21. Literature
  22.  
  23. The following family of books on Oberon is available from Addison-Wesley 
  24. company:
  25.  
  26.     The Oberon System- User Guide and Programmer's Manual,
  27.         by M. Reiser
  28.  
  29.     Programming in Oberon- Steps beyond Modula-2,
  30.         by M. Reiser and N. Wirth
  31.  
  32.     Project Oberon- The Design of an Operating System
  33.         and Compiler, by N. Wirth and J. Gutknecht
  34.  
  35. MS-DOS Oberon
  36.  
  37. Oberon for IBM PC/386 compatibles is henceforth called MS-DOS Oberon. Even 
  38. though MS-DOS Oberon is highly congruent with the original system as described 
  39. in the above listed literature, there are some preconditions and 
  40. implementation specialties to know. The following sections summarize these 
  41. points. They also include a summary of principles of operation and an 
  42. installation guide.
  43.  
  44. Hardware Requirements
  45.  
  46.     1) Intel 80386DX- or 80386SX-processor
  47.     2) 2 megabytes or more of main memory
  48.     3) mouse with 3 buttons and driver
  49.     4) VGA-board
  50.  
  51. Software Requirements
  52.  
  53.     1) DOS version 3.3 or 5.0 
  54.     2) HIMEM.SYS driver for extended memory access
  55.  
  56. Disclaimer
  57.  
  58. Permission to use, copy, modify or distribute this software and its 
  59. documentation for any purpose is hereby granted without fee, provided  that 
  60. the above copyright notice appear in all copies and that both that copyright 
  61. notice and this permission notice appear in supporting documentation, and that 
  62. the name of ETH not be used in advertising or  publicity pertaining to 
  63. distribution of the software without specific, written prior permission.
  64.  
  65. ETH disclaims all warranties with regard to this software, including all 
  66. implied special, indirect or consequential damages or any damages whatsoever 
  67. resulting from loss of use, data or profits, whether in an action of contract, 
  68. negligence or other tortious action, arising out of or in connection with the 
  69. use or performance of this software.
  70.  
  71. Available Packages
  72.  
  73.   SYSTEM.EXE     Basic System 3       
  74.   GADGETS.EXE    Gadgets GUI kit
  75.   SIMULA.EXE     Simulation Package
  76.   LEDA.EXE       Document editor
  77.   DEVELOP.EXE    Developer kit
  78.  
  79. The basic release comprises SYSTEM.EXE and GADGETS.EXE. The other 
  80. packages are available on special order.
  81.  
  82. Contact Address
  83.  
  84. MS-DOS Oberon
  85. Institute for Computer Systems
  86. ETH Zentrum
  87. CH-8092 Zuerich
  88.  
  89. E-mail: Oberon@inf.ethz.ch 
  90. E-Fax: +41 1 2519678
  91.  
  92. Acknowledgement
  93.  
  94. The MS-DOS Oberon project has partly been supported by IBM research 
  95. laboratory, Rueschlikon Switzerland. It has been carried out by A. R. Disteli.
  96.  
  97.  
  98. Principles of Operation and Installation Guide
  99.  
  100. Mode of Operation
  101.  
  102. MS-DOS Oberon principally operates in 386 protected mode in high memory above 
  103. 1 MB. Below the 1 MB limit are video-RAM, extender, system loader, Oberon 
  104. kernel and the procedure activation stack. The extender handles interrupts and 
  105. DOS system calls. It also bootstraps the Oberon module loader and starts the 
  106. Oberon system.
  107.  
  108. Restriction
  109.  
  110. Currently, no other software running in protected mode or V86 mode must be 
  111. installed simultaneously with Oberon. This restriction applies in particular 
  112. to expanded memory managers like EMM386. Also SMARTDRIVE should not be 
  113. installed.
  114.  
  115. File System
  116.  
  117. MS-DOS Oberon maintains its own DOS file directory. It contains all Oberon 
  118. files that are created at Oberon run-time. Note that Oberon file names may be 
  119. up to 31 characters long and may contain an arbitrary number of part-
  120. separators ".". Oberon translates such file names internally into aliasing DOS 
  121. file names and maintains a translation table.
  122.  
  123. In addition, Oberon offers commands System.CopyFromDOS and System.CopyToDOS, 
  124. allowing file copy from arbitrary DOS directories to Oberon and vice versa.
  125.  
  126. Template: System.CopyFromDOS a:/MyDir/Filename.Ext => Oberonname~
  127.  
  128. Diskettes
  129.  
  130. Data transfer from and to diskettes is supported by module Backup. Data on 
  131. Oberon diskettes are stored in a private format that supports full Oberon file 
  132. names. Use commands SetDriveA and SetDriveB to set the current drive.
  133.  
  134. Keyboard
  135.  
  136. The following table shows how to generate special characters under Oberon 
  137. control.
  138.  
  139. special character       key
  140.  
  141. mark viewer     F1      (* Setup *)
  142. no scroll       F2      (* used in program Draw *)
  143. double s        F7
  144. escape          ESC
  145.  
  146. ae              ctrl-a
  147. oe              ctrl-o
  148. ue              ctrl-u
  149. Ae              F8
  150. Oe              F9
  151. Ue              F10
  152.  
  153. ctrl-shift-del  ctrl-break      (* keyboard interrupt *)
  154. ctrl-F10        System.Quit     (* Shortcut *)
  155.  
  156. If the appropriate keyboard driver is installed, ae, oe, ue, Ae, Oe, Ue and 
  157. double-s can also be typed directly.
  158.  
  159. Mouse
  160.  
  161. The standard Oberon user interface is based on a 3-button mouse and on the 
  162. following interpretation of button clicks:
  163.  
  164. Primary clicks:
  165.  
  166.     left: set caret
  167.     middle: execute
  168.     right: select
  169.  
  170. Interclicks while selecting (holding down the right button):
  171.  
  172.    left: delete selected data 
  173.    middle: copy selected data to caret
  174.    left & middle: undo interclick
  175.  
  176. Alternatively, interclicking left/middle can be replaced by pressing ctrl-
  177. key/alt-key on the keyboard.
  178.  
  179. MS-DOS Oberon also supports a 2-button mouse. In this case, the left button 
  180. subsumes the functions execute and set caret. To switch from execute to set 
  181. caret, keep the mouse still and the button pressed for ca. 0.5 sec.
  182.  
  183. Display
  184.  
  185. MS-DOS Oberon by default assumes a VGA display interface with a resolution of 
  186. 640 * 480 * 16. However, support is also provided for the ET4000 Super-VGA 
  187. standard and for cards equipped with a S3 graphics accelerator chipset with a 
  188. resolution of 1024 * 768 * 256. In order to activate the Super-VGA support, 
  189. simply open ET4000.Tool or S3.Tool, execute the renaming command and restart 
  190. Oberon.
  191.  
  192. Printing
  193.  
  194. DOS-Oberon currently supports Postscript and HP PCL printing. To that purpose, 
  195. different drivers are available: The HP500 printer family and Postscript. 
  196. These drivers assume that an appropriate printer device is connected to one of 
  197. the parallel ports LPT1 or LPT2 or the serial ports COM1 or COM2 with 9600 
  198. baud for Postscript printers and 19200 baud for HP printers. If no suitable 
  199. printer is installed, a printfile (Document.Print) is generated on the local 
  200. disk. Simply open Printer.Tool in Oberon, execute the renaming command and 
  201. restart Oberon.
  202.  
  203.  
  204. System Installation and Operation
  205.  
  206. The installation kit consists of the following files:
  207.  
  208.   name                contents
  209.  
  210.   README.TXT          this description
  211.   SYSTEM.EXE          Oberon system in compressed form (selfextracting file)
  212.   CHANGES.TXT         Changes since the last release
  213.  
  214. to install Oberon
  215.  
  216.     1) assert FILES = 64 in CONFIG.SYS
  217.     2) create new directory
  218.     3) copy SYSTEM.EXE into new directory
  219.     4) execute SYSTEM.EXE
  220.  
  221. to load and start Oberon
  222.  
  223.     5) install mouse driver
  224.     6) set directory containing Oberon to current directory
  225.     7) execute OBERON command
  226.  
  227. System Exit
  228.  
  229.     8) Activate command System.Quit
  230.     
  231. Note that alternatively to 6) an environment variable for Oberon can
  232. be specified in the AUTOEXEC.BAT file. 
  233.  
  234. Example:
  235.     PATH C:\WORK; ... others      
  236.     SET OBERON = C:\WORK
  237.  
  238. Getting started with Oberon
  239.  
  240. The above mentioned book The Oberon System- User Guide and Programmer's Manual 
  241. is a complete and comprehensive guide to the basic Oberon system. In addition, 
  242. some online documentation is included in the installation kit, as well as 
  243. several sample source code files:
  244.  
  245. Documentation           Contents
  246.  
  247. ReadMe.Text             This text
  248. OberonGuide.Text        Short guide to the standard system
  249. Tutorial.Text           Short tutorial for getting started (in German)
  250. OberonSystem3.Text      Principles of system 3
  251. ScriptGuide.Text        Guide to the Script text editor
  252.  
  253. Sample Programs in Source Form
  254.  
  255. CopyText.Mod            Copy text command (referred to by Tutorial.Text)
  256. IFS.Mod                 Example from book "Programming in Oberon"       
  257. RandomNumbers.Mod       Example from book "Programming in Oberon"
  258. XYplane.Mod             Example from book "Programming in Oberon"
  259.