docu patch

Andreas Mohr a.mohr at mailto.de
Mon Jul 23 19:15:46 CDT 2001


Hi all,

some docu enhancements (also documents BuildVersion_OLEAUT32 setting).

Alexandre, sorry for mixing up the sample config. Please use this version.

FWIW, the WineHQ docu hasn't been updated yet (in a long time).

-- 
Andreas Mohr                        Stauferstr. 6, D-71272 Renningen, Germany
-------------- next part --------------
Determining best CVS host...
Using CVSROOT :pserver:cvs at rhlx01.fht-esslingen.de:/home/wine
? .configuring.sgml.swp
Index: configuring.sgml
===================================================================
RCS file: /home/wine/wine/documentation/configuring.sgml,v
retrieving revision 1.7
diff -u -r1.7 configuring.sgml
--- configuring.sgml	22 May 2001 19:26:31 -0000	1.7
+++ configuring.sgml	23 Jul 2001 22:13:45 -0000
@@ -94,11 +94,6 @@
                 <entry>Overides defaults for DLL loading</entry>
               </row>
               <row>
-                <entry>[options]</entry>
-                <entry>no</entry>
-                <entry>No one seems to know</entry>
-              </row>
-              <row>
                 <entry>[fonts]</entry>
                 <entry>yes</entry>
                 <entry>Font appearance and recognition</entry>
@@ -292,9 +287,9 @@
         <sect3>
           <title>The [wine] Section </title>
           <para>
-            The [wine] section of the configuration file contains
-            information wine uses for directories. When specifying the
-            directories for the settings, make them as they would
+            The [wine] section of the configuration file contains all kinds
+            of general settings for Wine. When specifying the directories
+	    for the directory related settings, make them as they would
             appear in wine. If your drive <medialabel>C</medialabel>
             has a path of <filename>/dos</filename>, and your
             <filename>windows</filename> directory is located in
@@ -337,21 +332,60 @@
             <filename>"c:\\windows;c:\\windows\\system"</filename>).
           </para>
           <para>
+            <programlisting>"BuildVersion_OLEAUT32" = "X.YY.ZZZZ"</programlisting>
+	    Overrides the build version of OLEAUT32.DLL that Wine is to
+	    return. The OLEAUT32 version consists of a major, a minor and a
+	    build number. Normally, Wine returns an appropriate build version
+	    for the --winver that's currently used (i.e. 2.xx.0xffff).
+	    If applications still don't like this version, even though
+	    we're returning the very high build version of 0xffff (65535),
+	    then you can specify your own custom version value here.
+	    This setting can be specified on a per-app basis, too
+	    (under [AppDefaults\\AppName.exe\\wine]).
+	  </para>
+          <para>
+            <programlisting>"GraphicsDriver" = "x11drv|ttydrv"</programlisting>
+	    Sets the graphics driver to use for Wine output.
+	    x11drv is for X11 output, ttydrv is for text console output.
+	    WARNING: if you use ttydrv here, then you won't be able to run
+	    any Windows GUI programs. Thus this option is mainly interesting
+	    for e.g. embedded use of Wine in web server scripts.
+	  </para>
+	  <para>
+            <programlisting>"Printer" = "off|on"</programlisting> Tells wine
+            whether to allow printing via printer drivers to work.
+	    This option isn't needed for our builtin psdrv printer driver
+	    at all.
+            Using these things are pretty alpha, so you might want to
+            watch out. Some people might find it useful, however. If
+            you're not planning on working on printing via windows printer
+	    drivers, don't even add this to your wine config file
+	    (It probably isn't already in it).
+	    Check out the [spooler] and [parallelports] sections too.
+          </para>
+	  <para>
+	    <programlisting>"ShellLinker" = "wineshelllink"</programlisting>
+	    This setting specifies the shell linker script to use for setting
+	    up Windows icons in e.g. KDE or Gnome that are given by programs
+	    making use of appropriate shell32.dll functionality to create
+	    icons on the desktop/start menu during installation.
+	  </para>
+	  <para>
+	    <programlisting>"ShowDirSymlinks" = "1"</programlisting>
+	    Wine doesn't pass directory symlinks to Windows programs by
+	    default, as doing so may crash some programs that do
+	    recursive lookups of whole subdirectory trees
+	    whenever a directory symlink points back to itself or one of its
+	    parent directories.
+	    That's why we disallowed the use of directory symlinks
+	    and added this setting to reenable ("1") this functionality.
+	  </para>
+          <para>
             <programlisting>"SymbolTableFile" = "wine.sym"</programlisting>
             Sets up the symbol table file for the wine debugger. You
             probably don't need to fiddle with this. May be useful if
             your wine is stripped.
           </para>
-          <para>
-            <programlisting>"printer" = "off|on"</programlisting> Tells wine
-            whether to allow printer drivers and printing to work.
-            Using these things are pretty alpha, so you might want to
-            watch out. Some people might find it useful, however. If
-            you're not planning on working on printing, don't even add
-            this to your <filename>~/.wine/config</filename> (It probably
-            isn't already in it). Check out the [spooler] and
-            [parallelports] sections too.
-          </para>
         </sect3>
 
         <sect3>
@@ -476,7 +510,7 @@
           </para>
           <para>
             This setting is a comma-delimited list of which order to
-            attempt loading DLL's. If the first option fails, it will
+            attempt loading DLL's at. If the first option fails, it will
             try the second, and so on. The order specified above is
             probably the best in most conditions.
           </para>
@@ -577,19 +611,6 @@
         </sect3>
 
         <sect3>
-          <title>The [options] Section</title>
-          <para>
-            No one seems to know what this section is...
-          </para>
-          <para>
-            <programlisting>
-"AllocSystemColors" = "100"
-            </programlisting>
-            System colors to allocate? Just leave it at 100.
-          </para>
-        </sect3>
-
-        <sect3>
           <title>The [fonts] Section</title>
           <para>
             This section sets up wine's font handling.
@@ -1274,7 +1295,7 @@
               <row>
                 <entry>ISO9660</entry>
                 <entry>cdrom</entry>
-                <entry>reads labels only</entry>
+                <entry>reads labels and serial numbers (not mixed-mode CDs !)</entry>
               </row>
             </tbody>
           </tgroup>
Index: installation-und-konfiguration.german
===================================================================
RCS file: /home/wine/wine/documentation/installation-und-konfiguration.german,v
retrieving revision 1.3
diff -u -r1.3 installation-und-konfiguration.german
--- installation-und-konfiguration.german	24 May 2001 18:44:50 -0000	1.3
+++ installation-und-konfiguration.german	23 Jul 2001 22:13:47 -0000
@@ -1822,7 +1822,7 @@
    erstellen, falls dies noch nicht geschehen ist. Danach k?nnen die
    erforderlichen Daten mit dem folgenden Befehl importiert werden:
    
-   ./regapi setValue ../../winedefault.reg
+   ./regapi setValue < ../../winedefault.reg
    
 8 Aufruf von WINE und Kommandozeilenoptionen
 
Index: samples/config
===================================================================
RCS file: /home/wine/wine/documentation/samples/config,v
retrieving revision 1.13
diff -u -r1.13 config
--- samples/config	26 Jun 2001 21:06:08 -0000	1.13
+++ samples/config	23 Jul 2001 22:13:47 -0000
@@ -64,6 +64,11 @@
 ; subdir tree in case of a symlink pointing back to itself.
 ;"ShowDirSymlinks" = "1"
 "ShellLinker" = "wineshelllink"
+; Overrides the builtin values of the build version of OLEAUT32.DLL.
+; Format X.YY.ZZZZ, where X = (2), YY = (20, 30, 40) and ZZZZ = build number.
+; Use this if you get strange OLE or OLEAUT32 "too old" or "version" errors.
+; Can also be given in the [AppDefaults\\AppName.exe\\wine] section.
+;"BuildVersion_OLEAUT32" = "2.40.4515"
 
 # <wineconf>
 


More information about the wine-patches mailing list