# HG changeset patch # User tron # Date 2005-09-09 07:08:27 # Node ID 130abb14f1bfcba943a708728f1f51edc2b757eb # Parent d61c0b9ea531d53d33fd050dfd83cdb85c08a071 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports diff --git a/readme.txt b/readme.txt --- a/readme.txt +++ b/readme.txt @@ -1,5 +1,5 @@ OpenTTD README -Last updated: 2005-05-21 +Last updated: 2005-09-09 Release version: 0.4.1 ------------------------------------------------------------------------ @@ -71,13 +71,13 @@ OpenTTD has been ported to several platf be very difficult to port it to a new platform. The currently working platforms are: - Windows - Win32 GDI (faster) or SDL - Linux - SDL - FreeBSD - SDL + BeOS - SDL + FreeBSD - SDL + Linux - SDL Mac OS X - SDL - BeOS - SDL - MorphOS - SDL - OS/2 - SDL + MorphOS - SDL + OS/2 - SDL + Windows - Win32 GDI (faster) or SDL 4.0) Running OpenTTD: @@ -103,31 +103,32 @@ look as nice as with the Windows graphic If you want music you need to copy the gm/ folder from Windows TTD into your OpenTTD folder, not your data folder. -You can change the data path (which contains savegames as well) in Makefile.config -by setting DATA_DIR_PREFIX and USE_HOMEDIR. +You can change the data path (which contains savegames as well) in +Makefile.config by setting DATA_DIR_PREFIX and USE_HOMEDIR. 5.0) OpenTTD features: ---- ----------------- OpenTTD has a lot of features going beyond the original TTD emulation. -Unfortunately, there is currently no comprehensive list of features, but there is -a basic features list on the web, and some optional features can be +Unfortunately, there is currently no comprehensive list of features, but there +is a basic features list on the web, and some optional features can be controlled through the Configure Patches dialog. We also implement some features known from TTDPatch (http://www.ttdpatch.net/). Several important non-standard controls: -* Use Ctrl to place presignals +* Use Ctrl to place semaphore signals * Ctrl-D toggles double mode in the Windows version -* Ingame console. More information at http://wiki.openttd.org/index.php/OpenTTDDevBlackBook +* Ingame console. More information at + http://wiki.openttd.org/index.php/OpenTTDDevBlackBook 6.0) Configuration File: ---- ------------------- The configuration file for OpenTTD (openttd.cfg) is in a simple Windows-like -.INI format. It's mostly undocumented. Almost all settings can be changed ingame by -using the 'Configure Patches' window. +.INI format. It's mostly undocumented. Almost all settings can be changed +ingame by using the 'Configure Patches' window. 7.0) Compiling: @@ -136,11 +137,12 @@ Windows: You need Microsoft Visual Studio 6 or .NET. Open the project file and it should build automatically. In case you want to build with SDL support you need to add WITH_SDL to the project settings. - PNG (WITH_PNG) and ZLIB (WITH_ZLIB) support is enabled by default. For these to - work you need their development files. For best results, download the openttd-useful.zip - file from SourceForge under the Files tab. Put the header files into your compiler's - include/ directory and the library (.lib) files into the lib/ directory. For more help - with VS6 see docs/Readme_Windows_MSVC6.0.txt. + PNG (WITH_PNG) and ZLIB (WITH_ZLIB) support is enabled by default. For these + to work you need their development files. For best results, download the + openttd-useful.zip file from SourceForge under the Files tab. Put the header + files into your compiler's include/ directory and the library (.lib) files + into the lib/ directory. + For more help with VS6 see docs/Readme_Windows_MSVC6.0.txt. You can also build it using the Makefile with MSYS/MinGW or Cygwin/MinGW. Please read the Makefile for more information. @@ -157,6 +159,8 @@ BeOS: Use "make". FreeBSD: + You need the port devel/sdl12 for a non-dedicated build. + graphics/png is optional for screenshots in the PNG format. Use "gmake". MorphOS: @@ -172,31 +176,32 @@ 8.0) Translating: ---- ------------------- See http://www.openttd.org/translating.php for up-to-date information. -The use of the online Translator service, located at http://translator.openttd.org/, is -highly encouraged. For a username/password combo you should contact the development team, -either by mail, IRC or the forums. The system is straightforward to use, and if you have any -problems, read the online help located there. +The use of the online Translator service, located at +http://translator.openttd.org/, is highly encouraged. For a username/password +combo you should contact the development team, either by mail, IRC or the +forums. The system is straightforward to use, and if you have any problems, +read the online help located there. -If for some reason the website is down for a longer period of time, the information below -might be of help. +If for some reason the website is down for a longer period of time, the +information below might be of help. 8.1) Guidelines: ---- ------------------- Here are some translation guidelines which you should follow closely. - * Please contact the development team before begining the translation process! - This avoids double work, as someone else may have already started translating to the same language. + * Please contact the development team before begining the translation + process! This avoids double work, as someone else may have already + started translating to the same language. * Translators must use the charater set ISO 8859-15. Otherwise, some characters will not display correctly in the game. - * Currently it is not possible to translate into character sets other than Latin. Also, changing - the order of strings is unsupported. For instance, it is always '16 tonnes of coal' and cannot be - 'coal existing of 16 tonnes' + * Currently it is not possible to translate into character sets other than + Latin. 8.2) Translation: ---- ------------------- -So, now that you've notified the development team about your intention to translate -(You did, right? Of course you did.) you can pick up english.txt (found in the SVN repository -under /lang) and translate. +So, now that you've notified the development team about your intention to +translate (You did, right? Of course you did.) you can pick up english.txt +(found in the SVN repository under /lang) and translate. You must change the first two lines of the file appropriately: @@ -207,12 +212,13 @@ Note: Do not alter the following parts o * String identifiers (the first word on each line) * Parts of the strings which are in curly braces (such as {STRING}) - * Lines beginning with ## (such as ##id), other than the first two lines of the file + * Lines beginning with ## (such as ##id), other than the first two lines of + the file 8.3) Previewing: ---- ------------------- -In order to view the translation in the game, you need to compile your language file -with the strgen utility, which is now bundled with the game. +In order to view the translation in the game, you need to compile your language +file with the strgen utility, which is now bundled with the game. strgen is a command-line utility. It takes the language filename as parameter. Example: @@ -220,33 +226,31 @@ Example: strgen lang/german.txt This results in compiling german.txt and produces another file named german.lng. -Any missing strings are replaced with the English strings. Note that it looks for english.txt -in the lang subdirectory, which is where your language file should also be. +Any missing strings are replaced with the English strings. Note that it looks +for english.txt in the lang subdirectory, which is where your language file +should also be. That's all! You should now be able to select the language in the game options. 9.0) Troubleshooting ---- --------------- -To see all startup options available to you, start OpenTTD with the "./openttd -h" -option. This might help you tweak some of the settings. - -If the game is acting strange and you feel adventorous you can try the "-d [[]=[]" -flag, where the higher levels will give you more debugging output. The "name" variable can help -you to display only some type of debugging messages. This is mostly undocumented -so best is to look in the source code file debug.c for the various debugging types. For more -information look at http://wiki.openttd.org/index.php/Command_line. +To see all startup options available to you, start OpenTTD with the +"./openttd -h" option. This might help you tweak some of the settings. -The most frequent problem is missing data files. Don't forget to put all GRF files from TTD -into your data/ folder including sample.cat! +If the game is acting strange and you feel adventorous you can try the +"-d [[]=[]" flag, where the higher levels will give you more +debugging output. The "name" variable can help you to display only some type of +debugging messages. This is mostly undocumented so best is to look in the +source code file debug.c for the various debugging types. For more information +look at http://wiki.openttd.org/index.php/Command_line. -Another, less frequent problem is the game refusing to run when you don't have a -sound card. To solve this, force OpenTTD to run without sound/music by running it with -the command line option: "./openttd -s null -m null". This will disable both sound -and music. +The most frequent problem is missing data files. Don't forget to put all GRF +files from TTD into your data/ folder including sample.cat! -Under Windows 98 and lower it is impossible to use a dedicated server; it will fail to -start. Perhaps this is for the better because those OS's are not known for their stability. +Under Windows 98 and lower it is impossible to use a dedicated server; it will +fail to start. Perhaps this is for the better because those OS's are not known +for their stability. X.X) Credits: ---- --------