home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 July / Chip_2004-07_cd1.bin / tema / aos / files / oberon-readme.txt < prev    next >
Text File  |  2004-05-24  |  10KB  |  263 lines
  1. ETH PlugIn Oberon for Windows 9x / ME / NT / 2000
  2.  
  3. Oberon is both the name of a programming language and operating system 
  4. developed at ETH Zuerich. This particular distribution contains an 
  5. implementation of ETH PlugIn Oberon Release 2.4 for Windows 9x / ME / NT / 
  6. 2000.
  7.  
  8.  
  9. SYSTEM REQUIREMENTS
  10.  
  11. Hardware:
  12.   - 20 MB of hard disk space.
  13.   - Preferably a screen with a resolution of 1024 by 768 pixels with at
  14.     least 32768 colors.
  15.   - Preferably a three-button mouse and a mouse driver that supports all 
  16.     three mouse buttons. A 2-button mouse may be used instead but with less 
  17.     comfort.
  18.  
  19. Software:
  20.   - Microsoft Windows 9x / ME / NT / 2000
  21.  
  22.  
  23. INSTALLATION OF OBERON
  24.  
  25.   Oberon is delivered as a number of self-extracting EXE files.
  26.  
  27.   System1.exe - Oberon and Gadgets system files, tools, libraries, panels 
  28.   System2.exe - Oberon and Gadgets object files
  29.   Docu.exe    - Documentation and books
  30.   Src.exe     - Source code for all system modules
  31.   Fonts.exe   - Windows display fonts (*.FON)
  32.   PrFnt.exe   - 600 and 200 dpi printer fonts.
  33.   AppsAH.exe  - Application Packages A .. H
  34.   AppsIZ.exe  - Application Packages I .. Z
  35.  
  36. Installation step-by-step
  37.  
  38. If you re-install Oberon or upgrade your Oberon version, it is strongly 
  39. recommended to install Oberon in a new directory. Once you have configured 
  40. your new Oberon system you can copy files from the old installation as you 
  41. need them. To remove registry entries of a previous Oberon installation use
  42. the OberonReg.exe utility.
  43.  
  44. 1. Create a new directory, e.g. C:\ETHOberon. This newly created directory 
  45.    will be called "Oberon directory" for the rest of this document.
  46.  
  47. 2. Extract the files System1.exe, System2.exe, Docu.exe and Src.exe to the  
  48.    Oberon directory, by executing the EXE files.
  49.  
  50. 3. Merge the settings in oberon.reg with your windows registry by selecting  
  51.    the "Merge" entry in the context menu of the oberon.reg icon.
  52.  
  53. 4. Drag the Oberon.EXE file from the Oberon directory to your desktop to 
  54.    create a shortcut. Double-click the Oberon icon to start Oberon.
  55.  
  56. 5. In older version of Oberon for Windows you could use the "Ctrl" key to
  57.    simulate a missing middle mouse button. This version features a new
  58.    emulation scheme for your missing middle mouse button. See 
  59.    Distribution.Text for more details.
  60.  
  61. 6. The command System.Quit terminates the Oberon application. The Oberon
  62.    application may also be terminated by closing all windows.
  63.  
  64. 7. For faster text output you may install the Windows versions of the Oberon 
  65.    bitmap fonts. Extract the files in Fonts.exe to a temporary directory and 
  66.    start the "Fonts" control panel application and choose the "File / 
  67. Install 
  68.    New Font" menu entry. A "Add Font" dialog will pop-up, locate the Oberon 
  69.    font files (*.Scn.Fnt) in the temporary directory and start the 
  70.    installation by clicking on "Ok".
  71.  
  72. 8. For further setup steps see: Setup.Tool.
  73.  
  74.  
  75. RELEASE NOTES
  76.  
  77. "Oberon System 3" and "ETH Oberon"
  78.  
  79. As you may allready have noticed, that we use now the name "ETH Oberon" for
  80. "Oberon System 3".
  81.  
  82.  
  83. Mouse
  84.  
  85. In older version of Oberon for Windows you could use the "Ctrl" key to 
  86. simulate a missing middle mouse button. Since this conflicts with commonly 
  87. used shortcuts (Clipboard, ...), you must use the context menu key (Win95 
  88. keyboard) as middle mouse button replacement. Note: this release does also 
  89. support 2-button mice directly, see: Mouse.Text.
  90.  
  91. To check how mouse buttons are mapped by your Windows mouse driver use the 
  92. TestMouse.exe utility.
  93.  
  94.  
  95. Registry
  96.  
  97. By default module Registry stores settings under the key:
  98.  
  99.   HKEY_CURRENT_USER\Software\ETH PlugIn Oberon\Release 2.4
  100.  
  101. This key is constructed using the version resource entries "FileDescription" 
  102. and "FileVersion" found in oberon.exe (or oberon.dll). You can override the
  103. "FileVersion" part by providing a new version string as command line 
  104. parameter to oberon.exe.
  105. E.g.: oberon.exe -Registry=MyVersion will start an Oberon system which 
  106. reads its settings from:
  107.  
  108.   HKEY_CURRENT_USER\Software\ETH Oberon\MyVersion
  109.  
  110. Note: command line parameters passed to oberon.exe are append to the
  111. Oberon.Text in a section called CommandLine. Thus to get the value for a
  112. command line parameter named "Name" use Oberon.OpenScanner(S, 
  113. "CommandLine.Name").
  114.  
  115.  
  116. Display
  117.  
  118. Module Display is now based on a new module Displays. This makes it possible
  119. to use multiple logical displays. Where a display is either an application 
  120. window, control window or an offscreen bitmap. This is the basis for 
  121. technologies like "Oberon Documents on the Windows Desktop", "ActiveX 
  122. controls" or the "Netscape Browser Plugin".
  123.  
  124.  
  125. Fonts
  126.  
  127. The Fonts module has been split into the modules Fonts and WinFonts. By 
  128. default module WinFonts handles both screen (.Scn.Fnt) and printer 
  129. (.Prx.Fnt, .Mdx.Fnt) fonts.
  130.  
  131. The metric problem with Syntax20b.Scn.Fnt (and other Fonts) has been 
  132. fixed in Win32.FontRes.Mod. The new .fon files can be found in Fonts.exe. 
  133.  
  134.  
  135. WinPrinter
  136.  
  137. Printing of color text using Oberon bitmap fonts still does not work with 
  138. all printer drivers. The problem seems to be, that some drivers do not 
  139. implement all features of GDI32.BitBlt. When using true-type fonts printing 
  140. of color text should work with any driver.
  141.  
  142. Using the postscript driver provided by Adobe (see: 
  143. http://www.adobe.com/supportservice/custsupport/LIBRARY/pdrvwin.htm)
  144. color text is printed correctly. 
  145.  
  146. Suggestion: If printing using WinPrinter does not work with your setup use
  147. either the postscript driver provided by Adobe or use a PSPrinter based 
  148. printer driver. If you do not have a postscript printer, I recommend using 
  149. Ghostscript (see: http://www.cs.wisc.edu/~ghost/).
  150.  
  151.  
  152. PSPrinter
  153.  
  154. There are two new variants of the Oberon PSPrinter.
  155.  
  156. GhostPrinter:
  157. Postscript is printed using your existing Ghostscript installation. For 
  158. installation details see: Printers.Tool.
  159.  
  160. WinPSPrinter:
  161. The postscript output of PSPrinter is redirected to any Windows (postscript)
  162. printer queue. For installation details see: Printers.Tool.
  163.  
  164.  
  165. Timer overflow
  166.  
  167. The time value returned by Input.Time or Oberon.Time is a signed 32 bit 
  168. value. After 25 days this counter will overflow. If you use Oberon.Task,
  169. Displays.SelectMsg or Oberon.SelectMsg you should use the following work 
  170. arounds:
  171.   Oberon.Task:
  172.   Initialize the time field with Oberon.Time. If you initialize time to 0, 
  173.   the task may not run for the following 25 days!
  174.  
  175.   Oberon.GetSelection, Gadgets.GetSelection:
  176.   time is set to -1 if no selection exists. Thus checking time > 0 does only
  177.   work within the first 25 days!
  178.  
  179.     Oberon.GetSelection(text, beg, end, time)
  180.     IF time # -1 THEN
  181.     (* selection available *)
  182.     END
  183.  
  184.   Displays.SelectMsg, Oberon.SelectMsg:
  185.   Initialize the time field to -1 before broadcasting a SelectMsg.
  186.  
  187.  
  188. Oberon Documents on the Windows Desktop
  189.  
  190. In this release Documents and Desktops can be opened in their own window 
  191. using the commands Desktops.OpenWinDoc and Desktops.OpenWin. To use this 
  192. kind of desktop as default, install the package Win included in System1.exe
  193. (see "Configuring the Display Screen" in Setup.Tool).
  194.  
  195. Note that new windows use the default placeing and sizeing of Windows. Once
  196. you have stored a document, it will remember its position and size on the
  197. Windows desktop. This values are used the next time the document is opened on
  198. the Windows desktop.
  199.  
  200.  
  201. Application Packages
  202.  
  203. All the available application packages are distributed in 3 self-extracting 
  204. EXE files PrFnt.exe, AppsAH.exe and AppsIZ.exe. The packages TUI, GUI, Desk, 
  205. Win, Network and PictConverters are included in System1.exe. The
  206. package Developer is included in Src.exe.
  207.  
  208. For networked installation of application packages you must first install 
  209. the Oberon Web browser (Packages.Install Network.oaf). A complete list of all
  210. available packages and some browser plugin examples can be found at:
  211.  
  212.   "http://www.cs.inf.ethz.ch/~zeller/Apps/"
  213.  
  214.  
  215. Netscape Browser Plugin
  216.  
  217. This release includes an alpha version of the Oberon Netscape browser plugin.
  218. (see: PlugInsGuide.Text and NPPlugIn in Packages.Tool).
  219.  
  220.  
  221. OLE / ActiveX Server
  222.  
  223. This release includes an experimental version of an Oberon ActiveX server. 
  224. Thus you may use any Gadget as a visual or none-visual ActiveX component in 
  225. popular ActiveX containers like VisualBasic, Internet Explorer, WordPad ....
  226. To learn more about the OLEObjects package see PlugInsGuide.Text.
  227.  
  228.  
  229. Known Problems and Bugs in this Release
  230.  
  231. - Module Display does not support palette animation
  232. - Window updates are slow
  233. - Print preview does not work with the Netscape browser plugin
  234. - WinPrinter and color text printing using Oberon fonts
  235. - pressing all three mouse buttons on Windows ME does not work
  236.  
  237.  
  238. LEGAL INFORMATION
  239.  
  240. ETH Oberon & ETH PlugIn Oberon
  241. Copyright (C) 1990-2000 Institut fuer Computersysteme ETH Zuerich
  242.  
  243. Permission to use, copy, modify or distribute this software and its 
  244. documentation for any purpose is hereby granted without fee, provided 
  245. that the above copyright notice appear in all copies and that both 
  246. that copyright notice and this permission notice appear in supporting 
  247. documentation, and that the name of ETH not be used in advertising or 
  248. publicity pertaining to distribution of the software without 
  249. specific, written prior permission.
  250.  
  251. ETH disclaims all warranties with regard to this software, including 
  252. all implied special, indirect or consequential damages or any damages 
  253. whatsoever resulting from loss of use, data or profits, whether in an 
  254. action of contract, negligence or other tortious action, arising out 
  255. of or in connection with the use or performance of this software.
  256.  
  257. Oberon, Gadgets, Native Oberon, Oberon System 3, ETH Oberon and ETH PlugIn 
  258. Oberon are trademarks of the Swiss Federal Institute of Technology Zurich.
  259. Microsoft, MS, MS-DOS, NT, Win32, Win32s, Windows, Windows 95, Windows 98, 
  260. Windows NT and Windows 2000 are trademarks of Microsoft Corporation.
  261. IBM and OS/2 are trademarks of IBM Corporation.
  262. Intel and Pentium are trademarks of Intel Corporation.
  263.