[Scummvm-cvs-logs] SF.net SVN: scummvm:[49219] web/trunk/data

fingolfin at users.sourceforge.net fingolfin at users.sourceforge.net
Tue May 25 21:28:32 CEST 2010


Revision: 49219
          http://scummvm.svn.sourceforge.net/scummvm/?rev=49219&view=rev
Author:   fingolfin
Date:     2010-05-25 19:28:32 +0000 (Tue, 25 May 2010)

Log Message:
-----------
Improve the FAQ a little bit

Modified Paths:
--------------
    web/trunk/data/faq-xml.xml
    web/trunk/data/faq.xml

Modified: web/trunk/data/faq-xml.xml
===================================================================
--- web/trunk/data/faq-xml.xml	2010-05-25 19:25:33 UTC (rev 49218)
+++ web/trunk/data/faq-xml.xml	2010-05-25 19:28:32 UTC (rev 49219)
@@ -67,45 +67,52 @@
 	</answer>
     </entry>
     <entry>
-      <href/>
+      <href>question.compiling</href>
       <question>How do I compile the source code for my OS?</question>
       <answer>
 		<simpara>
 		The source code package contains a file called
 		<ulink url="http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/README">README</ulink>
-		that should explain everything.
+		explaining the basics. More detailed information can be found
+		<ulink url="http://wiki.scummvm.org/index.php/Compiling_ScummVM">on our Wiki</ulink>.
 		</simpara>
 	</answer>
     </entry>
     <entry>
-      <href/>
+      <href>question.supported-platforms</href>
       <question>On what platform does ScummVM run?</question>
       <answer>
 		<simpara>
-		ScummVM should be able to be compiled on any SDL platform, with just small modifications.
+		ScummVM should be able to be compiled for any platform supported by
+		<ulink url="http://www.libsdl.org">SDL</ulink>, with just small modifications.
 		</simpara>
 		<simpara>
-		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.
+		ScummVM runs on a wide variety of platforms, including Win32 (Windows
+		95/98/ME/NT/2000/XP), Linux i386 and PPC, Mac OS X, many smart phones
+		and game consoles and more. It is also part of various BSD ports
+		collections and included in Debian testing and unstable.
 		</simpara>
 		<simpara>
-		See also the <ulink url="http://wiki.scummvm.org/index.php/Platforms">platforms list</ulink>
+		For a more comprehensive overview please take a look at the
+		<ulink url="http://wiki.scummvm.org/index.php/Platforms">platforms list</ulink>
 		in our Wiki.
 		</simpara>
 	</answer>
     </entry>
     <entry>
-      <href/>
+      <href>question.make-new-games</href>
       <question>Can I use ScummVM to make new games?</question>
       <answer>
 		<simpara>
-		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 <ulink url="http://www.libsdl.org">SDL</ulink> for
-		a cross platform DirectX like library, and the <ulink url="http://www.lua.org">Lua</ulink>
-		and <ulink url="http://www.python.org">Python</ulink> 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
+		<ulink url="http://www.libsdl.org">SDL</ulink> for a cross platform
+		multimedia library (also used by ScummVM), and the
+		<ulink url="http://www.lua.org">Lua</ulink> and
+		<ulink url="http://www.python.org">Python</ulink> scripting languages
+		for game logic.
 		</simpara>
 	</answer>
     </entry>
@@ -126,21 +133,29 @@
 	</answer>
     </entry>
     <entry>
-      <href/>
+      <href>question.add-new-games</href>
       <question>Will ScummVM support other games?</question>
       <answer>
 		<simpara>
-		That depends on several factors. First off, it has to fit within the scope of ScummVM,
-		i.e., it has to be a point and click adventure with 2D graphics. 
+		That depends on several factors: First off, it has to fit within the
+		scope of ScummVM, i.e., it has to be a point and click adventure with 2D
+		graphics. Secondly, there must be a developer (or multiple) who is
+		interested in working on this and both willing and able to carry out the
+		required work.
 		</simpara>
 		<simpara>
-		Secondly, there must be a developer (or multiple) who is interested in working on this
-		and both willing and able to perform the work required.
-		Reverse engineering a completely new game without source is a
-		long and difficult 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, or want to do the work yourself, please do not ask.
+		You have to understand that all ScummVM developers are volunteers who
+		work on ScummVM in their spare time, solely for fun, and not for profit.
+		Yet reverse engineering a completely new game without source is a long
+		and difficult process. Even with source it can be very tedious and time
+		consuming.
 		</simpara>
+		<simpara>
+		So unless you work for a company interested in providing us with source
+		code for one of your classic titles, or want to do the work yourself,
+		please do not ask us to add support for a new game. We will simply
+		reject any such requests out of hand.
+		</simpara>
 	</answer>
     </entry>
     <entry>
@@ -417,19 +432,25 @@
       <question>The game colors are messed up.</question>
       <answer>
 		<simpara>
-		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 when using certain Amiga version datafiles.
+		Normally, ScummVM should have detected your game as an "Amiga" version,
+		but sometimes this fails for various reasons.
 		</simpara>
+		<simpara>
+		To fix this, select "Amiga" as a platform in the ScummVM Game Options
+		dialog, or use the "--platform=amiga" command line parameter to enable
+		Amiga-specific code.
+		</simpara>
 	</answer>
     </entry>
     <entry>
       <href/>
-      <question>The subtitles in my non English game are messed up.</question>
+      <question>The subtitles in my non-English game are messed up.</question>
       <answer>
 		<simpara>
-		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
+		You are most likely using a game such as Maniac Mansion or Zak McKracken
+		if you have this problem. You need to specify the correct language in
+		the ScummVM Game Options dialog, or via the "--language" parameter or by
 		using the 'language' config file option.
 		</simpara>
 		<simpara>
@@ -441,7 +462,7 @@
     </entry>
     <entry>
       <href/>
-      <question>How do I make my mac version of a game work?</question>
+      <question>How do I make my Macintosh version of a game work?</question>
       <answer>
 		<simpara>
 		First, if you use a ScummVM version prior to 0.7.0 we strongly recommend you
@@ -449,8 +470,8 @@
 		</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").
+		"<Game\xA0Title>\xA0Data" (where <Game\xA0Title> is
+		name of your game, such as "The\xA0Dig" or "Sam\xA0&\xA0Max").
 		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

Modified: web/trunk/data/faq.xml
===================================================================
--- web/trunk/data/faq.xml	2010-05-25 19:25:33 UTC (rev 49218)
+++ web/trunk/data/faq.xml	2010-05-25 19:28:32 UTC (rev 49219)
@@ -73,42 +73,49 @@
 	</answer>
 	</qandaentry>
 
-	<qandaentry><question><simpara>How do I compile the source code for my OS?</simpara></question>
+	<qandaentry><question id="question.compiling"><simpara>How do I compile the source code for my OS?</simpara></question>
 	<answer>
 		<simpara>
 		The source code package contains a file called
 		<ulink url="http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/README">README</ulink>
-		that should explain everything.
+		explaining the basics. More detailed information can be found
+		<ulink url="http://wiki.scummvm.org/index.php/Compiling_ScummVM">on our Wiki</ulink>.
 		</simpara>
 	</answer>
 	</qandaentry>
 
-	<qandaentry><question><simpara>On what platform does ScummVM run?</simpara></question>
+	<qandaentry><question id="question.supported-platforms"><simpara>On what platform does ScummVM run?</simpara></question>
 	<answer>
 		<simpara>
-		ScummVM should be able to be compiled on any SDL platform, with just small modifications.
+		ScummVM should be able to be compiled for any platform supported by
+		<ulink url="http://www.libsdl.org">SDL</ulink>, with just small modifications.
 		</simpara>
 		<simpara>
-		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.
+		ScummVM runs on a wide variety of platforms, including Win32 (Windows
+		95/98/ME/NT/2000/XP), Linux i386 and PPC, Mac OS X, many smart phones
+		and game consoles and more. It is also part of various BSD ports
+		collections and included in Debian testing and unstable.
 		</simpara>
 		<simpara>
-		See also the <ulink url="http://wiki.scummvm.org/index.php/Platforms">platforms list</ulink>
+		For a more comprehensive overview please take a look at the
+		<ulink url="http://wiki.scummvm.org/index.php/Platforms">platforms list</ulink>
 		in our Wiki.
 		</simpara>
 	</answer>
 	</qandaentry>
 
-	<qandaentry><question><simpara>Can I use ScummVM to make new games?</simpara></question>
+	<qandaentry><question id="question.make-new-games"><simpara>Can I use ScummVM to make new games?</simpara></question>
 	<answer>
 		<simpara>
-		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 <ulink url="http://www.libsdl.org">SDL</ulink> for
-		a cross platform DirectX like library, and the <ulink url="http://www.lua.org">Lua</ulink>
-		and <ulink url="http://www.python.org">Python</ulink> 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
+		<ulink url="http://www.libsdl.org">SDL</ulink> for a cross platform
+		multimedia library (also used by ScummVM), and the
+		<ulink url="http://www.lua.org">Lua</ulink> and
+		<ulink url="http://www.python.org">Python</ulink> scripting languages
+		for game logic.
 		</simpara>
 	</answer>
 	</qandaentry>
@@ -132,20 +139,28 @@
 	</answer>
 	</qandaentry>
 
-	<qandaentry><question><simpara>Will ScummVM support other games?</simpara></question>
+	<qandaentry><question id="question.add-new-games"><simpara>Will ScummVM support other games?</simpara></question>
 	<answer>
 		<simpara>
-		That depends on several factors. First off, it has to fit within the scope of ScummVM,
-		i.e., it has to be a point and click adventure with 2D graphics. 
+		That depends on several factors: First off, it has to fit within the
+		scope of ScummVM, i.e., it has to be a point and click adventure with 2D
+		graphics. Secondly, there must be a developer (or multiple) who is
+		interested in working on this and both willing and able to carry out the
+		required work.
 		</simpara>
 		<simpara>
-		Secondly, there must be a developer (or multiple) who is interested in working on this
-		and both willing and able to perform the work required.
-		Reverse engineering a completely new game without source is a
-		long and difficult 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, or want to do the work yourself, please do not ask.
+		You have to understand that all ScummVM developers are volunteers who
+		work on ScummVM in their spare time, solely for fun, and not for profit.
+		Yet reverse engineering a completely new game without source is a long
+		and difficult process. Even with source it can be very tedious and time
+		consuming.
 		</simpara>
+		<simpara>
+		So unless you work for a company interested in providing us with source
+		code for one of your classic titles, or want to do the work yourself,
+		please do not ask us to add support for a new game. We will simply
+		reject any such requests out of hand.
+		</simpara>
 	</answer>
 	</qandaentry>
 
@@ -410,18 +425,24 @@
 	<qandaentry><question id="question.messy-colors"><simpara id="question.messy-colors.text">The game colors are messed up.</simpara></question>
 	<answer>
 		<simpara>
-		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 when using certain Amiga version datafiles.
+		Normally, ScummVM should have detected your game as an "Amiga" version,
+		but sometimes this fails for various reasons.
 		</simpara>
+		<simpara>
+		To fix this, select "Amiga" as a platform in the ScummVM Game Options
+		dialog, or use the "--platform=amiga" command line parameter to enable
+		Amiga-specific code.
+		</simpara>
 	</answer>
 	</qandaentry>
 
-	<qandaentry><question><simpara>The subtitles in my non English game are messed up.</simpara></question>
+	<qandaentry><question><simpara>The subtitles in my non-English game are messed up.</simpara></question>
 	<answer>
 		<simpara>
-		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
+		You are most likely using a game such as Maniac Mansion or Zak McKracken
+		if you have this problem. You need to specify the correct language in
+		the ScummVM Game Options dialog, or via the "--language" parameter or by
 		using the 'language' config file option.
 		</simpara>
 		<simpara>
@@ -432,7 +453,7 @@
 	</answer>
 	</qandaentry>
 
-	<qandaentry><question><simpara>How do I make my mac version of a game work?</simpara></question>
+	<qandaentry><question><simpara>How do I make my Macintosh version of a game work?</simpara></question>
 	<answer>
 		<simpara>
 		First, if you use a ScummVM version prior to 0.7.0 we strongly recommend you


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




More information about the Scummvm-git-logs mailing list