Documentation:

- Update the Read Me for Macintosh to reflect the current feature set.
- Fix Public Forum link in the Read Me for Macintosh.
- Add Improving Emulation Performance section in the Read Me for Macintosh.

desmume/README.MAC

@@ -1,15 +1,15 @@
                                        DeSmuME
                       _________________________________________
                       Copyright (C) 2006 yopyop
-                      Copyright (C) 2006-2012 DeSmuME team
+                      Copyright (C) 2006-2013 DeSmuME team
-                      Last Updated: March 31, 2012
+                      Last Updated: April 16, 2013
 
 Contents:
 1) System Requirements ..................................................... 15
 2) Quick Start Guide for Using DeSmuME for OS X ............................ 36
-3) Additional Documentation ............................................... 108
+3) Additional Documentation ............................................... 137
-4) Contact Information .................................................... 138
+4) Contact Information .................................................... 167
-5) License ................................................................ 257
+5) License ................................................................ 269
 
 
 1) System Requirements ________________________________________________________
@@ -54,9 +54,8 @@ you need them.
 Using the DS Controller:
 Each DS controller button can be mapped to a button of your choice on your
 keyboard, gamepad, or joystick. You can view the mappings by clicking on Input
-in DeSmuME > Preferences, and then clicking the Controller tab on the Input
+in DeSmuME > Preferences. To change a mapping, click on the DS control that you
-page. To change a mapping, click on the DS control that you want to change,
+want to change, then press the button on your input device to map it.
-then press the button on your input device to map it.
 
 By default, the DS controller is mapped to the following keys on your keyboard:
     Up - Up Arrow
@@ -72,12 +71,18 @@ By default, the DS controller is mapped to the following keys on your keyboard:
     Start - Return
     Select - Tab
     Lid - Delete (Backspace)
-    Debug - \
+    Microphone - ` (Accent)
-    Microphone - `
+
+In addition, the following emulator functions are mapped to your keyboard by
+default:
+    Execute/Pause - Forward Delete
+    Reset - Page Down
+    Set Speed to Half - - (Dash)
+    Set Speed to Double - =
 
 Using the DS Touch Pad:
-Touch pad input is emulated using the left mouse button. Simply click in the
+Touch pad input is emulated using the left mouse button by default. Simply click
-touch pad area of the DS display window to use the DS touch pad.
+in the touch pad area of the DS display window to use the DS touch pad.
 
 Rotating the DS Display:
 Some games require that the DS display be at a certain rotation in order to
@@ -104,6 +109,30 @@ use to quickly freeze/restore the emulation state.
 - To quick restore the emulation state, choose File > Load State Slot > Slot #.
   The default hotkey for this is (#).
 
+Improving Emulation Performance:
+There are many settings you can change in order to improve DeSmuME's emulation
+performance. All of the settings listed below affect performance the most. Use
+the settings as shown for the best possible performance. All of these settings
+may be found in DeSmuME > Preferences.
+
+- WARNING: Changing any Emulation setting may cause emulation glitches in
+           certain ROMs. Do not change these settings unless you are willing to
+           accept reduced ROM compatibility.
+
+    Display:
+        Video Output:
+            Use Vertical Sync - Off
+            Video Filter - None
+        3D Rendering:
+            3D Rendering Engine - SoftRasterizer
+            Rendering Threads - Automatic
+    
+    Emulation:
+        Advanced Bus Level Timing - Off (May cause glitches)
+        Rigourous 3D Rendering Timing - On (May cause graphical glitches)
+        3D Rendering Engine - Dynamic Recompiler (May reduce ROM compatibility)
+            Dynamic Recompiler Block Size - 100 (May cause glitches)
+        Use External BIOS Images - Off (May reduce ROM compatibility)
 
 3) Additional Documentation ___________________________________________________
 
@@ -165,36 +194,19 @@ lot of other useful information about DeSmuME. You can comment on different
 posts telling us how you feel about DeSmuME. Is DeSmuME the best thing in your
 life? Is it making you cry? Or is it a bunch of blah? Let us know here!
 
-* Public Forum: http://forum.desmume.org
+* Public Forum: http://forums.desmume.org
 
 If you have a question about DeSmuME, then this is the place to ask it. But
-before you ask it, be aware that your question may have already been
+before you ask it, be aware that your question may have already been answered
-answered before, so try the following things first:
+before, so try the following things first:
 
 - Read the manual and the FAQ. A lot of questions people have are usually
   already answered in our documentation.
 - Do a forum search about your question.
 
-If you still need to ask a question, then be sure to provide us the following
+If you still need to ask a question, choose Help > Submit a Support Request in
-information:
+the DeSmuME application. Follow the onscreen instructions on the Support
-
+Request Form.
-- DeSmuME app version
-- Your operating system and OS version
-- The name of the ROM (if a ROM is involved)
-- The serial code of the ROM (if a ROM is involved)
-
-The app version can be found by choosing DeSmuME > About DeSmuME in the DeSmuME
-app. Alternatively, you can select the DeSmuME app in the Finder and choose
-File > Get Info.
-
-You can find your operating system and OS version by choosing About This Mac in
-the Apple menu.
-
-The ROM name and serial can be found by choosing File > ROM Info in the DeSmuME
-application.
-
-It is very important that you provide us with this information! If you don't,
-then it will take much longer for us to respond to your question.
 
 * Live Developer Chat Channel: irc://irc.freenode.net/desmume
 
@@ -204,13 +216,15 @@ that goes on behind the scenes. If you are interested in doing any sort of
 software programming, software testing, documentation, or graphics work, then
 please join our chat channel! We would love for you to join us!
 
-* Bug Reports: http://sourceforge.net/tracker/?group_id=164579&atid=832291
+* Bug Reports:
 
 If you believe that you have found a bug, you may submit a bug report by
-choosing Help > Submit a Bug Report in the DeSmuME application, or by
+choosing Help > Submit a Bug Report in the DeSmuME application. Follow the
-following the above link. This will take you to our bug tracker on SourceForge.
+onscreen instructions on the Bug Report Form.
-Do note that you will need a SourceForge account in order to submit a bug
+
-report.
+When you click Go To Bug Report Webpage, you will be taken to our bug tracker
+on SourceForge. Do note that you will need a SourceForge account in order to
+submit a bug report.
 
 Bug submissions are very welcome and encouraged. However, when you submit a bug
 to us, you MUST provide the following information, or else your bug submission
@@ -226,19 +240,17 @@ may be rejected:
 - A description of the exact behavior you observed
 - A description of the behavior you expected
 
-You can find your Mac model identifier in the System Profiler app. The app is
+All of this information will be prepared for you if you use the Bug Report Form
-located in the Applications/Utilities folder.
+from Help > Submit a Bug Report.
 
 When you write your description, make sure that they are as detailed as
 possible. The better your descriptions are, the faster we can test and fix
-bugs.
+bugs. For example, if you observed a bug in the game Golden Sun: Dark Dawn, then
+the bug report could look something like this:
 
-For example, if you observed a bug in the game Golden Sun: Dark Dawn, then the
+    App Version: v0.9.9
-bug report could look something like this:
+    Operating System: OS X v10.8.3 (12D78)
-
+    Mac Model Identifier: iMac11,2
-    App Version: v0.9.8
-    Operating System: OS X v10.6.8
-    Mac Model Identifier: iMac 11,2
     ROM Name: GOLDENSUN_DD
     ROM Serial: NTR-BO5E-USA
     Observed Behavior: I tried to load a save state using the