2010-05-05 Rodrigo Kumpera <rkumpera@novell.com>
[mono.git] / web / gtk-sharp
blob0100f66732732078e93fbd055e16cb70782377b5
1 * Gtk#
3         <a href="http://gtk-sharp.sourceforge.net">Gtk#</a> (Gtk
4         sharp) is a set of C# language bindings for the
5         <a href="http://www.gtk.org">Gtk+</a> toolkit and other
6         libraries that are part of the 
7         <a href="http://www.gnome.org">GNOME</a> platform . 
9 * Wiki
11         There is a <a
12         href="http://www.nullenvoid.com/gtksharp/wiki/index.php/">Gtk#
13         Wiki</a>.  You are encouraged to contribute to it.
15 ** API of Gtk#
17         The Gtk# API is documented using the ECMA XML document format, you can read
18         more about it <a href="documentation.html">here</a>.  You can
19         also use the MonoDoc tool that ships with Gtk# documentation.
21 ** Where to learn more.
23         Visit the official site for the <a href="http://gtk-sharp.sourceforge.net">Gtk# Project</a>.
24         The <a href="http://www.go-mono.org/faq.html">Mono FAQ</a> has some useful
25         information too.
26         
27 ** GTK# On Linux
29 <p>Where to get distributions of GTK# for Linux: 
30         <ul>
31                 <li><a href="http://gtk-sharp.sourceforge.net">RPMs</a></li>
32                 <li><a href="http://www.debianplanet.org/mono/">Debs</a></li>
33         </ul>
35 <p>Buidling on Linux:
37 <ul>
38         <li>Get GTK# source from <a href="http://gtk-sharp.sourceforge.net">Gtk# Project</a>.</li>
39         <li>run ./autogen.sh --prefix=my_mono_installation_prefix</li>
40         <li>make</li>
41         <li>make install</li>
42 </ul> 
44 ** GTK# On Windows
46 <p>Look at our Wiki for installation instructions <a href="http://www.nullenvoid.com/gtksharp/wiki/index.php/InstallingBeginnersGuide">here</a>
49 <p>If you want to build GTK# yourself on Windows:\r
51 <p>To build gtk# under windows, you will need the following:\r
53 <ul>\r
54  <li>cygwin from <a href="http://www.cygwin.com/">here</a>  When installing Cygwin via setup.exe, \r
55    by default binutils and other tools do not get installed; you have to make \r
56    sure to select these items.  Just make\r
57    sure Base and Development are set to Install.</li>\r
58  <li>Mono 0.17 or later from <a href="http://www.go-mono.com/download.html">here</a>\r
59   You can use Windows Setup Wizard (NT/2000/XP).</li>\r
60  <li>GTK+ 2.0 (and dependencies).  You can obtain gtk+ 2.0 by either of the\r
61 following:\r
62         <ul>\r
63                 <li>You can get a Windows Installer at:\r
64                   <a href="http://www.dropline.net/gtk/download.php">here</a> </li>\r
65                 <li>or get the separate binary and dev/lib packages at\r
66            at <a href="http://www.gimp.org/~tml/gimp/win32/downloads.html">here</a> </li>\r
67         <li>or binary package from Dev-C++ site <a href="http://www.bloodshed.net/dev/packages/gtk.html">here</a> </li>\r
68                 <li>or get Gtk4Win <a href="http://wingtk.sourceforge.net/index.html">here</a> </li>\r
69                 <li>or the source at <a href="http://www.gtk.org/">here</a> </li>\r
70      </ul>\r
71   </li>\r
72  <li>binary distriubtion of a current web browser\r
73   like Internet Explorer 4.0, Mozilla 1.0, or Netscape 7.0 which\r
74   includes things like msvcrt.dll.</li>\r
75  <li>Microsoft .NET Framework at\r
76   <a href="http://msdn.microsoft.com/downloads/default.asp?url=/downloads/sample.asp?url=/msdn-files/027/000/976/msdncompositedoc.xml&frame=true">here</a> </li>\r
79 <p>Environment Variables to set:\r
80 <ul>\r
81 <li>PATH - set to your mono installation bin and lib path.\r
82   For example, my mono installation prefix is:\r
83 <pre>\r
84 F:/cygwin/home/DanielMorgan/mono/install\r
85 </pre>\r
86   <p>So, I would set my PATH in the Windows Control Panel as:\r
87 <pre>\r
88 F:/cygwin/home/DanielMorgan/mono/install/bin;F:/cygwin/home/DanielMorgan/mono/install/lib</li>\r
89 </pre>\r
90 </li>\r
91 <li>LD_LIBRARY_PATH - set to your mono installation lib path</li>\r
92 <li>PKG_CONFIG_PATH - set to your mono installation lib/pkgconfig path, such\r
93  as,\r
94 <pre>\r
95   F:/cygwin/home/DanielMorgan/mono/install/lib/pkgconfig</li>\r
96 </pre>\r
98  <p>If you got the gtk-sharp source, cd to the gtk-sharp directory, type:\r
99 <pre>\r
100  ./autogen.sh --prefix=~/mono/install\r
101 </pre>\r
103  <p>Set your --prefix= to whatever your mono installation prefix is located.\r
104  This will take awhile to go through the ./autogen.sh and ./configure...\r
106  <p>After that it finishes succesfully, you run make with the makefile.win32\r
107  like:\r
108 <pre>\r
109  make -f makefile.win32\r
110 </pre>\r
112  <p>After that finishes succesfully, you can copy to your mono installation lib\r
113  path like:\r
114 <pre>\r
115  cp */*.dll ~/mono/install/lib\r
116 </pre>\r
117 </ul>\r
119 <p>The pkg-config files for\r
120 gtk+ 2.0 and dependencies will need to be set correctly if they haven't\r
121 already been.\r
123 <p>Look in your mono installation/lib/pkgconfig, such as,\r
124 <pre>\r
125 F:/cygwin/home/DanielMorgan/mono/install/lib/pkgconfig\r
126 </pre>\r
128 <p>You will find files like: gtk+-2.0.pc\r
130 <p>Edit the line that says\r
132 <pre>\r
133  prefix=something\r
134 </pre>\r
136 <p>And set it to your mono installation prefix, such as,\r
138 <pre>\r
139  prefix=F:/cygwin/home/DanielMorgan/mono/install\r
140 </pre>\r
142 <p>Do this for all the .pc files in that directory.  If there are not any, then\r
143 you will need to create them.  Or get them from somewhere like the dev\r
144 packages at\r
145 <a href="http://www.gimp.org/~tml/gimp/win32/downloads.html">here</a>\r
147 ** GTK# On FreeBSD\r
149  TODO.  Any volunteers?\r
151 ** GTK# On Solaris\r
153  TODO.  Any volunteers?\r
155 ** GTK# On AIX\r
157  TODO.  Any volunteers?\r