home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / OBERON20.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1993-04-26  |  8.7 KB  |  267 lines
  1. Oberon (TM) for MS-DOS Systems,  
  2.  
  3. Version 2.0 / 3.1, 1. 4. 93
  4.  
  5. Copyright (C) 1993 by Institut fuer Computersysteme ETH Zuerich
  6.  
  7.  
  8.  
  9.  
  10.  
  11. Introduction
  12.  
  13.  
  14.  
  15. Oberon is both a programming language and an operating environment. It is the 
  16.  
  17. final outcome of a research project whose aim was an extensible, highly 
  18.  
  19. integrated and compact  operating platform for single-user personal 
  20.  
  21. workstations.
  22.  
  23.  
  24.  
  25. The original project was launched and carried out by N. Wirth and J. Gutknecht 
  26.  
  27. for the Ceres workstation. Ported versions of the Oberon language and system 
  28.  
  29. are now available for numerous commercial machines, among them MacIntosh, IBM 
  30.  
  31. RS/6000, DEC station, SPARC station and IBM PC/386 compatibles.
  32.  
  33.  
  34.  
  35. Version 3 is an object-oriented evolution of the original system. It supports 
  36.  
  37. a generic mechanism for the management of end-user objects and comes with a 
  38.  
  39. graphical user interface called Gadgets (TM).
  40.  
  41.  
  42.  
  43. Literature
  44.  
  45.  
  46.  
  47. The following family of books on Oberon is available from Addison-Wesley 
  48.  
  49. company:
  50.  
  51.  
  52.  
  53.     The Oberon System- User Guide and Programmer's Manual,
  54.  
  55.         by M. Reiser
  56.  
  57.  
  58.  
  59.     Programming in Oberon- Steps beyond Modula-2,
  60.  
  61.         by M. Reiser and N. Wirth
  62.  
  63.  
  64.  
  65.     Project Oberon- The Design of an Operating System
  66.  
  67.         and Compiler, by N. Wirth and J. Gutknecht
  68.  
  69.  
  70.  
  71. A detailed user's and programmer's guide to the Gadgets system and a tool 
  72.  
  73. assisting with the migration to Version 3 are included in the online 
  74.  
  75. documentation.
  76.  
  77.  
  78.  
  79. MS-DOS Oberon
  80.  
  81.  
  82.  
  83. Oberon for IBM PC/386 compatibles is henceforth called MS-DOS Oberon. Even 
  84.  
  85. though MS-DOS Oberon is highly congruent with the original system as described 
  86.  
  87. in the above listed literature, there are some preconditions and 
  88.  
  89. implementation specialties to know. The following sections summarize these 
  90.  
  91. points. They also include a summary of principles of operation and an 
  92.  
  93. installation guide.
  94.  
  95.  
  96.  
  97. Hardware Requirements
  98.  
  99.  
  100.  
  101.     1) Intel 80386DX- or 80386SX-processor
  102.  
  103.     2) 2 megabytes or more of main memory
  104.  
  105.     3) mouse with 2 or 3 buttons and driver
  106.  
  107.     4) VGA-board
  108.  
  109.  
  110.  
  111. Software Requirements
  112.  
  113.  
  114.  
  115.     1) DOS version 3.3 or 5.0 
  116.  
  117.     2) HIMEM.SYS driver for extended memory access
  118.  
  119.  
  120.  
  121. Disclaimer
  122.  
  123.  
  124.  
  125. Permission to use, copy, modify or distribute this software and its 
  126.  
  127. documentation for any purpose is hereby granted without fee, provided  that 
  128.  
  129. the above copyright notice appear in all copies and that both that copyright 
  130.  
  131. notice and this permission notice appear in supporting documentation, and that 
  132.  
  133. the name of ETH not be used in advertising or  publicity pertaining to 
  134.  
  135. distribution of the software without specific, written prior permission.
  136.  
  137.  
  138.  
  139. ETH disclaims all warranties with regard to this software, including all 
  140.  
  141. implied special, indirect or consequential damages or any damages whatsoever 
  142.  
  143. resulting from loss of use, data or profits, whether in an action of contract, 
  144.  
  145. negligence or other tortious action, arising out of or in connection with the 
  146.  
  147. use or performance of this software.
  148.  
  149.  
  150.  
  151. Contact Address
  152.  
  153.  
  154.  
  155. MS-DOS Oberon
  156.  
  157. Institute for Computer Systems
  158.  
  159. ETH Zentrum
  160.  
  161. CH-8092 Zuerich
  162.  
  163.  
  164.  
  165. E-mail: Oberon@inf.ethz.ch 
  166.  
  167. E-Fax: +41 1 2519678
  168.  
  169.  
  170.  
  171. Acknowledgement
  172.  
  173.  
  174.  
  175. The MS-DOS Oberon project has partly been supported by IBM research 
  176.  
  177. laboratory, Rueschlikon Switzerland. It has been carried out by A. R. Disteli.
  178.  
  179.  
  180.  
  181.  
  182.  
  183. Principles of Operation and Installation Guide
  184.  
  185.  
  186.  
  187. Mode of Operation
  188.  
  189.  
  190.  
  191. MS-DOS Oberon principally operates in 386 protected mode in high memory above 
  192.  
  193. 1 MB. Below the 1 MB limit are video-RAM, extender, system loader, Oberon 
  194.  
  195. kernel and the procedure activation stack. The extender handles interrupts and 
  196.  
  197. DOS system calls. It also bootstraps the Oberon module loader and starts the 
  198.  
  199. Oberon system.
  200.  
  201.  
  202.  
  203. Restriction
  204.  
  205.  
  206.  
  207. Currently, no other software running in protected mode or V86 mode must be 
  208.  
  209. installed simultaneously with Oberon. This restriction applies in particular 
  210.  
  211. to expanded memory managers like EMM386. Also SMARTDRIVE should not be 
  212.  
  213. installed.
  214.  
  215.  
  216.  
  217. File System
  218.  
  219.  
  220.  
  221. MS-DOS Oberon maintains its own DOS file directory. It contains all Oberon 
  222.  
  223. files that are created at Oberon run-time. Note that Oberon file names may be 
  224.  
  225. up to 31 characters long and may contain an arbitrary number of part-
  226.  
  227. separators ".". Oberon translates such file names internally into aliasing DOS 
  228.  
  229. file names and maintains a translation table.
  230.  
  231.  
  232.  
  233. In addition, Oberon offers commands System.CopyFromDOS and System.CopyToDOS, 
  234.  
  235. allowing file copy from arbitrary DOS directories to Oberon and vice versa.
  236.  
  237.  
  238.  
  239. Template:  System.CopyFromDOS a:/MyDir/Filename.Ext => Oberonname~
  240.  
  241.  
  242.  
  243. Diskettes
  244.  
  245.  
  246.  
  247. Data transfer from and to diskettes is supported by module Backup. Data on 
  248.  
  249. Oberon diskettes are stored in a private format that supports full Oberon file 
  250.  
  251. names. Use commands SetDriveA and SetDriveB to set the current drive.
  252.  
  253.  
  254.  
  255. Keyboard
  256.  
  257.  
  258.  
  259. The following table shows how to generate special characters under Oberon 
  260.  
  261. control.
  262.  
  263.  
  264.  
  265. special character    key
  266.  
  267.  
  268.  
  269. mark viewer    F1    (* Setup *)
  270.  
  271. no scroll    F2    (* used in program Draw *)
  272.  
  273. double s    F7
  274.  
  275. escape    ESC
  276.  
  277.  
  278.  
  279. ae    ctrl-a
  280.  
  281. oe    ctrl-o
  282.  
  283. ue    ctrl-u
  284.  
  285. Ae    F8
  286.  
  287. Oe    F9
  288.  
  289. Ue    F10
  290.  
  291.  
  292.  
  293. ctrl-shift-del    ctrl-break    (* keyboard interrupt *)
  294.  
  295.  
  296.  
  297. If the appropriate keyboard driver is installed, ae, oe, ue, Ae, Oe, Ue and 
  298.  
  299. double-s can also be typed directly.
  300.  
  301.  
  302.  
  303. Mouse
  304.  
  305.  
  306.  
  307. The standard Oberon user interface is based on a 3-button mouse and on the 
  308.  
  309. following interpretation of button clicks:
  310.  
  311.  
  312.  
  313. Primary clicks:
  314.  
  315.  
  316.  
  317.     left: set caret
  318.  
  319.     middle: execute
  320.  
  321.     right: select
  322.  
  323.  
  324.  
  325. Interclicks while selecting (holding down the right button):
  326.  
  327.  
  328.  
  329.    left: delete selected data 
  330.  
  331.    middle: copy selected data to caret
  332.  
  333.    left & middle: undo interclick
  334.  
  335.  
  336.  
  337. Alternatively, interclicking left/middle can be replaced by pressing ctrl-
  338.  
  339. key/alt-key on the keyboard.
  340.  
  341.  
  342.  
  343. Preverably install a Logitech Mouse Driver V6.0 (Included in this release 
  344.  
  345. named MOUSE.COM). MS-DOS Oberon also supports a 2-button mouse. In this case, 
  346.  
  347. the left button subsumes the functions execute and set caret. To switch from 
  348.  
  349. execute to set caret, keep the mouse still and the button pressed for ca. 0.5 
  350.  
  351. sec.
  352.  
  353.  
  354.  
  355. Display
  356.  
  357.  
  358.  
  359. MS-DOS Oberon by default assumes a VGA display interface with a resolution of 
  360.  
  361. 640 * 480 * 16. However, support is also provided for the ET4000 Super-VGA 
  362.  
  363. standard with a resolution of 1024 * 768 * 256. In order to activate the Super-
  364.  
  365. VGA support, simply open ET4000.Tool, execute the renaming command and restart 
  366.  
  367. Oberon.
  368.  
  369.  
  370.  
  371. Printing
  372.  
  373.  
  374.  
  375. DOS-Oberon currently supports Postscript and HP PCL printing. To that purpose, 
  376.  
  377. different drivers are available: The HP500 printer family and Postscript. 
  378.  
  379. These drivers assume that an appropriate printer device is connected to one of 
  380.  
  381. the parallel ports LPT1 or LPT2 or the serial ports COM1 or COM2 with 9600 
  382.  
  383. baud for Postscript printers and 19200 baud for HP printers. If no suitable 
  384.  
  385. printer is installed, a printfile (Document.Print) is generated on the local 
  386.  
  387. disk. Simply open Printer.Tool in Oberon, execute the renaming command and 
  388.  
  389. restart Oberon.
  390.  
  391.  
  392.  
  393.  
  394.  
  395. System Installation and Operation
  396.  
  397.  
  398.  
  399. The installation kit consists of the following files:
  400.  
  401.  
  402.  
  403.     name                contents
  404.  
  405.  
  406.  
  407.     README.TXT    this description
  408.  
  409.     SYSTEM.EXE     Oberon system in compressed form (selfextracting file)
  410.  
  411.     CHANGES.TXT   Changes since the last release
  412.  
  413.  
  414.  
  415. to install Oberon
  416.  
  417.  
  418.  
  419.     1) assert FILES = 64 in CONFIG.SYS
  420.  
  421.     2) create new directory
  422.  
  423.     3) copy SYSTEM.EXE into new directory
  424.  
  425.     4) execute SYSTEM.EXE
  426.  
  427.  
  428.  
  429. to load and start Oberon
  430.  
  431.  
  432.  
  433.     5) install mouse driver
  434.  
  435.     6) set directory containing the Oberon system to current directory
  436.  
  437.     7) execute START command
  438.  
  439.  
  440.  
  441. System Exit
  442.  
  443.  
  444.  
  445.     8) Activate command System.Quit
  446.  
  447.  
  448.  
  449. Getting started with Oberon
  450.  
  451.  
  452.  
  453. The above mentioned book The Oberon System- User Guide and Programmer's Manual 
  454.  
  455. is a complete and comprehensive guide to the basic Oberon system. In addition, 
  456.  
  457. online documentation for the Gadgets system is included in the installation 
  458.  
  459. kit, as well as some sample source code files. See the different tools for 
  460.  
  461. prepared opening commands.
  462.  
  463.  
  464.  
  465.  
  466.  
  467. List of installed Oberon packages
  468.  
  469.  
  470.  
  471.  Program packages
  472.  
  473.  
  474.  
  475.     Basic system
  476.  
  477.     Compiler
  478.  
  479.     Edit    program editor
  480.  
  481.     Paint    picture editor
  482.  
  483.     
  484.  
  485.     Script (V3) /Write (V2)    text editor
  486.  
  487.     Illustrate (V3) /Draw (V2)    graphic editor
  488.  
  489.     Gadgets (V3 only)
  490.  
  491.  
  492.  
  493. Program samples in source form
  494.  
  495.  
  496.  
  497.     Biorhythm.Mod    calculates biorythm
  498.  
  499.     RandomNumbers.Mod    generates good random numbers
  500.  
  501.     IFS.Mod    generates fractal fern graphic
  502.  
  503.  
  504.  
  505. Online documentation
  506.  
  507.  
  508.  
  509.     ReadMe.Text    this text
  510.  
  511.     OberonGuide.Text  
  512.  
  513.     GadgetsGuide.Text    Version 3 user's and programmer's guide
  514.  
  515.  
  516.  
  517. Fonts
  518.  
  519.  
  520.  
  521.     Courier    monospace font
  522.  
  523.     Syntax    proportional text font
  524.  
  525.     Elektra    general symbols
  526.  
  527.     Math    mathematical symbols
  528.  
  529.  
  530.  
  531. 
  532.