0.70 administrative changes

Imported-from: https://svn.code.sf.net/p/dosbox/code-0/dosbox/trunk@2830

README

@@ -1,4 +1,4 @@
-DOSBox v0.66
+DOSBox v0.70
 
 
 =====
@@ -25,11 +25,12 @@ INDEX:
 7. Keyboard Layout
 8. Serial Multiplayer feature
 9. How to run resource-demanding games
-10. The config file
-11. The language file
-12. Building your own version of DOSBox
-13. Special thanks
-14. Contact
+10. Troubleshooting
+11. The config file
+12. The language file
+13. Building your own version of DOSBox
+14. Special thanks
+15. Contact
 
 
 ==============
@@ -311,7 +312,9 @@ In Windows, you can also drag directories/files onto the DOSBox executable.
 4. Internal Programs:
 =====================
 
-DOSBox supports most of the DOS commands found in command.com. 
+DOSBox supports most of the DOS commands found in command.com.
+To get a list of the internal commands type "HELP" at the prompt.
+
 In addition, the following commands are available: 
 
 MOUNT "Emulated Drive letter" "Real Drive or Directory" 
@@ -416,7 +419,7 @@ CONFIG -get "section property"
   CONFIG can be used to change or query various settings of DOSBox 
   during runtime. It can save the current settings and language strings to
   disk. Information about all possible sections and properties can 
-  be found in section 10 (The Config File).
+  be found in section 11 (The Config File).
 
   -writeconf localfile
        Write the current configuration settings to file. "localfile" is 
@@ -424,7 +427,7 @@ CONFIG -get "section property"
        The configuration file controls various settings of DOSBox: 
        the amount of emulated memory, the emulated soundcards and many more 
        things. It allows access to AUTOEXEC.BAT as well.
-       See section 10 (The Config File) for more information.
+       See section 11 (The Config File) for more information.
 
   -writelang localfile
        Write the current language settings to file. "localfile" is 
@@ -745,9 +748,9 @@ This maximum will vary from computer to computer.
 
 
 
-=============
+==========
 6. Mapper:
-=============
+==========
 
 When you start the DOSBox mapper (either with CTRL-F1 or -startmapper as
 a command line argument to the DOSBox executable) you are presented with 
@@ -837,9 +840,9 @@ is present in the configfile.
 
 
 
-====================
+===================
 7. Keyboard Layout:
-====================
+===================
 
 To switch to a different keyboard layout, either the entry "keyboardlayout"
 in the [dos]-section in dosbox.conf can be used, or the internal DOSBox
@@ -991,18 +994,53 @@ as possible for DOSBox.
 Advanced cycles configuration:
 The cycles=auto and cycles=max settings can be parametrized to have
 different startup defaults. The syntax is
-  cycles= auto ["realmode default"] ["protected mode default"%] 
-               [limit "cycle limit"]
+  cycles=auto ["realmode default"] ["protected mode default"%] 
+              [limit "cycle limit"]
   cycles=max ["protected mode default"%] [limit "cycle limit"]
 Example:
   cycles=auto 1000 80% limit 20000
   will use cycles=1000 for real mode games, 80% cpu throttling for 
-  protected mode games along with a hard cycles limit of 20000
+  protected mode games along with a hard cycle limit of 20000
 
 
 
 ====================
-10. The Config File:
+10. Troubleshooting:
+====================
+
+DOSBox crashes right after starting it:
+  - use different values for the output= entry in your DOSBox
+    configuration file
+  - try to update your graphics card driver and DirectX
+
+Running a certain game closes DOSBox, crashes with some message or hangs:
+  - see if it works with a default DOSBox installation
+    (unmodified configuration file)
+  - try it with sound disabled (use the sound configuration
+    program that comes with the game, additionally you can
+    use sbtype=none and gus=false)
+  - change some entries of the DOSBox configuration file, especially try:
+      core=normal
+      fixed cycles (for example cycles=10000)
+      ems=false
+      xms=false
+    or combinations of the above settings
+  - use loadfix before starting the game
+
+The game exits to the DOSBox prompt with some error message:
+  - read the error message closely and try to locate the error
+  - try the hints at the above sections
+  - mount differently as some games are picky about the locations,
+    for example if you used "mount d d:\oldgames\game" try
+    "mount c d:\oldgames\game" and "mount c d:\oldgames"
+  - if the game requires a cdrom be sure you used "-t cdrom" when
+    mounting and try different additional parameters
+  - check the file permissions of the game files (remove read-only
+    attributes, add write permissions etc.)
+  - try reinstalling the game within dosbox
+
+====================
+11. The Config File:
 ====================
 
 A config file can be generated by CONFIG.COM, which can be found on the 
@@ -1025,7 +1063,7 @@ look in the current directory for dosbox.conf.
 
 
 ======================
-11. The Language File:
+12. The Language File:
 ======================
 
 A language file can be generated by CONFIG.COM. 
@@ -1037,7 +1075,7 @@ section. There's a language= entry that can be changed with the filename.
 
 
 ========================================
-12. Building your own version of DOSBox:
+13. Building your own version of DOSBox:
 ========================================
 
 Download the source.
@@ -1046,7 +1084,7 @@ Check the INSTALL in the source distribution.
 
 
 ===================
-13. Special Thanks:
+14. Special thanks:
 ===================
 
 Vlad R. of the VDMSound project for excellent SoundBlaster info.
@@ -1055,12 +1093,15 @@ The Bochs and DOSemu projects, which I used for information.
 Freedos for ideas in making my shell.
 Pierre-Yves Gérardy for hosting the old Beta Board.
 Colin Snover for hosting our forum.
+Jantien for the version management.
+Shawn and Johannes for creating the MAC OS X PPC version.
+Ido Beeri for the icon.
 The Beta Testers.
 
 
 
 ============
-14. Contact:
+15. Contact:
 ============
 
 See the site: