[Scummvm-cvs-logs] SF.net SVN: scummvm: [25012] docs/trunk/docbook

Sat Jan 6 00:04:29 CET 2007

Revision: 25012
          http://scummvm.svn.sourceforge.net/scummvm/?rev=25012&view=rev
Author:   fingolfin
Date:     2007-01-05 15:04:28 -0800 (Fri, 05 Jan 2007)

Log Message:
-----------
Added XSLT & make fule for faq.inc generation via xsltproc; also removed faq.inc from this part of the repository (a copy still is kept in the web module)

Modified Paths:
--------------
    docs/trunk/docbook/Makefile.xsltproc

Added Paths:
-----------
    docs/trunk/docbook/faq-inc.xsl

Removed Paths:
-------------
    docs/trunk/docbook/faq.inc

Modified: docs/trunk/docbook/Makefile.xsltproc
===================================================================

--- docs/trunk/docbook/Makefile.xsltproc	2007-01-05 22:48:06 UTC (rev 25011)
+++ docs/trunk/docbook/Makefile.xsltproc	2007-01-05 23:04:28 UTC (rev 25012)
@@ -18,6 +18,7 @@
 %.html: %.xml
 	SGML_CATALOG_FILES=$(SGML_CATALOG_FILES) \
 	  xsltproc $(XSL_PARAM) --output $@ $(DOCBOOK_XSL)/html/docbook.xsl $<
+	tidy -qm $@ || true
 
 %.xhtml: %.xml
 	SGML_CATALOG_FILES=$(SGML_CATALOG_FILES) \
@@ -39,3 +40,9 @@
 # above).
 # Also, there is room for experiments when it comes to the plain text generation.
 #
+
+
+# Special rule for faq.inc:
+# Only keep everything contained inside the top-most <div> inside the <body>
+faq.inc: faq.html
+	  xsltproc --html --output $@ faq-inc.xsl $<

Added: docs/trunk/docbook/faq-inc.xsl
===================================================================
--- docs/trunk/docbook/faq-inc.xsl	                        (rev 0)
+++ docs/trunk/docbook/faq-inc.xsl	2007-01-05 23:04:28 UTC (rev 25012)
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version="1.1">
+
+<xsl:output method="html" indent="no" encoding="iso-8859-1" />
+
+<xsl:template match="/"><xsl:copy-of select="html/body/div" /></xsl:template>
+
+</xsl:stylesheet>


Property changes on: docs/trunk/docbook/faq-inc.xsl
___________________________________________________________________
Name: svn:mime-type
   + text/xml
Name: svn:eol-style
   + native

Deleted: docs/trunk/docbook/faq.inc
===================================================================
--- docs/trunk/docbook/faq.inc	2007-01-05 22:48:06 UTC (rev 25011)
+++ docs/trunk/docbook/faq.inc	2007-01-05 23:04:28 UTC (rev 25012)
@@ -1,773 +0,0 @@
-<!-- This file was generated by faq_make_inc.pl. Do *NOT* edit by hand! -->
-<div class="qandaset">
-<dl>
-<dt>1. <a href="#AEN6">Introduction</a></dt>
-<dd>
-<dl>
-<dt>1.1. <a href="#AEN9">Why is it called ScummVM - what does this
-name mean?</a></dt>
-<dt>1.2. <a href="#AEN19">What is SCUMM?</a></dt>
-<dt>1.3. <a href="#AEN25">Is ScummVM free?</a></dt>
-<dt>1.4. <a href="#AEN31">Where do I find ScummVM?</a></dt>
-<dt>1.5. <a href="#AEN37">How do I compile the source code for my
-OS?</a></dt>
-<dt>1.6. <a href="#AEN43">On what platform does ScummVM
-run?</a></dt>
-<dt>1.7. <a href="#AEN51">Can I use ScummVM to make new
-games?</a></dt>
-</dl>
-</dd>
-<dt>2. <a href="#AEN58">Supported games</a></dt>
-<dd>
-<dl>
-<dt>2.1. <a href="#question.supported-games">What games does
-ScummVM support?</a></dt>
-<dt>2.2. <a href="#AEN67">Does ScummVM run any non-SCUMM
-games?</a></dt>
-<dt>2.3. <a href="#AEN76">Will ScummVM support other
-games?</a></dt>
-<dt>2.4. <a href="#AEN83">When will Maniac Mansion Deluxe be
-supported?</a></dt>
-</dl>
-</dd>
-<dt>3. <a href="#AEN89">Running games</a></dt>
-<dd>
-<dl>
-<dt>3.1. <a href="#AEN92">Do I need original CD or Floppy
-disks?</a></dt>
-<dt>3.2. <a href="#AEN98">Does ScummVM work with all versions of
-games?</a></dt>
-<dt>3.3. <a href="#AEN104">Can I play through xxx (place your
-favorite SCUMM adventure here) ?</a></dt>
-<dt>3.4. <a href="#AEN110">Can I save/restore the game?</a></dt>
-<dt>3.5. <a href="#AEN115">Do savegames from the original games
-work in ScummVM?</a></dt>
-</dl>
-</dd>
-<dt>4. <a href="#AEN119">Graphics and Audio</a></dt>
-<dd>
-<dl>
-<dt>4.1. <a href="#AEN122">Does ScummVM support CD audio?</a></dt>
-<dt>4.2. <a href="#AEN128">Does ScummVM support using MP3/Ogg/FLAC
-files instead of CD audio?</a></dt>
-<dt>4.3. <a href="#AEN134">Does ScummVM support using MP3/Ogg/FLAC
-files instead of the original MIDI music?</a></dt>
-<dt>4.4. <a href="#AEN140">Does ScummVM support filtered graphic
-modes?</a></dt>
-<dt>4.5. <a href="#AEN147">Can I run my game full screen?</a></dt>
-</dl>
-</dd>
-<dt>5. <a href="#AEN151">Troubleshooting</a></dt>
-<dd>
-<dl>
-<dt>5.1. <a href="#AEN154">My game won't run.</a></dt>
-<dt>5.2. <a href="#AEN162">I installed my game but ScummVM can't
-find it.</a></dt>
-<dt>5.3. <a href="#question.no-sound">I don't hear any
-sound.</a></dt>
-<dt>5.4. <a href="#AEN174">I don't hear any music.</a></dt>
-<dt>5.5. <a href="#AEN180">My game crashes at some point.</a></dt>
-<dt>5.6. <a href="#AEN188">ScummVM crashes, but console window
-disappears too quick to see the error message.</a></dt>
-<dt>5.7. <a href="#question.messy-colors">The game colors are
-messed up.</a></dt>
-<dt>5.8. <a href="#AEN198">The subtitles in my non English game are
-messed up.</a></dt>
-<dt>5.9. <a href="#AEN205">How do I make my mac version of a game
-work?</a></dt>
-<dt>5.10. <a href="#question.report-bugs">Reporting Bugs.</a></dt>
-<dt>5.11. <a href="#AEN237">I downloaded the Broken Sword packs
-from your site but the game won't run.</a></dt>
-<dt>5.12. <a href="#AEN242">There are no graphics in the Broken
-Sword I intro.</a></dt>
-<dt>5.13. <a href="#AEN247">I get "WARNING: Unable to open
-configration file C:\windows\scummvm.ini!"</a></dt>
-<dt>5.14. <a href="#AEN252">I get "Failed to save game state to
-file: xxx"</a></dt>
-<dt>5.15. <a href="#AEN257">ScummVM starts, but all I get is a
-transparent window!</a></dt>
-<dt>5.16. <a href="#AEN267">ScummVM runs, but sound is stuttering
-and/or garbled!</a></dt>
-<dt>5.17. <a href="#AEN273">How do I set an environment
-variable?</a></dt>
-<dt>5.18. <a href="#AEN284">ScummVM starts somewhere in the middle
-of my two Xinerama monitors in fullscreen mode. Help!</a></dt>
-</dl>
-</dd>
-<dt>6. <a href="#AEN289">Features</a></dt>
-<dd>
-<dl>
-<dt>6.1. <a href="#AEN292">Will you add support for zip
-archives?</a></dt>
-</dl>
-</dd>
-</dl>
-<div class="qandadiv">
-<h3><a name="AEN6" id="AEN6"></a>1. Introduction</h3>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN9" id="AEN9"></a><b>1.1.</b> Why is it called
-ScummVM - what does this name mean?</p>
-</div>
-<div class="answer">
-<p><span class="QUOTE">"Scumm"</span> comes from the fact that it
-was originally designed to run SCUMM games, like Monkey Island.
-<span class="QUOTE">"VM"</span> stands for Virtual Machine.</p>
-<p>Every now and then somebody will raise the subject of finding a
-<span class="QUOTE">"better"</span> name for ScummVM, one that fits
-better with it's modern scope (which extends well beyond SCUMM
-games). So <a href="http://wiki.scummvm.org/index.php/ScummVM_Name"
-target="_top">at this page</a> we present you with some nice
-alternatives. Choose whichever suits you best -- but we will stay
-ScummVM.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN19" id="AEN19"></a><b>1.2.</b> What is SCUMM?</p>
-</div>
-<div class="answer">
-<p>SCUMM stands for "Script Creation Utility for Maniac Mansion".
-It is a utility used to create the famous LucasArts adventure
-games.</p>
-<p>It was initially created in 1987 by Aric Wilmunder and Ron
-Gilbert for the game "Maniac Mansion" and was used later, with some
-modifications, for Zak McKracken and the Alien Mindbenders.
-Development on the SCUMM system continued for some time, and was
-used in Loom, Indiana Jones and the Last Crusade, Indiana Jones and
-the Fate of Atlantis, Monkey Island 1,2,3, Sam & Max Hit the
-Road, Day of the Tentacle, The Dig and Full Throttle.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN25" id="AEN25"></a><b>1.3.</b> Is ScummVM free?</p>
-</div>
-<div class="answer">
-<p>ScummVM is released under the <a href=
-"http://www.gnu.org/copyleft/gpl.html" target="_top">GPL (General
-Public License)</a>, so it's more than free. ScummVM source code is
-freely available and you can do whatever you want with it. If you
-make modifications to it and redistribute your work you MUST make
-the source available. However, the ScummVM team would be pleased if
-you choose to send them your modifications, so they can be merged
-into the main tree.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN31" id="AEN31"></a><b>1.4.</b> Where do I find
-ScummVM?</p>
-</div>
-<div class="answer">
-<p>You can find it on the download section on our <a href=
-"http://www.scummvm.org" target="_top">web site</a>. You can
-download the latest version, which could be a little old. For the
-most recent cutting-edge in-development version, you have to
-compile it yourself from Subversion or use the precompiled 'daily
-builds' linked from our download page.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN37" id="AEN37"></a><b>1.5.</b> How do I compile the
-source code for my OS?</p>
-</div>
-<div class="answer">
-<p>The source code package contains a file called <a href=
-"http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/README"
-target="_top">README</a> that should explain everything.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN43" id="AEN43"></a><b>1.6.</b> On what platform does
-ScummVM run?</p>
-</div>
-<div class="answer">
-<p>ScummVM should be able to be compiled on any SDL platform, with
-just small modifications.</p>
-<p>Currently tested platforms include Win32 (Windows
-95/98/ME/NT/2000/XP), Linux i386 and PPC, BeOS, Solaris, Mac OS X,
-Dreamcast, MorphOS, IRIX, PalmOS, WinCE, GP32, Sony PSP and PS2. It
-is also part of the Free/Net/Open BSD ports collections and
-included in Debian testing and unstable.</p>
-<p>See also the <a href=
-"http://wiki.scummvm.org/index.php/Platforms" target=
-"_top">platforms list</a> in our Wiki.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN51" id="AEN51"></a><b>1.7.</b> Can I use ScummVM to
-make new games?</p>
-</div>
-<div class="answer">
-<p>While it is theoretically possible to write a new game that uses
-ScummVM it is not advisable. ScummVM has many hacks to support
-older games and no tools geared towards creating content usable by
-ScummVM. Potential game authors are encouraged to look at open
-source technologies such as <a href="http://www.libsdl.org" target=
-"_top">SDL</a> for a cross platform DirectX like library, and the
-<a href="http://www.lua.org" target="_top">Lua</a> and <a href=
-"http://www.python.org" target="_top">Python</a> scripting
-languages for game logic.</p>
-</div>
-</div>
-</div>
-<div class="qandadiv">
-<h3><a name="AEN58" id="AEN58"></a>2. Supported games</h3>
-<div class="qandaentry">
-<div class="question">
-<p><a name="question.supported-games" id=
-"question.supported-games"></a><b>2.1.</b> What games does ScummVM
-support?</p>
-</div>
-<div class="answer">
-<p>We have a <a href="http://www.scummvm.org/compatibility.php"
-target="_top">compatibility list</a> on our website that contains
-an up to date list of what games work, and how well they work. As
-well as SCUMM games, we also include virtual machines for the first
-two Simon the Sorcerer games (by Adventure Soft), Broken Sword 1/2
-and Beneath a Steel Sky (by Revolution), Flight of the Amazon
-Queen, Gobliiins 1 (by Coktel Vision) as well as Inherit the Earth
-(by The Dreamers' Guild). Other games may be added, but this is not
-a common occurrence - see below.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN67" id="AEN67"></a><b>2.2.</b> Does ScummVM run any
-non-SCUMM games?</p>
-</div>
-<div class="answer">
-<p>Yes. As well as SCUMM titles, ScummVM supports Simon the
-Sorcerer (1 and 2), Flight of the Amazon Queen, and the Revolution
-Games: Broken Sword 1, Broken Sword 2, and Beneath a Steel Sky, as
-well as Gobliiins 1 and Inherit the Earth.</p>
-<p>Simon support was initially written by the original founder of
-ScummVM as a separate program, and later included in the main
-binary. Revolution Software Ltd. are very nice people and kindly
-provided us with the source code to BASS and Broken Sword 1/2, from
-which we based our interpreters. John Passfield and Steven
-Stamatiadis kindly provided the original source code to Flight of
-the Amazon Queen. The Wyrmkeep Entertainment Co. kindly provided
-the sourcecode to Inherit the Earth. Gobliiins 1 was widely
-researched by Ivan Dubrov.</p>
-<p>We do not have any plans to support any other non-SCUMM games at
-this time. If we do, it will be added to the <a href=
-"compatibility.php" target="_top">Compatibility List</a>.</p>
-<p>Unless you work for a company interested providing us with
-source code for one of your classic titles, please do not ask us to
-support a game.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN76" id="AEN76"></a><b>2.3.</b> Will ScummVM support
-other games?</p>
-</div>
-<div class="answer">
-<p>The ScummVM team is currently focusing on bugfixes for our next
-release.</p>
-<p>We do <span class="emphasis"><i class="emphasis">NOT</i></span>
-generally add support for non-SCUMM games! Reverse engineering a
-completely new game without source is a long process, and our
-developers are all very busy as it is... so unless you work for a
-company interested in providing us with source code for one of your
-classic titles, please do not ask.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN83" id="AEN83"></a><b>2.4.</b> When will Maniac
-Mansion Deluxe be supported?</p>
-</div>
-<div class="answer">
-<p>The short answer: never. The long answer: This game is a
-fan-made replica of the original Maniac Mansion. It is not the same
-game as Maniac Mansion Enhanced, which we do support. It features
-improved music, sound, 256-colors graphics and reworked game
-interface. It was made using the <a href=
-"http://www.adventuregamestudio.co.uk/" target="_top">Adventure
-Game Studio</a> which is a free, albeit closed-source graphics
-adventures engine. There are Windows, Linux and FreeBSD versions of
-the engine. Its author keeps his source code closed due to reasons
-explained in the project <a href=
-"http://www.bigbluecup.com/acfaq.htm" target="_top">FAQ</a> (see
-last two questions). That means that you need to download that
-program to play the game.</p>
-</div>
-</div>
-</div>
-<div class="qandadiv">
-<h3><a name="AEN89" id="AEN89"></a>3. Running games</h3>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN92" id="AEN92"></a><b>3.1.</b> Do I need original CD
-or Floppy disks?</p>
-</div>
-<div class="answer">
-<p>Most definitely. ScummVM won't work without them. If you would
-like to buy these games, we suggest you browse <a href=
-"http://www.ebay.com" target="_top">Ebay</a>. Do not ask the
-ScummVM team where you can download the full versions of LucasArts
-games. These requests will be ignored.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN98" id="AEN98"></a><b>3.2.</b> Does ScummVM work
-with all versions of games?</p>
-</div>
-<div class="answer">
-<p>See "<a href="#question.supported-games"><i>What games does
-ScummVM support?</i></a>".</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN104" id="AEN104"></a><b>3.3.</b> Can I play through
-xxx (place your favorite SCUMM adventure here) ?</p>
-</div>
-<div class="answer">
-<p>See "<a href="#question.supported-games"><i>What games does
-ScummVM support?</i></a>".</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN110" id="AEN110"></a><b>3.4.</b> Can I save/restore
-the game?</p>
-</div>
-<div class="answer">
-<p>Yes. Saving and restoring is already supported (ALT-1/9 to save,
-CTRL - 1/9 to restore, or F5 to access the save/load menu).</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN115" id="AEN115"></a><b>3.5.</b> Do savegames from
-the original games work in ScummVM?</p>
-</div>
-<div class="answer">
-<p>In general, no. We do not have any plans to load old savegames
-(with the exception of the Simon the Sorcerer series of games).
-Newer versions of ScummVM have also sometimes broken compatibility
-with older ScummVM savegames. Since ScummVM is under heavy
-development, this may occur again in the future.</p>
-</div>
-</div>
-</div>
-<div class="qandadiv">
-<h3><a name="AEN119" id="AEN119"></a>4. Graphics and Audio</h3>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN122" id="AEN122"></a><b>4.1.</b> Does ScummVM
-support CD audio?</p>
-</div>
-<div class="answer">
-<p>Yes, ScummVM fully supports CD audio in Gobliins (CD), Indiana
-Jones and the Last Crusade (FM-TOWNS), Loom (CD & FM-TOWNS),
-Monkey Island 1 (CD, FM-TOWNS & SegaCD) and Zak McKracken
-(FM-TOWNS). Just keep your game CD inserted into your CD drive when
-you start ScummVM. If you have more than one CD drive in your
-system, you can specify your CD drive using the -c command line
-parameter. See the <a href=
-"http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/README"
-target="_top">README</a> for more info.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN128" id="AEN128"></a><b>4.2.</b> Does ScummVM
-support using MP3/Ogg/FLAC files instead of CD audio?</p>
-</div>
-<div class="answer">
-<p>Yes. You can use LAME or some other CD audio conversion utility
-to convert your CD audio to MP3. Since version 0.3.0 we also
-support Ogg Vorbis files, and FLAC is supported since version
-0.7.0. See the <a href=
-"http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/README"
-target="_top">README</a> for more info.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN134" id="AEN134"></a><b>4.3.</b> Does ScummVM
-support using MP3/Ogg/FLAC files instead of the original MIDI
-music?</p>
-</div>
-<div class="answer">
-<p>No. If all the game does is to play or loop a tune it would be
-possible, but many of the games do fancy stuff like smooth
-transitions from one tune to another, or turn individual
-instruments on and off, etc. There's simply no way ScummVM could
-take a piece of digital music and emulate that kind of
-behaviour.</p>
-<p>This question usually comes up in connection with Sam & Max
-Hit the Road (which has a few unusued bonus audio tracks on the CD)
-and Monkey Island 2 (which is sometimes distributed on the same CD
-as the version of Monkey Island 1 that uses CD audio). Both of
-these games do far too much fancy stuff to even consider an idea
-like this.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN140" id="AEN140"></a><b>4.4.</b> Does ScummVM
-support filtered graphic modes?</p>
-</div>
-<div class="answer">
-<p>Yes, ScummVM supports several filtered graphic modes such as
-<a href="http://elektron.its.tudelft.nl/~dalikifa/" target=
-"_top">Super2xSAI</a>. See the <a href=
-"http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/README"
-target="_top">README</a> for more info.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN147" id="AEN147"></a><b>4.5.</b> Can I run my game
-full screen?</p>
-</div>
-<div class="answer">
-<p>Yes. You can either start your game using the -f command line
-parameter, setting the game to Full Screen in the ScummVM Options
-dialog, or by using the Alt+Enter key combination in-game to switch
-between full screen and windowed modes.</p>
-</div>
-</div>
-</div>
-<div class="qandadiv">
-<h3><a name="AEN151" id="AEN151"></a>5. Troubleshooting</h3>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN154" id="AEN154"></a><b>5.1.</b> My game won't
-run.</p>
-</div>
-<div class="answer">
-<p>First make sure your game is supported. See "<a href=
-"#question.supported-games"><i>What games does ScummVM
-support?</i></a>". If it is a supported game and you have followed
-the instructions in <a href=
-"http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/README"
-target="_top">README</a> to the letter, then see "<a href=
-"#question.report-bugs"><i>Reporting Bugs.</i></a>" to report this
-as a bug.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN162" id="AEN162"></a><b>5.2.</b> I installed my game
-but ScummVM can't find it.</p>
-</div>
-<div class="answer">
-<p>First don't use the install.exe or setup.exe shipped with the
-game. They usually will not do what you need to run the game with
-ScummVM -- rather they just copy the game .exe and install some
-shortcuts. ScummVM requires all game data to run, so you will need
-to copy those manually. Look at the <a href=
-"http://www.scummvm.org/documentation.php?view=datafiles" target=
-"_top">Game Data Files</a> page for further details.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="question.no-sound" id=
-"question.no-sound"></a><b>5.3.</b> I don't hear any sound.</p>
-</div>
-<div class="answer">
-<p>Check the <a href="http://www.scummvm.org/compatibility.php"
-target="_top">compatibility list</a> to see if your game has sound
-support currently. You can also try the -s command line parameter
-to set the in game SFX volume.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN174" id="AEN174"></a><b>5.4.</b> I don't hear any
-music.</p>
-</div>
-<div class="answer">
-<p>See "<a href="#question.no-sound"><i>I don't hear any
-sound.</i></a>".</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN180" id="AEN180"></a><b>5.5.</b> My game crashes at
-some point.</p>
-</div>
-<div class="answer">
-<p>Check the <a href="http://www.scummvm.org/compatibility.php"
-target="_top">Compatibility List</a> to see if your game has any
-known issues. If you can reproduce this crash more than once,
-please report it to our Bug Tracker. See "<a href=
-"#question.report-bugs"><i>Reporting Bugs.</i></a>".</p>
-<p>If you are experiencing random crashes, and your game plays
-music from CD, you most certainly have encountered a Windows bug.
-Try copying the data files from CD to your hard disk, and running
-them from there.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN188" id="AEN188"></a><b>5.6.</b> ScummVM crashes,
-but console window disappears too quick to see the error
-message.</p>
-</div>
-<div class="answer">
-<p>To make it visible, you should run ScummVM from command line. To
-open a command prompt, open the Start Menu and select the 'Run'
-option. Under Windows NT/2000/XP, type 'cmd.exe' (no quotes) in the
-dialog box that shows up; under Windows 95/98/Me, type
-'command.com' instead. If necessary, change to the proper drive
-first by typing 'D:' (where 'D' is the drive ScummVM is located).
-Change to ScummVM's directory by typing 'cd \your\path\to\scummvm'
-(substituting the appropriate path) and then type 'scummvm'.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="question.messy-colors" id=
-"question.messy-colors"></a><b>5.7.</b> The game colors are messed
-up.</p>
-</div>
-<div class="answer">
-<p>This is a known issue with using Amiga version datafiles. Select
-Amiga as a platform in the ScummVM Game Options dialog, or use the
---platform=amiga command line parameter to enable Amiga-specific
-code.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN198" id="AEN198"></a><b>5.8.</b> The subtitles in my
-non English game are messed up.</p>
-</div>
-<div class="answer">
-<p>You are most likely using a game such as Maniac Mansion or Zak
-McKracken if you have this problem. You need to specify a language
-in the ScummVM Game Options dialog, with the -q parameter or by
-using the 'language' config file option.</p>
-<p>Consult the <a href=
-"http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/README"
-target="_top">README</a> or command line help for further
-information.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN205" id="AEN205"></a><b>5.9.</b> How do I make my
-mac version of a game work?</p>
-</div>
-<div class="answer">
-<p>First, if you use a ScummVM version prior to 0.7.0 we strongly
-recommend you to upgrade to the latest version, as we improved
-support for mac games considerably starting with 0.7.0.</p>
-<p>For newer games ScummVM needs the main data file, usually called
-"<Game Title> Data" (where <Game Title>
-is name of your game, such as "The Dig" or
-"Sam & Max"). Some CDs may appear to only contain an
-application (watch out, it has almost the same name as the data
-file, except that it lacks the " Data" at the end). In that case
-there is still a separate data file but it is invisible.</p>
-<p>There also exists a seperate <a href=
-"http://wiki.scummvm.org/index.php/HOWTO-Mac_Games" target=
-"_top">tutorial</a> for setting up Mac versions</p>
-<p>The older games which have LFL files should only need the
-platform set to 'macintosh' to run. See "<a href=
-"#question.messy-colors"><i>The game colors are messed up.</i></a>"
-for information on specifying the game platform.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="question.report-bugs" id=
-"question.report-bugs"></a><b>5.10.</b> Reporting Bugs.</p>
-</div>
-<div class="answer">
-<p>To report a bug, please create a SourceForge account and follow
-the <a href=
-"http://sourceforge.net/tracker/?atid=418820&group_id=37116&func=browse"
-target="_top">bugs</a> link from our homepage. Please make sure the
-bug is reproducible, and still exists in the latest daily
-build/current Subversion version. Also check the <a href=
-"http://www.scummvm.org/compatibility.php" target=
-"_top">compatibility listing</a> for that game to ensure the issue
-is not already known. In your bugreport please provide the
-following information:</p>
-<ul>
-<li>
-<p>ScummVM version (PLEASE test the latest Subversion/Daily
-build)</p>
-</li>
-<li>
-<p>Bug details, including instructions on reproducing it</p>
-</li>
-<li>
-<p>Language of game (English, German, ...)</p>
-</li>
-<li>
-<p>Version of game (talkie, floppy, ...)</p>
-</li>
-<li>
-<p>Platform and Compiler (Win32, Linux, MacOS, ...)</p>
-</li>
-<li>
-<p>Attach a save game if possible</p>
-</li>
-<li>
-<p>If this bug only occurred recently, please note the last version
-without the bug, and the first version including the bug. That way
-we can fix it quicker by looking at the changes made.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN237" id="AEN237"></a><b>5.11.</b> I downloaded the
-Broken Sword packs from your site but the game won't run.</p>
-</div>
-<div class="answer">
-<p>These are not full games but reencoded cutscene (video) packs.
-To run the games you still need the original disks. Originally
-cutscenes were encoded in proprietary format and Revolution
-Software kindly permitted us to reencode them into MPEG and
-distribute them freely on our site.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN242" id="AEN242"></a><b>5.12.</b> There are no
-graphics in the Broken Sword I intro.</p>
-</div>
-<div class="answer">
-<p>Be patient. There are about 12 seconds of speech only and
-eventually the Revolution logo will appear.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN247" id="AEN247"></a><b>5.13.</b> I get "WARNING:
-Unable to open configration file C:\windows\scummvm.ini!"</p>
-</div>
-<div class="answer">
-<p>Make sure you have enough permissions to write in c:\windows
-directory. Also note that this warning the first time you run
-ScummVM, since the file does not exist yet then.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN252" id="AEN252"></a><b>5.14.</b> I get "Failed to
-save game state to file: xxx"</p>
-</div>
-<div class="answer">
-<p>Check savepath in Options->Paths->Save Path. That should
-point to writeable directory.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN257" id="AEN257"></a><b>5.15.</b> ScummVM starts,
-but all I get is a transparent window!</p>
-</div>
-<div class="answer">
-<p>This problem has been reported to happen under Windows in some
-cases. Check that you have the latest drivers for your graphics
-card. If that does not help, try setting the <code class=
-"envar">SDL_VIDEODRIVER</code> environment variable to "windib" and
-try again.</p>
-<p>Apparently other applications have had the same problem, because
-the release notes for SDL 1.2.10 (May 17, 2006) contained the
-following note:</p>
-<a name="AEN263" id="AEN263"></a>
-<blockquote class="BLOCKQUOTE">
-<p>The "windib" video driver is the default now, to prevent
-problems with certain laptops, 64-bit Windows, and Windows Vista.
-The DirectX driver is still available, and can be selected by
-setting the environment variable <code class=
-"envar">SDL_VIDEODRIVER</code> to "directx".</p>
-</blockquote>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN267" id="AEN267"></a><b>5.16.</b> ScummVM runs, but
-sound is stuttering and/or garbled!</p>
-</div>
-<div class="answer">
-<p>This problem has been reported to happen under Windows in some
-cases. Check that you have the latest drivers for your sound card.
-If that does not help, try setting the <code class=
-"envar">SDL_AUDIODRIVER</code> environment variable to "waveout"
-and try again.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN273" id="AEN273"></a><b>5.17.</b> How do I set an
-environment variable?</p>
-</div>
-<div class="answer">
-<p>That depends on what operating system and/or command shell you
-are using. Under Windows, you could try creating a file called
-<b class="command">scummvm.bat</b> in the same folder as <b class=
-"command">scummvm.exe</b>. Open this file in your favorite text
-editor and put something like this in it:</p>
-<a name="AEN279" id="AEN279"></a>
-<blockquote class="BLOCKQUOTE">
-<pre class="programlisting">
- at echo off
-set SDL_VIDEODRIVER=windib
-set SDL_AUDIODRIVER=waveout
-scummvm.exe %1 %2 %3 %4 %5 %6 %7 %8 %9
-</pre></blockquote>
-<p>You should now be able to run ScummVM by double-clicking on this
-batch file, instead of the ScummVM executable.</p>
-<p>On more recent versions of Windows, you can also set an
-environment variable permanently, and for all applications, through
-the control panel.</p>
-</div>
-</div>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN284" id="AEN284"></a><b>5.18.</b> ScummVM starts
-somewhere in the middle of my two Xinerama monitors in fullscreen
-mode. Help!</p>
-</div>
-<div class="answer">
-<p>In fact, this is SDL problem. SDL does by default has xinerama
-support enabled. Set the <code class=
-"envar">SDL_VIDEO_FULLSCREEN_HEAD</code> environment variable to
-"1" to start ScummVM (and other SDL applications) in fullscreen on
-only one monitor. If this does not work make sure your SDL library
-does have Xinerama support compiled in.</p>
-</div>
-</div>
-</div>
-<div class="qandadiv">
-<h3><a name="AEN289" id="AEN289"></a>6. Features</h3>
-<div class="qandaentry">
-<div class="question">
-<p><a name="AEN292" id="AEN292"></a><b>6.1.</b> Will you add
-support for zip archives?</p>
-</div>
-<div class="answer">
-<p>We will not do it. There are two main reasons for that. First,
-we believe that it would ease illegal distribution of games.
-Second, we already support compression of sound & speech in
-most larger titles, and use specially designed algorithms like MP3,
-Ogg and FLAC, so you can already reduce the size of the data
-files.</p>
-<p>We as a team already discussed that question. We can't
-absolutely exclude the possibility of changing our mind one day in
-the future, but for now, we have no intentions to do so, hence
-please don't ask us about it!</p>
-</div>
-</div>
-</div>
-</div>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.


