Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
update readme file, put in toplevel dir
svn path=/trunk/mcs/; revision=9464
- Loading branch information
1 parent
0af95e9
commit cf5516e
Showing
3 changed files
with
105 additions
and
54 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,102 @@ | ||
System.Windows.Forms README | ||
|
||
by John Sohn (jsohn@columbus.rr.com) and Miguel de Icaza (miguel@ximian.com) | ||
|
||
The maintainers: | ||
Dennis Hayes (DENNISH@Raytek.com) | ||
Backup: Miguel de Icaza (miguel@ximian.com) | ||
|
||
Mailing list: | ||
|
||
http://lists.ximian.com/mailman/listinfo/mono-winforms-list | ||
|
||
The address is: | ||
|
||
mono-winforms-list@ximian.com. | ||
|
||
|
||
* Introduction | ||
|
||
Welcome to the System.Windows.Forms implementation for Mono. | ||
|
||
This is still an early version of the class library. The | ||
plans for this library have changed, the plans to use multiple | ||
backends is no longer being pursued. | ||
|
||
We are now implementing this using the Wine library (because | ||
Windows.Forms applications require the message handling to be | ||
compatible with Windows, look up the Control.Wndproc method | ||
for details). | ||
|
||
Currently it is possible to use the Visual Studio solution in | ||
this directory to build the class libraries, and test the | ||
sample programs against our implementation. | ||
|
||
To run and execute with the Mono runtime on linux, the story | ||
is more complicated as we need to use the "WineLib" support in | ||
Wine. | ||
|
||
* The Layout | ||
|
||
The layout in this directory has some historical files that you can | ||
safely ignore, the following are just historical directories: | ||
|
||
Gtk/ | ||
WINElib/ | ||
|
||
All of the real code is being done in the same was as it is being done | ||
in the rest of the Mono assemblies. | ||
|
||
* Building System.Windows.Forms for Unix using Wine. | ||
|
||
Since a WineLib application is a Windows application that is compiled under | ||
Unix/Linux as a shared library it needs to be started differently than other | ||
applications. The WineLib application is started as any other Windows | ||
application running under Wine using the wine command. You cannot simply link | ||
in libwine (gcc myapp.c -lwine) to use Win32 functions. | ||
|
||
In order to use WineLib/Win32 functions under Mono I have created a small | ||
"stub" application that embeds the Mono engine inside the WineLib application. | ||
This is basically a replacement for the "mono" command that can be used | ||
to call the Win32 API (using WineLib) within an application written for Mono. | ||
|
||
To get started I suggest installing Wine and Mono first if they are not | ||
already installed. I am usually using the latest Wine snapshots built from | ||
source and installed under /usr/local. Also be sure to build/use a version of | ||
Mono with garbage collection disabled as there is a problem using WineLib with | ||
garbage collection enabled (check the mono-list archives for this discussion). | ||
You can disable garbage collection when building mono by adding --with-gc=none | ||
to the configure command. In the mono directory I build mono as: | ||
./configure --with-gc=none | ||
|
||
In the WINELib makefile you may have set these to the appropriate files and/or | ||
paths on your PC: | ||
|
||
X11R6_INCLUDE=/usr/X11R6/include | ||
WINE_INCLUDE=/usr/local/include/wine | ||
WINE_LIB=/usr/local/lib/wine | ||
LIBMONO=/usr/local/lib/libmono.a | ||
|
||
If you type make from the mcs/class/System.Windows.Forms/WINELib | ||
directory it should build: | ||
|
||
System.Windows.Forms.dll - | ||
The current (if largely incomplete) Windows Forms package. | ||
|
||
FormTest.exe, NativeWindowTest.exe, Test.exe - | ||
Test applications which link to and tests the System.Windows.Forms.dll | ||
|
||
monostub.exe.so - | ||
The WineLib application that starts the Mono/WineLib application. This | ||
small WineLib application embeds the Mono JIT engine allowing any Mono | ||
application running in it access to WineLib/Win32 function calls. | ||
|
||
Before starting any of the applications set the LD_LIBRARY_PATH to the | ||
current directory (so DllImport can find the monostub.exe.so library): | ||
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:. | ||
|
||
To start any of the applications you type (from the WINELib directory): | ||
wine monostub.exe.so mono-winelibapp.exe | ||
|
||
|
||
|
51 changes: 0 additions & 51 deletions
51
mcs/class/System.Windows.Forms/System.Windows.Forms/README
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters