OS2Oberon

                              Oberon for OS/2

                                   V4.0-0.6e
                                   
                              Shareware version

                            (c) 1994-1996 by D.Steiner





INTRODUCTION

    Oberon for OS/2 is an implementation of Oberon for IBM OS/2 2.1 and
    IBM OS/2 Warp 3.
    This is release 0.6e of the ETH Oberon System Version 4.0.

    OS2oberon is shareware with a 30 day evaluation period. The registration
    fee is CHF 50.00 (swiss francs) per copy (see the file Register.TXT for
    registration information).

    This version may be freely distributed with the exception that it must
    not be commercialy distributed without written permission from the
    author.

    Oberon Version 4.0 is a new release that replaces Version 2.2.
    The main difference between V2.2 and V4.0 is the replacement
    of TextFrames by WriteFrames and Edit by Write. A more precise des-
    cription of the differences between V2.2 and V4.0 can be found
    in the text "OberonV4.Text".
    
    This version of Oberon for OS/2 does run on both FAT and HPFS partition
    but does not use advanced features of HPFS filesystem if running on a
    HPFS partition.

    This version of OS2oberon includes the binaries of the Dialog packages
    with the permission from Markus Knasmueller, Uni-Linz, Austria.
    Contact knasmueller@ssw.uni-linz.ac.at to get the sources of the Dialogs
    packages.
    As the standard version of Dialogs can be used, the Dialogs package are
    not included in this release of OS2oberon.


SYSTEM REQUIREMENTS

    Hardware:
    - An IBM Computer or Compatible running IBM OS/2 2.1.
    - A 386, 486 or Pentium processor.
    - 4MB of extended memory (absolute minimum).
    - 5 MB of hard disk space.
    - preferably a screen with resolution of 1024 by 768 pixels
      (although smaller size screens will work, too).
    - preferably a three button mouse (and a mouse driver that
      supports all three mouse buttons).
    
    Software:
    - IBM OS/2 2.1 or IBM OS/2 Warp

RESTRICTIONS
  - color palette is not supported
  - Oberon V4.0-0.6 requires a 16 or 256 color display mode
  - calling nil procedure variables result in wrong trap message (wrong
    location)

CONTENTS

    This disk contains the following files:

    README.TXT    this file (included in the zip file too)
    OBERONV4.EXE  self-extracting archive containing the Oberon System V4
                  for OS/2 2.1 and OS/2 Warp
    INSTALL.CMD   simple installation script

INSTALLATION

    Oberon for OS/2 can be installed either manually or by running the
    installation command file from within a OS/2 command shell.

Manual installation:

1.  Create a new directory, e.g. C:\OBERON. This newly created directory
    will be called "Oberon directory" for the rest of this document.

2.  Copy the files OBERONV4.EXE to the Oberon directory.

3.  Run the self-extracting archive OBERONV4.EXE to extract the Oberon files
    and the Oberon fonts.

4.  All files in the Oberon directory and below should be readonly
    (attrib +r *.*/s)

After manual installation or after running install.cmd

5.  Reboot the machine.



STARTING OBERON

a) From the OS/2 command line

    On the command line, type OBERON. The command line options are:

        OBERON [-h <HeapSizeInMB>]

    for further command line options, see UserGuide (view.exe USERGUID.INF)

    The default value for the heap size is 4MB. Change this value to
    2MB if your system has 4MB only. The minium heap size is 2MB. If
    the heap size is too big, system startup under OS/2 2.1 may take
    a while because OS/2 tries to move other memory blocks in order to
    free a contiguous area of memory.

    When started the first time, Oberon builds up an image of the
    directory structure of all directories indicated in the registry entry
    OBERONDIRS. This may take some time.

a) From the OS/2 desktop

    Create a new program objects (from the template folder drag a program
    object onto the desktop). Specify program name and the default
    working directory. To change the command line options select the Oberon
    program object and choose "Open settings...".



QUITTING OBERON

    Oberon can be quit by either choosing "Close" in the windows
    system menu, by pressing ALT+F4, or by executing the command
    "System.Quit."



SUPPORT FOR TWO-BUTTON MOUSE

    Oberon makes use of all three mouse buttons. On systems with a two-
    button mouse, the middle mouse button is emulated by the control
    key on the keyboard. Pressing the control key is equivalent to
    pressing the middle mouse button.



ONLINE DOCUMENTATION

    There is more documentation about this release of Oberon for OS/2 2.1
    in the file USERGUID.INF (use VIEW.EXE to display USERGUID.INF).
    The Oberon-2 report is now included in the OS/2 INF format and may
    be viewed with the OS/2 program VIEW.EXE (view OBERON2R). In addition
    you can double click on the icons for USERGUID.INF and OBERONR2.INF to
    view there content.
    The differences between Oberon V2.2 and V4.0 are described in the text
    OberonV4.Text.



CONSOLE OUTPUT

    Oberon writes critical error messages to a file only if the option -l
    is specified on the command line. The name of the file is must be
    specified after "-l". It may be convenient to create a program
    icon that starts the notepad utility and displays the log file.

  

Oberon and Oberon for Windows are trademarks of Eidgenoessische
Technische Hochschule, Zurich

Microsoft, MS and MS-DOS are registered trademarks of Microsoft
Corporation.

OS/2 is trademarks of International Business Machines Corporation.

IBM is a registered trademark of International Business Machines Corporation.

Intel is a registered trademark, i486 and Pentium are trademarks of Intel
Corporation.

Dialogs is a graphical user interface to Oberon V4 from Johannes Kepler
University Linz.


Address of Author
-----------------
  Steiner Daniel
  Meienbergstr. 81
  CH-8645 Jona
  (Switzerland)

  e-mail: daniel.steiner@cch.cerberus.ch
