From fe16ef663776aa3377f67977744f46b8cef2b5c1 Mon Sep 17 00:00:00 2001 From: truelight Date: Mon, 27 Dec 2004 10:40:04 +0000 Subject: (svn r1281) -Fix: the OS/2 is now finished. Fixes: - Networking - File selector issue - Keyboard input - Dedicated server console issue (use dedicated.cmd to open a server) - Plus many other minor issues --- docs/Readme_OS2.txt | 110 +++++++++++++++++++++++++++++++++++++++++----------- docs/openttd.6 | 4 +- 2 files changed, 90 insertions(+), 24 deletions(-) (limited to 'docs') diff --git a/docs/Readme_OS2.txt b/docs/Readme_OS2.txt index 2ef9d0e18..49e6de989 100644 --- a/docs/Readme_OS2.txt +++ b/docs/Readme_OS2.txt @@ -1,48 +1,114 @@ -OpenTTD: OS/2 version ** CURRENTLY INCOMPLETE ** +OpenTTD: OS/2 version ===================== -OpenTTD has been ported to work on OS/2 4.x or later (including eComStation). At the moment, it does not work properly, but it -can compile and work to an extent. +OpenTTD has been ported to work on OS/2 4.x or later (including +eComStation). The game should work as well as it does on Windows +or other platforms: the main issues you may encounter are graphics +card problems, but that is really the fault of SDL. + +========================= +USING OPENTTD FOR OS/2 +========================= + +LIBRARIES REQUIRED FOR END USERS +-------------------------------- + +SDL.DLL (SDL 1.2.7) and FSLib.dll are required to use this program: +these can be downloaded from the Files section at +http://sourceforge.net/projects/openttd/ - see "os2-useful.zip". + +Note that to actually play the game, I have found in my own +experience that a version of the Scitech Display Drivers or its later +incarnation (see www.scitech.com) are necessary for it to work. If +you have trouble with your native drivers, try the Scitech drivers +and see if they help the problem. + +KNOWN ISSUES +------------ + +- If an error occurs during loading, the OS/2 error message window + is not always displayed. + +A NOTE ABOUT MUSIC +------------------ + +OpenTTD includes a music driver which uses the MCI MIDI system. Unfortunately, +due to the lack of proper MIDI hardware myself, I have been unable to test it, +but during testing, I found that when MIDI was enabled, I got no sound +effects. I therefore decided to DISABLE music by default. + +To enable music, start OpenTTD with the command line: + + openttd -m os2 + +If I hear enough responses that both music and sound work together (it might +just be my system), I'll have the defaults changed. + +A NOTE ABOUT DEDICATED MULTIPLAYER SERVERS +------------------------------------------ + +To start a dedicated multiplayer server, you should run the dedicated.cmd +file. This enables OpenTTD to open up a VIO console window to display +its output and gather any necessary input. Running "openttd -D" +directly will result in the console not being displayed. You may +still pass any other parameters ('-D' is already passed) to +dedicated.cmd. + +========================= +BUILDING THE OS/2 VERSION +========================= Compiler -------- -Open Watcom 1.3 was used to build OpenTTD (earlier versions will NOT work). See http://www.openwatcom.org/ to download it. -It may also be possible to build OpenTTD under OS/2: I attempted this before using Open Watcom, but found the tools available -for OS/2 at the time to be a bit more tricky to get working. +Open Watcom 1.3 was used to build OpenTTD (earlier versions will +NOT work). See http://www.openwatcom.org/ to download it. It may +also be possible to build OpenTTD under OS/2: I attempted this +before using Open Watcom, but found the tools available for OS/2 +at the time to be a bit more tricky to get working. -Due to complexities in my set-up, I actually used the Win32 version of Open Watcom to initially compile OpenTTD for OS/2. There -should be no reason of course why the OS/2 version cannot be used. +Due to complexities in my set-up, I actually used the Win32 version +of Open Watcom to initially compile OpenTTD for OS/2. There should +be no reason of course why the OS/2 version cannot be used. Libraries Required ------------------ -The following libraries are required. To build zlib and libpng, I simply added the required files (watch out for sample -programs, etc) to an IDE project file and built a library: +The following libraries are required. To build zlib and libpng, I +simply added the required files (watch out for sample programs, etc) +to an IDE project file and built a library. Do not use the makefiles +provided, they are not designed for Watcom (apart from SDL): - zlib - http://www.zlib.org/ - contains a makefile for OS/2, but is out of date and uses EMX + http://www.zlib.org/ - contains a makefile for OS/2, but is out + of date and uses EMX - libpng http://www.libpng.org/ - contains an EMX/gcc makefile - SDL for OS/2 - I used ftp://ftp.netlabs.org/pub/sdl/SDL-1.2.7-src-20040908a.zip - take SDL.dll and SDL.lib from the src/ directory. + I used ftp://ftp.netlabs.org/pub/sdl/SDL-1.2.7-src-20040908a.zip - + take SDL.dll and SDL.lib from the src/ directory. -Note that to use the compiled program, you also need FSLib.dll (from src/ in the SDL zip) and a version of the Scitech -Display Drivers or its later incarnation (see www.scitech.com). +If you do not wish to build the libraries yourself, pre-built versions +can be downloaded from the Files section at +http://sourceforge.net/projects/openttd/ - see "os2-useful.zip". Compiling --------- -To compile, open the os/os2/openttd.wpj file in the IDE and build the openttd.exe target. - -TODO: compilation of language files properly - - -** THESE DOCS ARE INCOMPLETE FOR THE MOMENT, WILL BE COMPLETED SOON ** +To compile, open the os/os2/openttd.wpj file in the IDE and first build +the strgen.exe target. This will build the .lng file generator, and will +also attempt to build all the language files (plus the table\strings.h +file which is required for openttd.exe to be built). Once strgen.exe and +the language files are built successfully, you can build the openttd.exe +target. -If you have any questions, please contact me (owen@owenrudge.net) and I'll try to help you out +Contact Information +------------------- -- Owen Rudge, 18th December 2004 +If you have any questions regarding OS/2 issues, please contact me +(owen@owenrudge.net) and I'll try to help you out. For general OpenTTD +issues, see the Contacting section of readme.txt. +- Owen Rudge, 26th December 2004 \ No newline at end of file diff --git a/docs/openttd.6 b/docs/openttd.6 index 39736436d..ca0d329f7 100644 --- a/docs/openttd.6 +++ b/docs/openttd.6 @@ -22,13 +22,13 @@ openttd \- An open source clone of the Microprose game "Transport Tycoon Deluxe .RI [ options ] .br .SH DESCRIPTION -Unfortanetely, there is no real manpage for openttd yet. Hopefully someone +Unfortunately, there is no real manpage for openttd yet. Hopefully someone will write one soon. For now you should use .B openttd -h for more information, or check our Wiki manual: http://wiki.openttd.org/ .PP .\" TeX users may be more comfortable with the \fB\fP and -.\" \fI\fP escape sequences to invode bold face and italics, +.\" \fI\fP escape sequences to invoke bold face and italics, .\" respectively. .\" \fBopenttd\fP is a program that... .SH OPTIONS -- cgit v1.2.3-54-g00ecf