[Scummvm-cvs-logs] CVS: docs/docbook faq.html,1.3,1.4 faq.txt,1.2,1.3 faq.xml,1.3,1.4 faq.pdf,1.3,1.4

Max Horn fingolfin at users.sourceforge.net
Tue May 10 14:55:58 CEST 2005


Update of /cvsroot/scummvm/docs/docbook
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv1922

Modified Files:
	faq.html faq.txt faq.xml faq.pdf 
Log Message:
Sync faq.xml with faq.php

Index: faq.html
===================================================================
RCS file: /cvsroot/scummvm/docs/docbook/faq.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- faq.html	21 Dec 2004 02:09:57 -0000	1.3
+++ faq.html	10 May 2005 21:53:19 -0000	1.4
@@ -58,37 +58,39 @@
 <dt>3.1. <a href="#AEN113">Does ScummVM support CD audio?</a></dt>
 <dt>3.2. <a href="#AEN119">Does ScummVM support using MP3/Ogg/FLAC
 files instead of CD audio?</a></dt>
-<dt>3.3. <a href="#AEN125">Does ScummVM support filtered graphic
+<dt>3.3. <a href="#AEN125">Does ScummVM support using MP3/Ogg/FLAC
+files instead of the original MIDI music?</a></dt>
+<dt>3.4. <a href="#AEN131">Does ScummVM support filtered graphic
 modes?</a></dt>
-<dt>3.4. <a href="#AEN131">Can I run my game full
+<dt>3.5. <a href="#AEN137">Can I run my game full
 screen?</a></dt></dl></dd>
-<dt>4. <a href="#AEN135">Troubleshooting</a></dt>
+<dt>4. <a href="#AEN141">Troubleshooting</a></dt>
 <dd>
 <dl>
-<dt>4.1. <a href="#AEN138">My game won't run.</a></dt>
-<dt>4.2. <a href="#AEN146">I installed my game but ScummVM can't
+<dt>4.1. <a href="#AEN144">My game won't run.</a></dt>
+<dt>4.2. <a href="#AEN152">I installed my game but ScummVM can't
 find it.</a></dt>
 <dt>4.3. <a href="#question.no-sound">I don't hear any
 sound.</a></dt>
-<dt>4.4. <a href="#AEN158">I don't hear any music.</a></dt>
-<dt>4.5. <a href="#AEN164">My game crashes at some point.</a></dt>
-<dt>4.6. <a href="#AEN171">ScummVM crashes, but console window
+<dt>4.4. <a href="#AEN164">I don't hear any music.</a></dt>
+<dt>4.5. <a href="#AEN170">My game crashes at some point.</a></dt>
+<dt>4.6. <a href="#AEN178">ScummVM crashes, but console window
 disappears too quick to see the error message.</a></dt>
 <dt>4.7. <a href="#question.messy-colors">The game colors are
 messed up.</a></dt>
-<dt>4.8. <a href="#AEN181">The subtitles in my non english game are
+<dt>4.8. <a href="#AEN188">The subtitles in my non english game are
 messed up.</a></dt>
-<dt>4.9. <a href="#AEN188">How do I make my mac version of a game
+<dt>4.9. <a href="#AEN195">How do I make my mac version of a game
 work?</a></dt>
 <dt>4.10. <a href="#question.report-bugs">Reporting Bugs.</a></dt>
-<dt>4.11. <a href="#AEN202">I downloaded the Broken Sword packs
+<dt>4.11. <a href="#AEN225">I downloaded the Broken Sword packs
 from your site but the game won't run.</a></dt>
-<dt>4.12. <a href="#AEN207">There are no graphics in the Broken
+<dt>4.12. <a href="#AEN230">There are no graphics in the Broken
 Sword I intro.</a></dt></dl></dd>
-<dt>5. <a href="#AEN211">Features</a></dt>
+<dt>5. <a href="#AEN234">Features</a></dt>
 <dd>
 <dl>
-<dt>5.1. <a href="#AEN214">Will you add support for zip
+<dt>5.1. <a href="#AEN237">Will you add support for zip
 archives?</a></dt></dl></dd></dl>
 <div class="qandadiv">
 <h3><a name="AEN6"></a>1. Introduction</h3>
@@ -305,14 +307,30 @@
 <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. FLAC is also supported in the current CVS
-tree, although not in the latest released 0.6.x version. See the
-<a href=
+support Ogg Vorbis files. And FLAC is supported since version
+0.7.0. See the <a href=
 "http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/scummvm/scummvm/README?rev=HEAD"
    target="_top">README</a> for more info.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN125"></a><b>3.3.</b> Does ScummVM support filtered
+<p><a name="AEN125"></a><b>3.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="AEN131"></a><b>3.4.</b> Does ScummVM support filtered
 graphic modes?</p></div>
 <div class="answer">
 <p>Yes, ScummVM supports several filtered graphic modes such as
@@ -321,7 +339,7 @@
    target="_top">README</a> for more info.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN131"></a><b>3.4.</b> Can I run my game full
+<p><a name="AEN137"></a><b>3.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
@@ -329,10 +347,10 @@
 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="AEN135"></a>4. Troubleshooting</h3>
+<h3><a name="AEN141"></a>4. Troubleshooting</h3>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN138"></a><b>4.1.</b> My game won't run.</p></div>
+<p><a name="AEN144"></a><b>4.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
@@ -344,7 +362,7 @@
    this as a bug.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN146"></a><b>4.2.</b> I installed my game but ScummVM
+<p><a name="AEN152"></a><b>4.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
@@ -366,25 +384,28 @@
 to set the in game SFX volume.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN158"></a><b>4.4.</b> I don't hear any
+<p><a name="AEN164"></a><b>4.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="AEN164"></a><b>4.5.</b> My game crashes at some
+<p><a name="AEN170"></a><b>4.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></div></div>
+"#question.report-bugs"><i>Reporting Bugs.</i></a>".</p>
+<p>
 If you are experiencing random crashes, and your game
+plays music from CD, you 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="AEN171"></a><b>4.6.</b> ScummVM crashes, but console
+<p><a name="AEN178"></a><b>4.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
@@ -407,7 +428,7 @@
 code.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN181"></a><b>4.8.</b> The subtitles in my non english
+<p><a name="AEN188"></a><b>4.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
@@ -420,17 +441,22 @@
    information.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN188"></a><b>4.9.</b> How do I make my mac version of
+<p><a name="AEN195"></a><b>4.9.</b> How do I make my mac version of
 a game work?</p></div>
 <div class="answer">
-<p>The majority of mac versions won't work without first extracting
-the resources into a format ScummVM understands. To do this you
-need to use the rescumm tool in the scummvm-tools package. An
-example usage might look like: <b class="command">rescumm "Sam
-& Max Demo Data"</b>. Some CDs may appear to only contain a
-application, in which case there is still a seperate data file but
-it is invisible. The older games which have LFL files should only
-need the platform set to 'macintosh' to run. See "<a href=
+<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>
 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">
@@ -446,10 +472,30 @@
    build/current CVS 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.</p></div></div>
+   issue is not already known. In your bugreport please provide the
+   following information:</p>
+<ul>
+<li>
+<p>ScummVM version (PLEASE test the latest CVS/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="AEN202"></a><b>4.11.</b> I downloaded the Broken Sword
+<p><a name="AEN225"></a><b>4.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.
@@ -459,16 +505,16 @@
 distribute them freely on our site.</p></div></div>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN207"></a><b>4.12.</b> There are no graphics in the
+<p><a name="AEN230"></a><b>4.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>
 <div class="qandadiv">
-<h3><a name="AEN211"></a>5. Features</h3>
+<h3><a name="AEN234"></a>5. Features</h3>
 <div class="qandaentry">
 <div class="question">
-<p><a name="AEN214"></a><b>5.1.</b> Will you add support for zip
+<p><a name="AEN237"></a><b>5.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,

Index: faq.txt
===================================================================
RCS file: /cvsroot/scummvm/docs/docbook/faq.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- faq.txt	20 Dec 2004 01:31:17 -0000	1.2
+++ faq.txt	10 May 2005 21:53:30 -0000	1.3
@@ -1,275 +1,294 @@
-                    Frequently Asked Questions About ScummVM
 
-     ----------------------------------------------------------------------
+Frequently Asked Questions About ScummVM
+     _________________________________________________________
 
    1. Introduction
 
-                1.1. Why is it called ScummVM - what does this name mean?
-
-                1.2. What is SCUMM?
-
-                1.3. Is ScummVM free?
-
-                1.4. What games does ScummVM support?
-
-                1.5. Will ScummVM support other games?
-
-                1.6. When will Maniac Mansion Deluxe be supported?
-
-                1.7. Where do I find ScummVM?
-
-                1.8. How do I compile the source code for my OS?
-
-                1.9. On what platform does ScummVM run?
-
-                1.10. Does ScummVM run any non-SCUMM games?
-
-                1.11. Can I use ScummVM to make new games?
+        1.1. Why is it called ScummVM - what does this name mean?
+        1.2. What is SCUMM?
+        1.3. Is ScummVM free?
+        1.4. What games does ScummVM support?
+        1.5. Will ScummVM support other games?
+        1.6. When will Maniac Mansion Deluxe be supported?
+        1.7. Where do I find ScummVM?
+        1.8. How do I compile the source code for my OS?
+        1.9. On what platform does ScummVM run?
+        1.10. Does ScummVM run any non-SCUMM games?
+        1.11. Can I use ScummVM to make new games?
 
    2. ScummVM and SCUMM games
 
-                2.1. Do I need original CD or Floppy disks?
-
-                2.2. Does ScummVM work with all versions of games?
-
-                2.3. Can I play through xxx (place your favorite SCUMM
+        2.1. Do I need original CD or Floppy disks?
+        2.2. Does ScummVM work with all versions of games?
+        2.3. Can I play through xxx (place your favorite SCUMM
                 adventure here) ?
 
-                2.4. Can I save/restore the game?
-
-                2.5. Do savegames from the original games work in ScummVM?
+        2.4. Can I save/restore the game?
+        2.5. Do savegames from the original games work in
+                ScummVM?
 
    3. Graphics and Audio
 
-                3.1. Does ScummVM support CD audio?
-
-                3.2. Does ScummVM support using MP3/Ogg/FLAC files instead of
-                CD audio?
+        3.1. Does ScummVM support CD audio?
+        3.2. Does ScummVM support using MP3/Ogg/FLAC files
+                instead of CD audio?
 
-                3.3. Does ScummVM support filtered graphic modes?
+        3.3. Does ScummVM support using MP3/Ogg/FLAC files
+                instead of the original MIDI music?
 
-                3.4. Can I run my game full screen?
+        3.4. Does ScummVM support filtered graphic modes?
+        3.5. Can I run my game full screen?
 
    4. Troubleshooting
 
-                4.1. My game won't run.
-
-                4.2. I installed my game but ScummVM can't find it.
-
-                4.3. I don't hear any sound.
-
-                4.4. I don't hear any music.
-
-                4.5. My game crashes at some point.
-
-                4.6. ScummVM crashes, but console window disappears too quick
-                to see the error message.
-
-                4.7. The game colors are messed up.
-
-                4.8. The subtitles in my non english game are messed up.
-
-                4.9. How do I make my mac version of a game work?
-
-                4.10. Reporting Bugs.
+        4.1. My game won't run.
+        4.2. I installed my game but ScummVM can't find it.
+        4.3. I don't hear any sound.
+        4.4. I don't hear any music.
+        4.5. My game crashes at some point.
+        4.6. ScummVM crashes, but console window disappears too
+                quick to see the error message.
 
-                4.11. I downloaded the Broken Sword packs from your site but
-                the game won't run.
+        4.7. The game colors are messed up.
+        4.8. The subtitles in my non english game are messed up.
+        4.9. How do I make my mac version of a game work?
+        4.10. Reporting Bugs.
+        4.11. I downloaded the Broken Sword packs from your site
+                but the game won't run.
 
-                4.12. There are no graphics in the Broken Sword I intro.
+        4.12. There are no graphics in the Broken Sword I intro.
 
    5. Features
 
-                5.1. Will you add support for zip archives?
+        5.1. Will you add support for zip archives?
 
-  1. Introduction
+1. Introduction
 
    1.1. Why is it called ScummVM - what does this name mean?
 
-   Scumm comes from the fact that it was originally designed to run SCUMM
-   games, like Monkey Island. VM stands for Virtual Machine.
+   Scumm comes from the fact that it was originally designed to
+   run SCUMM games, like Monkey Island. VM stands for Virtual
+   Machine.
 
    1.2. What is SCUMM?
 
-   SCUMM stands for "Script Creation Utility for Maniac Mansion". It is a
-   utility used to create the famous LucasArts adventure games.
+   SCUMM stands for "Script Creation Utility for Maniac Mansion".
+   It is a utility used to create the famous LucasArts adventure
+   games.
 
-   
 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.
+   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.
 
    1.3. Is ScummVM free?
 
-   ScummVM is released under the GPL (General Public License), 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.
+   ScummVM is released under the GPL (General Public License), 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.
 
    1.4. What games does ScummVM support?
 
-   We have a compatibility list 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), as well as Flight of the Amazon Queen. Other games may be
-   added, but this is not a common occurrence - see below.
+   We have a compatibility list 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), as well as
+   Flight of the Amazon Queen. Other games may be added, but this
+   is not a common occurrence - see below.
 
    1.5. Will ScummVM support other games?
 
-   The ScummVM team is currently focusing on bugfixes for our next release.
+   The ScummVM team is currently focusing on bugfixes for our
+   next release.
 
-   
 We do NOT 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.
+   We do NOT 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.
 
    1.6. When will Maniac Mansion Deluxe be supported?
 
-   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
-   Adventure Game Studio 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 FAQ (see last two questions). That means that you need to
-   download that program to play the game.
+   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 Adventure Game
+   Studio 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 FAQ (see last
+   two questions). That means that you need to download that
+   program to play the game.
 
    1.7. Where do I find ScummVM?
 
-   You can find it on the download section on our homepage. 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
-   CVS or use the 'daily builds' linked from our download page.
+   You can find it on the download section on our homepage. 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 CVS or use the 'daily builds'
+   linked from our download page.
 
    1.8. How do I compile the source code for my OS?
 
-   The source code package contains a file called README that should explain
-   everything.
+   The source code package contains a file called README that
+   should explain everything.
 
    1.9. On what platform does ScummVM run?
 
-   ScummVM should be able to be compiled on any SDL platform, with just small
-   modifications.
+   ScummVM should be able to be compiled on any SDL platform,
+   with just small modifications.
 
-   
 Currently tested platforms are Win32 (Windows 95/98/ME/NT/2000/XP),
-   Linux i386 and PPC, BeOS, Solaris, Mac OS X, Dreamcast, MorphOS, IRIX,
-   PalmOS and WinCE. It is also part of the Free/Net/Open BSD ports
-   collections and included in Debian testing and unstable
+   Currently tested platforms are Win32 (Windows
+   95/98/ME/NT/2000/XP), Linux i386 and PPC, BeOS, Solaris, Mac
+   OS X, Dreamcast, MorphOS, IRIX, PalmOS and WinCE. It is also
+   part of the Free/Net/Open BSD ports collections and included
+   in Debian testing and unstable
 
    1.10. Does ScummVM run any non-SCUMM games?
 
-   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.
+   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.
 
-   
 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.
+   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.
 
-   
 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 Compatibility List.
+   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 Compatibility
+   List.
 
-   
 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.
+   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.
 
    1.11. Can I use ScummVM to make new games?
 
-   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 libSDL
-   for a cross platform DirectX like library, and the Lua and Python
-   scripting languages for game logic.
+   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 libSDL
+   for a cross platform DirectX like library, and the Lua and
+   Python scripting languages for game logic.
 
-  2. ScummVM and SCUMM games
+2. ScummVM and SCUMM games
 
    2.1. Do I need original CD or Floppy disks?
 
-   Most definitely. ScummVM won't work without them. If you would like to buy
-   these games, we suggest you browse Ebay. Do not ask the ScummVM team where
-   you can download the full versions of LucasArts games. These requests will
-   be ignored.
+   Most definitely. ScummVM won't work without them. If you would
+   like to buy these games, we suggest you browse Ebay. Do not
+   ask the ScummVM team where you can download the full versions
+   of LucasArts games. These requests will be ignored.
 
    2.2. Does ScummVM work with all versions of games?
 
    See "What games does ScummVM support?".
 
-   2.3. Can I play through xxx (place your favorite SCUMM adventure here) ?
+   2.3. Can I play through xxx (place your favorite SCUMM
+   adventure here) ?
 
    See "What games does ScummVM support?".
 
    2.4. Can I save/restore the game?
 
-   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).
+   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).
 
    2.5. Do savegames from the original games work in ScummVM?
 
-   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 broken compatibility with older ScummVM savegames. Since ScummVM is
-   in heavy development, this may occur again in the future.
+   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 broken compatibility with older
+   ScummVM savegames. Since ScummVM is in heavy development, this
+   may occur again in the future.
 
-  3. Graphics and Audio
+3. Graphics and Audio
 
    3.1. Does ScummVM support CD audio?
 
-   Yes, ScummVM fully supports CD audio in Monkey Island CD, and Loom. 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 README for more info.
+   Yes, ScummVM fully supports CD audio in Monkey Island CD, and
+   Loom. 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 README for more info.
 
-   3.2. Does ScummVM support using MP3/Ogg/FLAC files instead of CD audio?
+   3.2. Does ScummVM support using MP3/Ogg/FLAC files instead of
+   CD audio?
 
-   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. FLAC is also supported in the current CVS tree, although not in the
-   latest released 0.6.x version. See the README for more info.
+   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 README for more info.
 
-   3.3. Does ScummVM support filtered graphic modes?
+   3.3. Does ScummVM support using MP3/Ogg/FLAC files instead of
+   the original MIDI music?
 
-   Yes, ScummVM supports several filtered graphic modes such as super2xsai.
-   See the README for more info.
+   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.
 
-   3.4. Can I run my game full screen?
+   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.
 
-   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.
+   3.4. Does ScummVM support filtered graphic modes?
 
-  4. Troubleshooting
+   Yes, ScummVM supports several filtered graphic modes such as
+   super2xsai. See the README for more info.
+
+   3.5. Can I run my game full screen?
+
+   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.
+
+4. Troubleshooting
 
    4.1. My game won't run.
 
-   First make sure your game is supported. See "What games does ScummVM
-   support?". If it is a supported game and you have followed the
-   instructions in README to the letter, then see "Reporting Bugs." to report
-   this as a bug.
+   First make sure your game is supported. See "What games does
+   ScummVM support?". If it is a supported game and you have
+   followed the instructions in README to the letter, then see
+   "Reporting Bugs." to report this as a bug.
 
    4.2. I installed my game but ScummVM can't find it.
 
-   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
-   Game Data Files page for further details.
+   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 Game Data
+   Files page for further details.
 
    4.3. I don't hear any sound.
 
-   Check the compatibility list 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.
+   Check the compatibility list 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.
 
    4.4. I don't hear any music.
 
@@ -277,80 +296,110 @@
 
    4.5. My game crashes at some point.
 
-   Check the Compatibility List 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 "Reporting Bugs.".
+   Check the Compatibility List 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 "Reporting Bugs.".
 
-   4.6. ScummVM crashes, but console window disappears too quick to see the
-   error message.
+   If you are experiencing random crashes, and your game plays
+   music from CD, you have encountered a Windows bug. Try copying
+   the data files from CD to your hard disk, and running them
+   from there.
 
-   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'.
+   4.6. ScummVM crashes, but console window disappears too quick
+   to see the error message.
+
+   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'.
 
    4.7. The game colors are messed up.
 
-   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.
+   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.
 
    4.8. The subtitles in my non english game are messed up.
 
-   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.
+   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.
 
-   
 Consult the README or command line help for further information.
+   Consult the README or command line help for further
+   information.
 
    4.9. How do I make my mac version of a game work?
 
-   The majority of mac versions won't work without first extracting the
-   resources into a format ScummVM understands. To do this you need to use
-   the rescumm tool in the scummvm-tools package. An example usage might look
-   like: rescumm "Sam & Max Demo Data". Some CDs may appear to only contain a
-   application, in which case there is still a seperate data file but it is
-   invisible. The older games which have LFL files should only need the
-   platform set to 'macintosh' to run. See "The game colors are messed up."
-   for information on specifying the game platform.
+   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.
+
+   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.
+
+   The older games which have LFL files should only need the
+   platform set to 'macintosh' to run. See "The game colors are
+   messed up." for information on specifying the game platform.
 
    4.10. Reporting Bugs.
 
-   To report a bug, please create a SourceForge account and follow the bugs
-   link from our homepage. Please make sure the bug is reproducible, and
-   still exists in the latest daily build/current CVS version. Also check the
-   compatibility listing for that game to ensure the issue is not already
-   known.
+   To report a bug, please create a SourceForge account and
+   follow the bugs link from our homepage. Please make sure the
+   bug is reproducible, and still exists in the latest daily
+   build/current CVS version. Also check the compatibility
+   listing for that game to ensure the issue is not already
+   known. In your bugreport please provide the following
+   information:
 
-   4.11. I downloaded the Broken Sword packs from your site but the game
-   won't run.
+     * ScummVM version (PLEASE test the latest CVS/Daily build)
+     * Bug details, including instructions on reproducing it
+     * Language of game (English, German, ...)
+     * Version of game (talkie, floppy, ...)
+     * Platform and Compiler (Win32, Linux, MacOS, ...)
+     * Attach a save game if possible
+     * 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.
 
-   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.
+   4.11. I downloaded the Broken Sword packs from your site but
+   the game won't run.
+
+   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.
 
    4.12. There are no graphics in the Broken Sword I intro.
 
-   Be patient. There are about 12 seconds of speech only and eventually the
-   Revolution logo will appear.
+   Be patient. There are about 12 seconds of speech only and
+   eventually the Revolution logo will appear.
 
-  5. Features
+5. Features
 
    5.1. Will you add support for zip archives?
 
-   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.
+   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.
 
-   
 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!
+   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!

Index: faq.xml
===================================================================
RCS file: /cvsroot/scummvm/docs/docbook/faq.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- faq.xml	21 Dec 2004 02:09:57 -0000	1.3
+++ faq.xml	10 May 2005 21:53:30 -0000	1.4
@@ -192,12 +192,26 @@
     <qandaentry><question><simpara>Does ScummVM support using MP3/Ogg/FLAC files instead of CD audio?</simpara></question>
 	<answer><simpara>
 	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. FLAC is also supported in the current CVS
-	tree, although not in the latest released 0.6.x version. See the
+	version 0.3.0 we also support Ogg Vorbis files. And FLAC is supported since version 0.7.0. See the
 	<ulink url="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/scummvm/scummvm/README?rev=HEAD">README</ulink>
 	for more info.</simpara></answer>
 	</qandaentry>
 
+	<qandaentry><question><simpara>Does ScummVM support using MP3/Ogg/FLAC files instead of the original MIDI music?</simpara></question>
+	<answer><simpara>
+	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.
+	</simpara>
+	<simpara>
+	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.
+	</simpara></answer>
+	</qandaentry>
+
 	<qandaentry><question><simpara>Does ScummVM support filtered graphic modes?</simpara></question>
 	<answer><simpara>
 	Yes, ScummVM supports several filtered graphic modes such as super2xsai.  See the
@@ -256,7 +270,13 @@
 	Check the <ulink url="http://www.scummvm.org/compatibility.php">Compatibility List</ulink> 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 "<xref linkend="question.report-bugs" endterm="question.report-bugs"/>".
-	</simpara></answer>
+	</simpara>
+	<simpara>
+	If you are experiencing random crashes, and your game plays music from
+	CD, you have encountered a Windows bug. Try copying the data files from
+	CD to your hard disk, and running them from there.
+	</simpara>
+	</answer>
 	</qandaentry>
 
     <qandaentry><question><simpara>ScummVM crashes, but console window disappears too quick to see the error message.</simpara></question>
@@ -292,10 +312,19 @@
 
 	<qandaentry><question><simpara>How do I make my mac version of a game work?</simpara></question>
 	<answer><simpara>
-	The majority of mac versions won't work without first extracting the resources into a format ScummVM
-	understands.  To do this you need to use the rescumm tool in the scummvm-tools package.
-	An example usage might look like: <command>rescumm "Sam & Max Demo Data"</command>.  Some CDs may appear to
-	only contain a application, in which case there is still a seperate data file but it is invisible.  
+	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.
+	</simpara>
+	<simpara>
+	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.
+	</simpara>
+	<simpara>
 	The older games which have LFL files should only need the platform set to 'macintosh' to
 	run.
 	See "<xref linkend="question.messy-colors" endterm="question.messy-colors"/>" for information on specifying the game platform.
@@ -309,7 +338,21 @@
 	link from our homepage. Please make sure the bug is reproducible, and 
 	still exists in the latest daily build/current CVS version. Also check the
 	<ulink url="http://www.scummvm.org/compatibility.php">compatibility listing</ulink> for that game to ensure
-	the issue is not already known.</simpara></answer>
+	the issue is not already known. In your bugreport please provide the following
+	information:</simpara>
+	<itemizedlist>
+	<listitem><simpara>ScummVM version (PLEASE test the latest CVS/Daily build)</simpara></listitem>
+	<listitem><simpara>Bug details, including instructions on reproducing it</simpara></listitem>
+	<listitem><simpara>Language of game (English, German, ...)</simpara></listitem>
+	<listitem><simpara>Version of game (talkie, floppy, ...)</simpara></listitem>
+	<listitem><simpara>Platform and Compiler (Win32, Linux, MacOS, ...)</simpara></listitem>
+	<listitem><simpara>Attach a save game if possible</simpara></listitem>
+	<listitem><simpara>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.</simpara></listitem>
+	</itemizedlist>
+	</answer>
 	</qandaentry>
 
     <qandaentry><question><simpara>I downloaded the Broken Sword packs from your site but the game won't run.</simpara></question>

Index: faq.pdf
===================================================================
RCS file: /cvsroot/scummvm/docs/docbook/faq.pdf,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
Binary files /tmp/cvs4J6At5 and /tmp/cvsYyHcX5 differ





More information about the Scummvm-git-logs mailing list