User Guide Chapter 2 rewrite.
[wine] / documentation / samples / config
1 WINE REGISTRY Version 2
2 ;; All keys relative to \\Machine\\Software\\Wine\\Wine\\Config
3
4 ;; If you think it is necessary to show others your complete config for a
5 ;; bug report, filter out empty lines and comments with
6 ;; grep -v "^;" ~/.wine/config | grep '.'
7
8 [wine]
9 "Windows" = "c:\\windows"
10 "GraphicsDriver" = "x11drv"
11 ;"ShowDirSymlinks" = "1"
12 ;"ShowDotFiles" = "1"
13
14 # [wineconf]
15
16 [Version]
17 ; Windows version to imitate (win95,win98,winme,nt351,nt40,win2k,winxp,win2k3,win20,win30,win31)
18 ;"Windows" = "win98"
19 ; DOS version to imitate
20 ;"DOS" = "6.22"
21
22 ; Be careful here, wrong DllOverrides settings have the potential
23 ; to pretty much kill your setup.
24 [DllOverrides]
25 ; some dlls you may want to change
26 "oleaut32"     = "builtin, native"
27 "ole32"        = "builtin, native"
28 "comdlg32"     = "builtin, native"
29 "shell32"      = "builtin, native"
30 "shfolder"     = "builtin, native"
31 "shlwapi"      = "builtin, native"
32 "shdocvw"      = "builtin, native"
33 "advapi32"     = "builtin, native"
34 "msvcrt"       = "native, builtin"
35 "mciavi.drv"   = "native, builtin"
36 "mcianim.drv"  = "native, builtin"
37 "d3drm"        = "native, builtin"
38 "d3dxof"       = "native, builtin"
39 "dpnhpast"     = "native, builtin"
40 ; you can specify applications too
41 ; this one will apply for all notepad.exe
42 ;"*notepad.exe" = "native, builtin"
43 ; this one will apply only for a particular file
44 ;"C:\\windows\\regedit.exe" = "native, builtin"
45 ; default for all other dlls
46 "*" = "builtin, native"
47
48 [x11drv]
49 ; Number of colors to allocate from the system palette
50 "AllocSystemColors" = "100"
51 ; Use a private color map
52 "PrivateColorMap" = "N"
53 ; Favor correctness over speed in some graphics operations
54 "PerfectGraphics" = "N"
55 ; Color depth to use on multi-depth screens
56 ;;"ScreenDepth" = "16"
57 ; Allow the window manager to manage created windows
58 "Managed" = "Y"
59 ; Use a desktop window of 640x480 for Wine
60 ;"Desktop" = "640x480"
61 ; Use XFree86 DGA extension if present
62 ; (make sure /dev/mem is accessible by you !)
63 "UseDGA" = "Y"
64 ; Use XVidMode extension if present
65 "UseXVidMode" = "Y"
66 ; Use XRandR extension if present
67 "UseXRandR" = "Y"
68 ; Use the take focus protocol
69 "UseTakeFocus" = "Y"
70 ; Enable DirectX mouse grab
71 "DXGrab" = "N"
72 ; Create the desktop window with a double-buffered visual
73 ; (useful to play OpenGL games)
74 "DesktopDoubleBuffered" = "N"
75 ; Run in synchronous mode (useful for debugging X11 problems)
76 ;;"Synchronous" = "Y"
77 ;
78 ; Use the Render extension to render client side fonts (default "Y")
79 ;;"ClientSideWithRender" = "Y"
80 ; Fallback on X core requests to render client side fonts (default "Y")
81 ;;"ClientSideWithCore" = "Y"
82 ; Set both of the previous two to "N" in order to force X11 server side fonts
83 ;
84 ; Anti-alias fonts if using the Render extension (default "Y")
85 ;;"ClientSideAntiAliasWithRender" = "Y"
86 ; Anti-alias fonts if using core requests fallback (default "Y")
87 ;;"ClientSideAntiAliasWithCore" = "Y"
88 ;
89
90 [fonts]
91 ;Read the Fonts topic in the Wine User Guide before adding aliases
92 ;See a couple of examples for russian users below
93 "Default" = "-adobe-helvetica-"
94 "DefaultFixed" = "fixed"
95 "DefaultSerif" = "-adobe-times-"
96 "DefaultSansSerif" = "-adobe-helvetica-"
97
98 ;; default TrueType fonts with russian koi8-r encoding
99 ;"Default" = "-monotype-arial-*-*-*--*-*-*-*-*-*-koi8-r"
100 ;"DefaultFixed" = "-monotype-courier new-*-*-*--*-*-*-*-*-*-koi8-r"
101 ;"DefaultSerif" = "-monotype-times new roman-*-*-*--*-*-*-*-*-*-koi8-r"
102 ;"DefaultSansSerif" = "-monotype-arial-*-*-*--*-*-*-*-*-*-koi8-r"
103 ;; default cyrillic bitmap X fonts
104 ;"Default" = "-cronyx-helvetica-"
105 ;"DefaultFixed" = "fixed"
106 ;"DefaultSerif" = "-cronyx-times-"
107 ;"DefaultSansSerif" = "-cronyx-helvetica-"
108
109 ; the TrueType font dirs you want to make accessible to wine
110 [FontDirs]
111 ;"dir1" = "/usr/X11R6/lib/X11/fonts/TrueType"
112 ;"dir2" = "/usr/share/fonts/truetype"
113 ;"dir3" = "/usr/X11R6/lib/X11/fonts/TT"
114 ;"dir4" = "/usr/share/fonts/TT"
115
116 [ppdev]
117 ;; key:  io-base of the emulated port
118 ;; value : parport-device{,timeout}
119 ;; timeout for auto closing an open device ( not yet implemented)
120 ;"378" = "/dev/parport0"
121 ;"278" = "/dev/parport1"
122 ;"3bc" = "/dev/parport2"
123
124 [spooler]
125 "FILE:" = "tmp.ps"
126 "LPT1:" = "|lpr"
127 "LPT2:" = "|gs -sDEVICE=bj200 -sOutputFile=/tmp/fred -q -"
128 "LPT3:" = "/dev/lp3"
129
130 [ports]
131 ;"read"  = "0x779,0x379,0x280-0x2a0"
132 ;"write" = "0x779,0x379,0x280-0x2a0"
133
134 [Debug]
135 ;"RelayExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"
136 ;"RelayInclude" = "user32.CreateWindowA"
137 ;"RelayFromExclude" = "user32;x11drv"
138 ;"RelayFromInclude" = "sol.exe"
139 ;"SnoopExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"
140 ;"SpyExclude" = "WM_SIZE;WM_TIMER;"
141
142 [registry]
143 ;These are all booleans.  Y/y/T/t/1 are true, N/n/F/f/0 are false.
144 ;Defaults are read all, write to Home
145 ; Where to find the global registries
146 ;"GlobalRegistryDir" = "/etc";
147 ; Global registries (stored in /etc)
148 "LoadGlobalRegistryFiles" = "Y"
149 ; Load Windows registries from the Windows directory
150 "LoadWindowsRegistryFiles" = "Y"
151 ; Registry periodic save timeout in seconds
152 ; "PeriodicSave" = "600"
153 ; Save only modified keys
154 "SaveOnlyUpdatedKeys" = "Y"
155
156 [Clipboard]
157 "UsePrimary" = "0"
158
159 ; List of all directories directly contain .AFM files
160 [afmdirs]
161 "1" = "/usr/share/ghostscript/fonts"
162 "2" = "/usr/share/a2ps/afm"
163 "3" = "/usr/share/enscript"
164 "4" = "/usr/X11R6/lib/X11/fonts/Type1"
165
166 [WinMM]
167 ; Uncomment the "Drivers" line matching your sound setting.
168
169 "Drivers" = "wineoss.drv"      ; default for most common configurations
170 ;"Drivers" = "winearts.drv"    ; for KDE
171 ;"Drivers" = "winealsa.drv"    ; for ALSA users
172 ;"Drivers" = "winejack.drv"    ; for Jack sound server
173 ;"Drivers" = "winenas.drv"     ; for NAS sound system
174 ;"Drivers" = "wineaudioio.drv" ; for Solaris machines
175 ;"Drivers" = ""                ; to disable sound
176 "WaveMapper" = "msacm.drv"
177 "MidiMapper" = "midimap.drv"
178
179 [dsound]
180 ;; HEL only: Number of waveOut fragments ahead to mix in new buffers.
181 ;"HELmargin" = "5"
182 ;; HEL only: Number of waveOut fragments ahead to queue to driver.
183 ;"HELqueue" = "5"
184 ;; Max number of fragments to prebuffer
185 ;"SndQueueMax" = "28"
186 ;; Min number of fragments to prebuffer
187 ;"SndQueueMin" = "12"
188 ;; Forces emulation mode (using wave api)
189 ;"HardwareAcceleration" = "Emulation"
190 ;; Sets default playback device (0 - number of devices - 1)
191 ;"DefaultPlayback" = "0"        ; use first device (/dev/dsp)
192 ;"DefaultPlayback" = "1"        ; use second device (/dev/dsp1)
193 ;"DefaultPlayback" = "2"        ; use third device (/dev/dsp2)
194 ;; Sets default capture device (0 - number of devices - 1)
195 ;"DefaultCapture" = "0"         ; use first device (/dev/dsp)
196 ;"DefaultCapture" = "1"         ; use second device (/dev/dsp1)
197 ;"DefaultCapture" = "2"         ; use third device (/dev/dsp2)
198
199 [Network]
200 ;; Use the DNS (Unix) host name always as NetBIOS "ComputerName" (boolean, default "Y").
201 ;; Set to N if you need a persistent NetBIOS ComputerName that possibly differs 
202 ;; from the Unix host name. You'll need to set ComputerName in 
203 ;; HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ComputerName\ComputerName, too.
204 ;"UseDnsComputerName" = "N"
205
206 ;; sample AppDefaults entries
207
208 ; 3 InstallShield versions who like to put their full screen window in front,
209 ; without any chance to switch to another X11 application.
210 ; So just catch them in a desktop window.
211
212 [AppDefaults\\_INS0432._MP\\x11drv]
213 "Desktop" = "640x480"
214
215 [AppDefaults\\_INS0466._MP\\x11drv]
216 "Desktop" = "640x480"
217
218 [AppDefaults\\_INS0576._MP\\x11drv]
219 "Desktop" = "640x480"
220
221 [AppDefaults\\_INS5176._MP\\x11drv]
222 "Desktop" = "640x480"
223
224 [AppDefaults\\_INS5576._MP\\x11drv]
225 "Desktop" = "800x600"
226
227 ;[AppDefaults\\iexplore.exe\\DllOverrides]
228 ;"shlwapi" = "native"
229 ;"rpcrt4" = "native"
230 ;"ole32" = "native"
231 ;"shdocvw" = "native"
232 ;"wininet" = "native"
233 ;"shfolder" = "native"
234 ;"shell32" = "native"
235 ;"shell" = "native"
236 ;"comctl32" = "native"
237 ;
238 ;[AppDefaults\\setup.exe\\x11drv]
239 ;"Desktop" = "800x600"
240 ;
241 ;[AppDefaults\\sol.exe\\Version]
242 ;"Windows" = "nt40"
243 ;
244 ;; Some games (Quake 2, UT) refuse to accept emulated dsound devices.
245 ;; You can add an AppDefault entry like this for such cases.
246 ;[AppDefaults\\pickygame.exe\\dsound]
247 ;"EmulDriver" = "N"
248
249 # [/wineconf]