docs: small Winelib Guide updates
Dimitrie O. Paun
dpaun at rogers.com
Wed Oct 1 02:31:13 CDT 2003
Add author list as with the other guides.
RCS file: /var/cvs/wine/documentation/winelib-bindlls.sgml,v
retrieving revision 1.9
diff -u -r1.9 winelib-bindlls.sgml
--- documentation/winelib-bindlls.sgml 9 Jul 2003 19:50:14 -0000 1.9
+++ documentation/winelib-bindlls.sgml 30 Sep 2003 01:01:34 -0000
@@ -1,9 +1,10 @@
- <title id="bindlls.title">Using Linux libraries as DLLs</title>
+ <!-- FIXME: note that you can link PE DLLs to Winelib apps -->
+ <title id="bindlls.title">Building WineLib DLLs</title>
- For one reason or another you may find yourself with a Linux shared
+ For one reason or another you may find yourself with a Linux
library that you want to use as if it were a Windows Dll. There are
various reasons for this including the following:
@@ -17,14 +18,14 @@
There is a well-defined interface available and there are several
- Linux solutions that are available for it.
- (The ODBC interface in Wine)
+ Linux solutions that are available for it
+ (e.g. the ODBC interface in Wine).
- You wish to do something that you can do in Linux but Wine does
- not yet support it.
+ You have a binary only Windows application that can be extended
+ through plugins, such as a text editor or IDE.
@@ -184,8 +185,7 @@
is quite long it is extremely simple in structure.
- The MAIN_OdbcInit function is the function that was named in the
- <link linkend="bindlls-spec">spec file</link> as the init function.
+ <function>DllMain</function> the function is used to initialize the DLL.
On the process attach event the function dynamically links to the
desired Linux ODBC library (since there are several available) and
builds a list of function pointers. It unlinks on the process
RCS file: /var/cvs/wine/documentation/winelib-mfc.sgml,v
retrieving revision 1.4
diff -u -r1.4 winelib-mfc.sgml
--- documentation/winelib-mfc.sgml 19 Apr 2003 02:50:57 -0000 1.4
+++ documentation/winelib-mfc.sgml 27 Sep 2003 12:42:51 -0000
@@ -47,17 +47,10 @@
<title id="mfc-legal-issues.title">Legal issues</title>
- (Extracted from the HOWTO-Winelib written by Wilbur Dale
- <wilbur.dale at lumin.nl>)
The purpose of this section is to make you aware of potential legal
problems. Be sure to read your licenses and to consult your lawyers.
In any case you should not consider the remainder of this section to
be authoritative since it has not been written by a lawyer.
- Well, let's try to have a look at the situation anyway.
During the compilation of your program, you will be combining code
RCS file: /var/cvs/wine/documentation/winelib-porting.sgml,v
retrieving revision 1.8
diff -u -r1.8 winelib-porting.sgml
--- documentation/winelib-porting.sgml 15 Sep 2003 20:09:07 -0000 1.8
+++ documentation/winelib-porting.sgml 27 Sep 2003 12:51:54 -0000
@@ -6,12 +6,11 @@
The <literal>wchar_t</literal> type has different standard
- sizes in Unix (4 bytes) and Windows (2 bytes). Recent versions
- of gcc (2.9.7 or later) support the
+ sizes in Unix (4 bytes) and Windows (2 bytes). You need a
+ recent gcc version (2.9.7 or later) that supports the
<parameter>-fshort-wchar</parameter> option to set the
size of <literal>wchar_t</literal> to the one expected
- by Windows applications. Pass this option to every file
- that is built.
+ by Windows applications.
@@ -21,25 +20,10 @@
the msvcrt runtime library instead of glibc. The functions in
glibc will not work correctly with 16 bit strings.
- To prevent warnings when declaring a single unicode character
- in C, use <function>(WCHAR)L'x'</function>, rather than
- <function>__TEXT('x')</function>. This works on Windows also.
<title id="C-library.title">C library</title>
- <!-- *** Is all of this covered now? Make sure before deleting ***
- Winelib currently only supports on C library: that of your
- compiler. three solutions: native, mixed or msvcrt except we
- only have native right now, using the native C library ->
- different behavior: fopen, O_TEXT, unicode support,
- reimplement msvcrt
There are 2 choices available to you regarding which C library
RCS file: /var/cvs/wine/documentation/winelib-user.sgml,v
retrieving revision 1.3
diff -u -r1.3 winelib-user.sgml
--- documentation/winelib-user.sgml 24 Sep 2003 05:11:51 -0000 1.3
+++ documentation/winelib-user.sgml 27 Sep 2003 12:42:04 -0000
@@ -12,6 +12,22 @@
<title>Winelib User's Guide</title>
+ <!-- Until we learn how to format this thing nicely,
+ we can't really incude it -->
More information about the wine-patches