From a0ff2b4adfce70dd39d744bb216bd47dc0b4a21a Mon Sep 17 00:00:00 2001
From: Andreas Mohr <andi@rhlx01.fht-esslingen.de>
Date: Wed, 27 Feb 2002 01:30:32 +0000
Subject: [PATCH] - stress the fact that wineinstall is in Wine source - add
 missing ttydrv/x11drv section to wine.conf.man - make sure that we also load
 shdocvw as builtin in sample config file - add sample AppDefaults section to
 sample config file - winecheck update

---
 README                        | 36 ++++++++++++++++++++++-------------
 documentation/installing.sgml |  2 +-
 documentation/registry.sgml   | 13 ++++++-------
 documentation/samples/config  | 16 ++++++++++++++++
 documentation/wine.conf.man   |  8 ++++++++
 tools/winecheck               |  2 +-
 6 files changed, 55 insertions(+), 22 deletions(-)

diff --git a/README b/README
index 3ed2a2a4381..20b134b8bde 100644
--- a/README
+++ b/README
@@ -14,14 +14,14 @@ that you wrote it.
 2. QUICK START
 
 Whenever you compile from source, it is recommended to use the Wine
-Installer to build and install Wine.  From the top-level Wine
-directory (which contains this file), run:
+Installer to build and install Wine.  From the top-level directory
+of the Wine source (which contains this file), run:
 
 ./tools/wineinstall
 
 Run programs as "wine [options] program".  For more information and
 problem resolution, read the rest of this file, the Wine man page,
-the files in the documentation directory in the Wine source
+the files in the documentation directory of the Wine source
 (see "DOCUMENTATION"), and especially the wealth of information
 found at http://www.winehq.com.
 
@@ -38,7 +38,7 @@ Linux info:
   Although Linux version 2.0.x will mostly work, certain features
   (specifically LDT sharing) required for properly supporting Win32
   threads were not implemented until kernel version 2.2.  If you get
-  consistent thread-related crashes, you may want to upgrade to 2.2.
+  consistent thread-related crashes, you may want to upgrade to at least 2.2.
   Also, some bugs were fixed and additional features were added
   late in the Linux 2.0.x series, so if you have a very old Linux kernel,
   you may want to upgrade to at least the latest 2.0.x release.
@@ -63,7 +63,10 @@ NetBSD info:
 File systems info:
   Wine should run on most file systems. However, Wine will fail to start
   if umsdos is used for the /tmp directory. A few compatibility problems have
-  also been reported using files accessed through Samba.
+  also been reported using files accessed through Samba. Also, as NTFS
+  can only be used safely with readonly access for now, we recommend against
+  using NTFS, as Windows programs need write access almost everywhere.
+  In case of NTFS files, copy over to a writable location.
 
 Wine requires kernel-level threads to run. Currently, only Linux
 version 2.0 or later, FreeBSD-current or FreeBSD 3.0 or later,
@@ -128,7 +131,7 @@ first.  Try either "dpkg -r wine" or "rpm -e wine" or "make uninstall"
 before installing.
 
 If you want to read the documentation supplied with the Wine source,
-then see the "DOCUMENTATION" section.
+see the "DOCUMENTATION" section.
 
 Wine requires a configuration file named named "config" in your
 ~/.wine directory. The format of this file is explained in the config file
@@ -137,16 +140,22 @@ The file documentation/samples/config contains an example configuration file
 which has to be adapted and copied to the location mentioned above.
 
 Don't forget to add vital registry entries by applying winedefault.reg
-with programs/regapi/. See documentation/ for details.
+with programs/regapi/. See documentation/ directory for details.
 
 See http://www.winehq.com/support.shtml for further configuration hints.
 
+In case of library loading errors
+(e.g. "Error while loading shared libraries: libntdll.so"), make sure
+to add the library path to /etc/ld.so.conf and run ldconfig as root.
+
 In order to verify the correctness of the environment you need for
-Wine to run successfully, run "./tools/winecheck | less".  You'll get
-a percentage score indicating "Wine configuration correctness".
+Wine to run successfully, you may run "./tools/winecheck | less".
+You'll get a percentage score indicating "Wine configuration correctness".
 As this program is alpha, it doesn't run a truly thorough test yet, though,
 so it should be taken as a first verification step only.
 
+See wine.conf man page on how to switch to text mode only support if desired.
+
 6. RUNNING PROGRAMS
 
 When invoking Wine, you may specify the entire path to the executable,
@@ -166,9 +175,10 @@ Note: the path of the file will also be added to the path when
 
 Wine is not yet complete, so several programs may crash. Provided you set up
 winedbg correctly according to documentation/debugger.sgml, you will be dropped
-into a debugger so that you can investigate and fix the problem. For more
-information on how to do this, please read the file documentation/debugging.
-If you post a bug report, please read the file documentation/bugreports to
+into a debugger so that you can investigate and fix the problem.
+For more information on how to do this, please read the file
+documentation/debugging.sgml.
+If you post a bug report, please read the file documentation/bugs.sgml to
 see what information is required.
 
 You should backup all your important files that you give Wine access
@@ -205,7 +215,7 @@ HOWTO:	The Wine HOWTO (outdated !) is available at
 
 Usenet:	The best place to get help or to report bugs is the Usenet newsgroup
 	comp.emulators.ms-windows.wine. Please read the file 
-	documentation/bugreports to see what information should be included 
+	documentation/bugs.sgml to see what information should be included 
 	in a bug report.
 
 	Please browse old messages on http://groups.google.com/ to check
diff --git a/documentation/installing.sgml b/documentation/installing.sgml
index 51005dedfc4..fdd73bc0180 100644
--- a/documentation/installing.sgml
+++ b/documentation/installing.sgml
@@ -52,7 +52,7 @@
 
         <para>
           While the users are of course free to set up everything
-          themselves, the Wine team will make the automated Wine
+          themselves, the Wine team will make the automated Wine source
           installation script, <filename>tools/wineinstall</filename>,
           do everything we find necessary to do; running the
           conventional <userinput>configure && make depend && make && make
diff --git a/documentation/registry.sgml b/documentation/registry.sgml
index 76b972888e5..99252cee5f8 100644
--- a/documentation/registry.sgml
+++ b/documentation/registry.sgml
@@ -206,7 +206,7 @@ ln -sf /usr/local/etc/wine.userreg wine.userreg
       </screen>
       <para>
         Note that the <filename>tools/wineinstall</filename> script
-        already does all of this for you, if you install Wine as root.
+        already does all of this for you, if you install Wine source as root.
         If you then install Windows applications while logged in as
         root, all your users will automatically be able to use them.
         While the application setup will be taken from the global
@@ -235,12 +235,11 @@ ln -sf /usr/local/etc/wine.userreg wine.userreg
         install applications are distributed in a file called
         <filename>winedefault.reg</filename>. It is automatically
         installed for you if you use the
-        <filename>tools/wineinstall</filename> script, but if you want
-        to install it manually, you can do so by using the
-        <command>regapi</command> tool. You can find more information
-        about this in the
-        <filename>documentation/no-windows</filename> document in the
-        Wine distribution.
+        <filename>tools/wineinstall</filename> script in the Wine source,
+	but if you want to install it manually, you can do so by using the
+        <command>regapi</command> tool to be found in the
+	<filename>programs/regapi/</filename>
+	directory in Wine source.
       </para>
     </sect2>
 
diff --git a/documentation/samples/config b/documentation/samples/config
index 43ea380c714..1b70823c29f 100644
--- a/documentation/samples/config
+++ b/documentation/samples/config
@@ -81,6 +81,7 @@ WINE REGISTRY Version 2
 "shell32"      = "builtin, native"
 "shfolder"     = "builtin, native"
 "shlwapi"      = "builtin, native"
+"shdocvw"      = "builtin, native"
 "lzexpand"     = "builtin, native"
 "lz32"         = "builtin, native"
 "comctl32"     = "builtin, native"
@@ -240,4 +241,19 @@ WINE REGISTRY Version 2
 "WaveMapper" = "msacm.drv"
 "MidiMapper" = "midimap.drv"
 
+;; sample AppDefaults entries
+;[AppDefaults\\iexplore.exe\\DllOverrides]
+;"shlwapi" = "native"
+;"rpcrt4" = "native"
+;"ole32" = "native"
+;"shdocvw" = "native"
+;"wininet" = "native"
+;"shfolder" = "native"
+;"shell32" = "native"
+;"shell" = "native"
+;"comctl32" = "native"
+;
+;[AppDefaults\\setup.exe\\x11drv]
+;"Desktop" = "800x600"
+
 # </wineconf>
diff --git a/documentation/wine.conf.man b/documentation/wine.conf.man
index 43263dc2d7b..613910ce13e 100644
--- a/documentation/wine.conf.man
+++ b/documentation/wine.conf.man
@@ -145,6 +145,14 @@ default: "C:\\\\WINDOWS;C:\\\\WINDOWS\\\\SYSTEM"
 Used to specify the path which will be used to find executables and
 dlls. Make sure to double the backslashes.
 .PP
+.I format: """GraphicsDriver""=""<x11drv|ttydrv>"""
+.br
+default: "x11drv"
+.br
+Tells Wine which graphics driver to use. Normally you'd want to use
+x11drv (for X11). In case you want to run programs as text console/TTY only
+without having Wine rely on X11 support, then use ttydrv.
+.PP
 .B [DllOverrides]
 .br
 .I format: """modulename""=""native,so,builtin"""
diff --git a/tools/winecheck b/tools/winecheck
index 5be63cded69..97962a87dad 100755
--- a/tools/winecheck
+++ b/tools/winecheck
@@ -592,7 +592,7 @@ sub Check_Registry {
   }
   else
   {
-    Do_PrintResult($is_critical, "entry \"Default Taskbar\" not found", "Windows registry does not seem to be added to Wine, as this typical Windows registry entry does not exist in Wine's registry. This can affect many newer programs. Original registry entries won't be available with a no-windows install, of course, so you'll have to live with that.");
+    Do_PrintResult($is_critical, "entry \"Default Taskbar\" not found", "Windows registry does not seem to be added to Wine, as this typical Windows registry entry does not exist in Wine's registry. This can affect many newer programs. A complete original Windows registry entry set will *not* be available with a no-windows install, of course, so you'll have to live with that.");
   }
   @entries = ();
 }
-- 
GitLab