summaryrefslogtreecommitdiffstats
path: root/doc/ReadMe-OS2.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ReadMe-OS2.txt')
-rw-r--r--doc/ReadMe-OS2.txt149
1 files changed, 149 insertions, 0 deletions
diff --git a/doc/ReadMe-OS2.txt b/doc/ReadMe-OS2.txt
new file mode 100644
index 00000000..8a9dc31c
--- /dev/null
+++ b/doc/ReadMe-OS2.txt
@@ -0,0 +1,149 @@
+
+VirtualBox for OS/2 OSE Edition ALPHA
+=====================================
+
+Version 1.5.51_OSE_27858
+
+03.02.2008
+
+
+This is an early development build of VirtualBox OSE Edition for OS/2.
+Please backup your data and don't expect everything to be highly polished
+and tuned just yet. If you find a *new* problem, meaning something
+not listed below, please report it at http://forums.virtualbox.org.
+
+This package is an official unofficial build of VirtualBox for OS/2.
+It means that it is coordinated by volunteers from Sun Microsystems that
+are still in touch with OS/2 and keep patching VirtualBox at their spare
+time to make sure it runs and more or less works under OS/2.
+
+PLEASE NOTE THAT THE OS/2 HOST (AND THEREFORE THE OS/2 VERSION OF
+VIRTUALBOX) IS NOT OFFICIALLY SUPPORTED BY SUN MICROSYSTEMS! DO NOT
+CONTACT SUN MICROSYSTEMS REGARDING THE OS/2 VERSION OF VIRTUALBOX NO
+MATTER WHAT YOUR QUESTION IS ABOUT! THANK YOU FOR UNDERSTANDING.
+
+
+Current Issues / TODOs
+----------------------
+
+* FE/Qt (Qt GUI frontend):
+
+ - Mouse pointer shape in mouse integration mode.
+ - NumLock/ScrollLock synchronization.
+ - Seamless mode (no top-level window transparency on OS/2).
+ - Keyboard driver to intercept system key combinations
+ (Alt+Tab etc.)
+
+* Devices:
+
+ - Host Floppy/DVD.
+ - Audio.
+ - Host interface networking.
+ - Internal networking.
+ - USB proxying.
+
+* Misc:
+
+ - Shared clipboard.
+ - Starting more than one VM simultaneously.
+ - Installer.
+ - VMX support.
+ - VBoxSDL (resizing/scaling/keyboard/slowness).
+ - Very slow Resume after Pause in real mode guest applications.
+
+Also, please pay attention to the section called "OS/2 Specific Features"
+below.
+
+
+How to "Install" and Run
+------------------------
+
+1. Unpack this archive somewhere.
+
+2. Make sure you have a dot (.) in your LIBPATH statement in CONFIG.SYS.
+
+3. Put the following line at the beginning of your CONFIG.SYS
+ and reboot:
+
+ DEVICE=<somewhere>\VBoxDrv.sys
+
+4. Go to <somewhere> and run VirtualBox.exe (Qt GUI frontend).
+
+5. Note that by default VirtualBox stores all user data in the
+ %HOME%\.VirtualBox directory. If %HOME% is not set, it will use
+ the <boot_drive>:\.VirtualBox directory. In either case, you may
+ overwrite the location of this directory using the VBOX_USER_HOME
+ environment variable.
+
+6. For best performance, it is recommended to install the VirtualBox
+ Guest Additions to the guest OS. The archive containing the ISO
+ image with Guest Additions for supported guest OSes (Windows,
+ Linux, OS/2) is named
+
+ VBoxGuestAdditions_XXXXX.zip
+
+ where XXXXX is the version number (it's best if it matches the version
+ number of this VirtualBox package).
+
+ Download this ZIP from the same location you took this archive from
+ and unpack the contents to the directory containing VirtualBox.exe.
+ After that, you can mount the Additions ISO in the Qt GUI by selecting
+ Devices -> Install Guest Additions... from the menu.
+
+
+Documentation and Support
+-------------------------
+
+Please visit http://www.virtualbox.org where you can find a lot of useful
+information about VirtualBox. There is a Community section where you can
+try to request some help from other OS/2 users of VirtualBox.
+
+You can download the User Manual for the latest official release of
+VirtualBox using this URL:
+
+ http://www.virtualbox.org/download/UserManual.pdf
+
+
+OS/2 Specific Features
+----------------------
+
+This section describes the features that are specific to the OS/2 version
+of VirtualBox and may be absent in versions for other platforms.
+
+1. System key combinations such as Alt+Tab, Ctrl+Esc are currently always
+ grabbed by the host and never reach the guest even when the keyboard
+ is captured. In order to send these combinations to the guest OS, use
+ the following shortcuts (where Host is the host key defined in the
+ global settings dialog):
+
+ Host+` (Tilde/Backquote) => Ctrl+Esc
+ Host+1 => Alt+Tab
+ Host+2 => Alt+Shift+Tab
+
+2. If you use two or more keyboard layouts on the OS/2 host (e.g. English
+ and Russian), make sure that the keyboard is switched to the English
+ layer when you work in the VirtualBox VM console window. Otherwise, some
+ shortcuts that involve the Host key (in particluar, all Host+<latin_letter>
+ shortcuts like Host+Q) may not work. Please note that the guest keyboard
+ layout has nothing to do with the host layout so you will still be able to
+ switch layouts in the guest using its own means.
+
+3. Make sure you do not do 'set LIBPATHSTRICT=T' in the environment you start
+ VirtualBox from: it will make the VirtualBox keyboard hook screw up your
+ host desktop (a workaround is to be found).
+
+
+History of Changes
+------------------
+
+* 03.02.2008
+
+ - Initial release.
+
+* XX.XX.XXXX
+
+ - Fixed: VirtualBox would hang or crash frequently on SMP machines in
+ ACPI mode.
+
+ - Fixed: VBoxSDL keyboard key event to scan code conversion [contributed
+ by Paul Smedley].