big docu update
Andreas Mohr
a.mohr at mailto.de
Wed Sep 19 07:15:07 CDT 2001
Hi all,
updates and error message improvement.
--
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
Index: documentation/architecture.sgml
===================================================================
RCS file: /home/wine/wine/documentation/architecture.sgml,v
retrieving revision 1.2
diff -u -r1.2 architecture.sgml
--- documentation/architecture.sgml 13 Dec 2000 21:52:37 -0000 1.2
+++ documentation/architecture.sgml 19 Sep 2001 10:12:25 -0000
@@ -76,9 +76,9 @@
</sect2>
<sect2>
- <title>The Wineserver</title>
+ <title>The wineserver</title>
<para>
- The Wineserver is among the most confusing concepts in Wine.
+ The wineserver is among the most confusing concepts in Wine.
What is its function in Wine? Well, to be brief, it provides
Inter-Process Communication (IPC), synchronization, and
process/thread management. When the wineserver launches, it
@@ -125,13 +125,13 @@
wineserver duplicates the file descriptor, transmits it to
the client, and leaves to the client to close the duplicate
when it's done with it).
- </para>
+ </para>
</sect2>
<sect2>
<title>The Service Thread</title>
<para>
- The Wineserver cannot do everything that needs to be done
+ The wineserver cannot do everything that needs to be done
behind the application's back, considering that it's not
threaded (so cannot do anything that would block or take any
significant amount of time), nor does it share the address
Index: documentation/configuring.sgml
===================================================================
RCS file: /home/wine/wine/documentation/configuring.sgml,v
retrieving revision 1.7
diff -u -r1.7 configuring.sgml
--- documentation/configuring.sgml 22 May 2001 19:26:31 -0000 1.7
+++ documentation/configuring.sgml 19 Sep 2001 10:12:26 -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,48 @@
<filename>"c:\\windows;c:\\windows\\system"</filename>).
</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 +498,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 +599,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 +1283,7 @@
<row>
<entry>ISO9660</entry>
<entry>cdrom</entry>
- <entry>reads labels only</entry>
+ <entry>reads labels and serial numbers (not mixed-mode CDs yet !)</entry>
</row>
</tbody>
</tgroup>
Index: documentation/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
--- documentation/installation-und-konfiguration.german 24 May 2001 18:44:50 -0000 1.3
+++ documentation/installation-und-konfiguration.german 19 Sep 2001 10:12:28 -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: documentation/wine.conf.man.in
===================================================================
RCS file: /home/wine/wine/documentation/wine.conf.man.in,v
retrieving revision 1.10
diff -u -r1.10 wine.conf.man.in
--- documentation/wine.conf.man.in 6 Aug 2001 17:49:11 -0000 1.10
+++ documentation/wine.conf.man.in 19 Sep 2001 10:12:28 -0000
@@ -1,5 +1,5 @@
.\" -*- nroff -*-
-.TH WINE.CONF 5 "August 5, 2001" "Version 20010731" "Wine Configuration File"
+.TH WINE.CONF 5 "September 1, 2001" "Version 20010824" "Wine Configuration File"
.SH NAME
wine.conf \- Wine configuration file
.SH DESCRIPTION
@@ -31,11 +31,13 @@
.PP
.B [Drive X]
.br
-This section is used to specify the root directory and type of each
+This section is used to specify the root directory and type of each emulated
.B DOS
drive, since most Windows applications require a DOS/MS-Windows based
-disk drive & directory scheme. There is one such section for every
-drive you want to configure.
+disk drive & directory scheme, which is either provided by a real
+DOS partition mounted somewhere or by some carefully crafted directory layout
+on a Unix file system ("no-windows fake installation").
+There is one such section for every drive you want to configure.
.PP
.I format: """Path""=""<rootdirectory>"""
.br
@@ -44,11 +46,11 @@
If you mounted your dos partition as
.I /dos
and installed Microsoft Windows in
-C:\\WINDOWS then you should specify
+C:\\WINDOWS (thus it shows up as /dos/WINDOWS), then you should specify
.I """Path""=""/dos"""
in the
.I [Drive C]
-section.
+section in order to configure /dos as the drive root of drive C:.
.PP
.I format: """Type""=""<type>"""
.br
@@ -82,12 +84,12 @@
.br
Recommended:
.br
- "win95" for ext2fs, VFAT and FAT32
+ "win95" for ext2fs, ReiserFS, ..., VFAT and FAT32
.br
- "msdos" for FAT16 (ugly)
+ "msdos" for FAT16 file systems (ugly, 8.3 naming)
.br
You definitely do not want to use "unix" unless you intend to port
-programs using Winelib. Always try to avoid using FAT16. Use the
+programs using Winelib. Always try to avoid using a FAT16 FS. Use the
VFAT/FAT32 OS file system driver instead.
.PP
.I format: """FailReadOnly""=""<boolean>"""
@@ -104,13 +106,16 @@
.br
Used to specify a different Windows directory; make sure to double the
backslashes.
+So if you previously configured drive C: to be at /dos, this now means that
+the windows directory should be at /dos/WINDOWS.
.PP
.I format: """system""=""<directory>"""
.br
-default: "C:\\\\WINDOWS\\\\SYSTEM"
+default: "C:\\\\WINDOWS\\\\System"
.br
Used to specify a different system directory; make sure to double the
backslashes.
+Again, given a drive C: at /dos, this would be at /dos/WINDOWS/System.
.PP
.I format: """temp""=""<directory>"""
.br
@@ -133,14 +138,14 @@
default: "C:\\\\WINDOWS;C:\\\\WINDOWS\\\\SYSTEM"
.br
Used to specify the path which will be used to find executables and
-dlls. Make sure to double all the backslashes.
+dlls. Make sure to double the backslashes.
.PP
.B [DllOverrides]
.br
.I format: """modulename""=""native,so,builtin"""
.br
.I modulename
-can be any valid module name, without extension. The specified value
+can be any valid DLL module name, without extension. The specified value
is a comma separated list of module-types to try to load in that
specific order. Case is not important and only the first letter of
each type is enough to identify the type n[ative], s[o],
@@ -171,6 +176,7 @@
Always make sure that you have some kind of strategy in mind when you start
fiddling with the current defaults and needless to say that you must know
what you are doing.
+--debugmsg +loaddll might come in handy for experimenting with that stuff.
.PP
.B [serialports]
.br
Index: files/dos_fs.c
===================================================================
RCS file: /home/wine/wine/files/dos_fs.c,v
retrieving revision 1.92
diff -u -r1.92 dos_fs.c
--- files/dos_fs.c 14 Sep 2001 00:59:58 -0000 1.92
+++ files/dos_fs.c 19 Sep 2001 10:12:29 -0000
@@ -820,7 +820,7 @@
{
if ((drive = DRIVE_FindDriveRoot( name )) == -1)
{
- MESSAGE("Warning: %s not accessible from a DOS drive\n", *name );
+ MESSAGE("Warning: %s not accessible from a DOS drive as configured in config file\n", *name );
/* Assume it really was a DOS name */
drive = DRIVE_GetCurrentDrive();
}
Index: libtest/volinfo.c
===================================================================
RCS file: /home/wine/wine/libtest/volinfo.c,v
retrieving revision 1.3
diff -u -r1.3 volinfo.c
--- libtest/volinfo.c 29 Jan 2000 21:11:47 -0000 1.3
+++ libtest/volinfo.c 19 Sep 2001 10:12:29 -0000
@@ -1,5 +1,5 @@
/*
- * This test program was copied from documentation/cdrom-label
+ * This test program was copied from the former file documentation/cdrom-label
*/
#include <windows.h>
#include <stdio.h>
Index: tools/winecheck
===================================================================
RCS file: /home/wine/wine/tools/winecheck,v
retrieving revision 1.2
diff -u -r1.2 winecheck
--- tools/winecheck 9 Aug 2001 21:15:19 -0000 1.2
+++ tools/winecheck 19 Sep 2001 10:12:29 -0000
@@ -46,7 +46,8 @@
my ($level, $reason, $advice);
-my $advice_chmod = "Use chmod as root to fix it (\"man chmod\")";
+my $advice_chmod = "If your user account is supposed to be able to access
+it properly, use chmod as root to fix it (\"man chmod\")";
my $advice_fs = "The Filesystem option indicates the filesystem behaviour Wine is supposed to *emulate*, not the filesystem which is there";
my $dev_read = 1;
Determining best CVS host...
Using CVSROOT :pserver:cvs at rhlx01.fht-esslingen.de:/home/wine
Index: README
===================================================================
RCS file: /home/wine/wine/README,v
retrieving revision 1.25
diff -u -r1.25 README
--- README 20 Jul 2001 17:56:59 -0000 1.25
+++ README 19 Sep 2001 10:12:53 -0000
@@ -125,10 +125,10 @@
documentation directory.
Wine requires a configuration file named named "config" in your
-~/.wine directory. The format of this file is explained in the man
-page. The file documentation/samples/config contains an example
-configuration file which has to be adapted and copied to the location
-mentioned above.
+~/.wine directory. The format of this file is explained in the config file
+man page (documentation/wine.conf.man).
+The file documentation/samples/config contains an example configuration file
+which has to be adapted and copied to the location mentioned above.
See http://www.winehq.com/support.shtml for further configuration hints.
@@ -164,7 +164,9 @@
to, or use a special Wine copy of them, as there have been some cases
of users reporting file corruption. Do NOT run Explorer, for instance,
if you don't have a proper backup, as it renames/cripples several
-directories sometimes.
+directories sometimes. Not even other MS apps such as e.g. Messenger are safe,
+as they launch Explorer somehow. This particular corruption (!$!$!$!$.pfr)
+can be fixed by http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
7. GETTING MORE INFORMATION
@@ -197,9 +199,26 @@
http://www.winehq.com/dev.shtml#ml for more information.
If you add something, or fix a bug, please send a patch ('diff -u'
-format preferred) to julliard at winehq.com or to the
-wine-patches at winehq.com mailing list for inclusion in the next
-release.
+format preferred) to julliard at winehq.com or to the wine-patches at winehq.com
+mailing list for inclusion in the next release.
+
+
+8. MAKING A DIFFERENCE
+
+You might really want to consider helping the Wine project, since Wine only
+has about 20 active core developers at the moment, whereas we could easily
+make use of 3 times that number without stepping on each other's toes.
+Furthermore there are a lot of places where even people without any coding
+experience can help, such as documentation writing (yes, our docu still
+kind of sucks), application database maintenance etc. etc.
+Remember: Open Source is not about free beer, it's about free speech !
+Great stuff can only be achieved if people do care about things
+and actively take part in it.
+Besides, don't you think you should give something back in return
+for the privilege of using Wine ?
+If you decided to make a difference, then please feel free to ask how to
+proceed e.g. on the wine-devel mailing list. We'll try to help wherever we
+can.
--
Alexandre Julliard
Index: DEVELOPERS-HINTS
===================================================================
RCS file: /home/wine/wine/DEVELOPERS-HINTS,v
retrieving revision 1.9
diff -u -r1.9 DEVELOPERS-HINTS
--- DEVELOPERS-HINTS 10 Jan 2001 23:59:25 -0000 1.9
+++ DEVELOPERS-HINTS 19 Sep 2001 10:12:54 -0000
@@ -23,6 +23,7 @@
GDI:
+ console/ - handling of text consoles
graphics/ - graphics drivers
x11drv/ - X11 display driver
win16drv/ -> see below
@@ -58,7 +59,7 @@
msnet/
msvcrt/ - C runtime library
msvideo/ - 16 bit video manager
- ole32/ - 32 bit OLE 2.0 librairies
+ ole32/ - 32 bit OLE 2.0 libraries
oleaut32/ - 32 bit OLE 2.0 automation
olecli/ - 16 bit OLE client
oledlg/ - OLE 2.0 user interface support
@@ -86,12 +87,13 @@
Miscellaneous:
- misc/ - shell, registry, winsock, etc.
+ misc/ - misc. wine management, registry, etc.
ipc/ - SysV IPC based interprocess communication
- win32/ - misc Win32 functions
ole/ - OLE code
- nls/ - National Language Support
+ nls/ - National Language Support
configuration files
+ unicode/ - Unicode (character) support
+ win32/ - misc Win32 functions
Tools:
------
@@ -270,7 +272,7 @@
If you need to create a new debug channel, just add the
DECLARE_DEBUG_CHANNEL to your .c file(s) and rerun
tools/make_debug. When sending out your patch, you don't need to
-provide nor ./configure nor the ./include/debugdefs.h diffs. Just
+provide neither ./configure nor the ./include/debugdefs.h diffs. Just
indicate that those files need to be regenerated.
Resources
Index: winedefault.reg
===================================================================
RCS file: /home/wine/wine/winedefault.reg,v
retrieving revision 1.30
diff -u -r1.30 winedefault.reg
--- winedefault.reg 11 Sep 2001 00:29:03 -0000 1.30
+++ winedefault.reg 19 Sep 2001 10:12:54 -0000
@@ -44,8 +44,8 @@
"DragFullWindows"="0"
#
-# Overwrite default load address of BDE
-# (Borland database engine)
+# Override default load address of BDE (Borland database engine),
+# since it's not available on Linux
#
[HKEY_LOCAL_MACHINE\Software\Borland\Database Engine\Settings\SYSTEM\INIT]
More information about the wine-patches
mailing list