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 @@ 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, tools/wineinstall, do everything we find necessary to do; running the conventional 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 Note that the tools/wineinstall 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 winedefault.reg. It is automatically installed for you if you use the - tools/wineinstall script, but if you want - to install it manually, you can do so by using the - regapi tool. You can find more information - about this in the - documentation/no-windows document in the - Wine distribution. + tools/wineinstall script in the Wine source, + but if you want to install it manually, you can do so by using the + regapi tool to be found in the + programs/regapi/ + directory in Wine source. 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" + # 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""=""""" +.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 = (); }