SPARC-Oberon (TM) V4 Release 2.9.2 (Solaris 2.x version) ======================================================== Copyright (c) 1990-1995 ETH Zurich SPARC-Oberon is an implementation of Oberon for SPARC-based machines. It covers both the programming language Oberon and the Oberon system closely resembling the original implementation by N. Wirth and J. Gutknecht. SPARC-Oberon implements the Oberon-2 language extensions. DOCUMENTATION ------------- SPARC-Oberon contains some basic online documentation to enable first-time users to get started with Oberon. However, for serious work we recommend the following books published by Addison-Wesley. Note that "Project Oberon" contains the full source code of the Oberon system and compiler. The source code is also available via ftp from neptune.inf.ethz.ch:~ftp/Oberon/Sources/ProjectOberon.tar.Z. N. Wirth and M. Reiser: Programming in Oberon. Steps beyond Pascal and Modula-2. Addison Wesley, 1992, ISBN 0-201-56543-9. Tutorial for the Oberon programming language and concise language reference. M. Reiser: The Oberon System. User Guide and Programmer's Manual. Addison Wesley, 1991, ISBN 0-201-54422-9. User manual for the programming environment and reference for the standard module library. N. Wirth and J. Gutknecht: Project Oberon. The Design of an Operating System and Compiler. Addison Wesley, 1992, ISBN 0-201-54428-8. Program listings with explanations for the whole Oberon system including the compiler for NS32000. REQUIREMENTS ------------ Cpu: SPARC Operating system: SunOS 5.x Mouse: three buttons Terminal server: X11 INSTALLATION ------------ To install SPARC-Oberon from floppy disk, execute the following C-shell script. The directory containing the Oberon installation is refered to as "Oberon" throughout this document. If Oberon is installed via ftp, replace "tar xf /dev/rfd0" by an appropriate file copy command. #csh # make an Oberon directory (preferably /opt/Oberon) mkdir Oberon # go into this directory cd Oberon # get the compressed archive oberon.tar.Z from floppy disk tar xf /dev/rfd0 # uncompress archive uncompress oberon.tar.Z # extract all files tar xf oberon.tar # eventually remove archive rm -i oberon.tar # leave the Oberon directory cd ~ SYNOPSIS oberon [-h heapSize] [-f fontmapfile] [-x Mod Proc] [-g geometry] [-c] DESCRIPTION oberon starts the SPARC-Oberon process which may be terminated by executing the Oberon command System.Quit (after deleting the exclamation mark) or by selecting the Quit menu Item in the Window menu. The oberon command is usually located in /opt/Oberon/bin. Special characters: key meaning ---------------------------------- F1 mark viewer F2 alias to Escape F3 Break character F4 init colors F6..F10 (+Shift, +Ctrl, +Ctrl-Shift) characters beyond 127. Ctrl-L redraw all viewers Keyboard interrupts may be generated by sending the oberon process a SIGINT signal (e.g. kill -2 pid). OPTIONS -h heapSize set heap size to specified number of bytes. If not specified, 2 MB are used for the Oberon heap. -f fontmapfile defines that font names should be mapped according to fontmapfile. If option -f is not specified, no font mapping is performed. The main purpose of this option is to map fonts to bigger ones on displays with very small or unsharp pixels such as color monitors or for video projection. The file Big.Map is provided as an example for enlarging fonts. If a font mapping is performed, the result of printing documents will not be exact. Therefore, if you want to get hight quality printing results, don't use this option. Note that the meaning of this option has been changed over previous versions of SPARC-Oberon. -x Mod Proc execute command Mod.Proc. If not specified, Oberon.Loop is executed. -g geometry specify the size of the Oberon window. Note that the geometry option is taken as a hint, not as a command, by the window manager. -c request 256 colors from the window manager. If not specified, Oberon requests 16 colors only. ENVIRONMENT OBERON A colon-separated list of directories in which to search for files. If OBERON is not defined, .:/opt/Oberon is taken as default. Note that shell specific characters like "~" are not supported by Oberon. The environment variable OBERON may be set e.g. under the C-shell by % setenv OBERON .:Mylib:Oberon. LD_LIBRARY_PATH A colon-separated list of directories in which to search for shared object libraries. Oberon links libc.1 and libX11.4 at execution time (via calls to dlopen). We propose to discuss Oberon related questions in comp.lang.oberon on usenet. Any problems or comments may also be reported via e-mail to oberon@inf.ethz.ch. ------