From ef7ce0307f5b17eaab1d719c5d51871a549ace1f Mon Sep 17 00:00:00 2001 From: Peter Veenstra Date: Thu, 22 Feb 2007 08:49:02 +0000 Subject: [PATCH] Documentation update. Imported-from: https://svn.code.sf.net/p/dosbox/code-0/dosbox/trunk@2821 --- README | 53 +++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 45 insertions(+), 8 deletions(-) diff --git a/README b/README index 8e0e5fd6..94af7305 100644 --- a/README +++ b/README @@ -24,7 +24,7 @@ INDEX: 6. Mapper 7. Keyboard Layout 8. Serial Multiplayer feature -9. To run resource-demanding games +9. How to run resource-demanding games 10. The config file 11. The language file 12. Building your own version of DOSBox @@ -49,6 +49,7 @@ Q: I've got a Z instead of a C at the prompt. Q: How do I change to fullscreen ? Q: My CD-ROM doesn't work. Q: The mouse doesn't work. +Q: There is no sound. Q: The sound stutters or sounds stretched/weird. Q: I can't type \ or : in DOSBox. Q: The game/application can't find its CD-ROM. @@ -106,10 +107,26 @@ A: Usually, DOSBox detects when a game uses mouse control. When you click on you will have to lock the mouse manually by pressing CTRL-F10. +Q: There is no sound. +A: Be sure that the sound is correctly configured in the game. This might be + done during the installation or with a setup/setsound utility that + accompanies the game. First see if an autodetection option is provided. If + there is none try selecting soundblaster or soundblaster16 with the default + settings being "address=220 irq=7 dma=1". You might also want to select + midi at address 330 as music device. + The parameters of the emulated soundcards can be changed in the DOSBox + configuration file. + If you still don't get any sound set the core to normal and use some lower + fixed cycles value (like cycles=2000). Also assure that your host operating + sound does provide sound. + + Q: The sound stutters or sounds stretched/weird. A: You're using too much cpu power to keep DOSBox running at the current speed. You can lower the cycles, skip frames or get a faster machine. You can also increase the prebuffer in the configfile. + If you are using cycles=max or =auto, then make sure that there no + background processes interfering! (especially if they acces the harddisk) Q: I can't type \ or : in DOSBox. @@ -124,6 +141,8 @@ A: This is a known problem. It only occurs if your keyboard layout isn't US. 7. for \ try the keys around "enter". For ":" try shift and the keys between "enter" and "l" (US keyboard layout). 8. Try keyb.com from FreeDOS (http://projects.freedos.net/keyb/). + Look for keyb2.0 pre4 as older and newer versions are known to + have a bug in the loader routines. Q: The game/application can't find its CD-ROM. @@ -137,7 +156,8 @@ A: Be sure to mount the CD-ROM with -t cdrom switch, this will enable the Q: The game/application runs much too slow! -A: Look at the section "To run resource-demanding games" for more information. +A: Look at the section "How to run resource-demanding games" for more + information. Q: Can DOSBox harm my computer? @@ -243,14 +263,14 @@ dosbox -version -conf configfile Start DOSBox with the options specified in "configfile". Multiple -conf options may be present. - See Chapter 9 for more details. + See Chapter 10 for more details. -lang languagefile Start DOSBox using the language specified in "languagefile". -noconsole (Windows Only) Start DOSBox without showing the console window. Output will - be redirected to stdout.txt and stderr.txt + be redirected to stdout.txt and stderr.txt -machine machinetype Setup DOSBox to emulate a specific type of machine. Valid choices are: @@ -269,7 +289,13 @@ dosbox -version Note: If a name/command/configfile/languagefile contains a space, put the whole name/command/configfile/languagefile between quotes - ("command or file name"). + ("command or file name"). If you need to use quotes within quotes + (most likely with -c and mount). + Windows and OS/2 users can use single quotes inside the double quotes. + Other people should be able to use escaped double quotes inside the + double quotes. + win -c "mount c 'c:\program files\'" + linux -c "mount c \"/tmp/name with space\"" For example: @@ -911,9 +937,9 @@ Example: Be a server listening on TCP port 5000. -=================================== -9. To run resource-demanding games: -=================================== +======================================= +9. How to run resource-demanding games: +======================================= DOSBox emulates the CPU, the sound and graphic cards, and other peripherals of a PC, all at the same time. The speed of an emulated DOS application @@ -962,6 +988,17 @@ Also try to close every program but DOSBox to reserve as much resources 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=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 + ====================