2003-04-22 Gaurav Vaish <gvaish_mono.nospam@nospam.lycos.com>
[mono.git] / web / gtk-sharp
1 * Gtk#
2
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 . 
8
9 * Wiki
10
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.
14
15 ** API of Gtk#
16
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.
20
21 ** Where to learn more.
22
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">Mono FAQ</a> has some useful
25         information too.
26         
27 ** GTK# On Linux
28
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>
34
35 <p>Buidling on Linux:
36
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> 
43
44 ** GTK# On Windows
45
46 <p>There is a Windows Installer for GTK# <a href="http://www.sport-huettn.de/mono/gtk-sharp-0.6-stable-2.exe">here</a>.\r
47
48 <p>If you want to build GTK# yourself on Windows:\r
49 \r
50 <p>To build gtk# under windows, you will need the following:\r
51 \r
52 <ul>\r
53  <li>cygwin from <a href="http://www.cygwin.com/">here</a>  When installing Cygwin via setup.exe, \r
54    by default binutils and other tools do not get installed; you have to make \r
55    sure to select these items.  Just make\r
56    sure Base and Development are set to Install.</li>\r
57  <li>Mono 0.17 or later from <a href="http://www.go-mono.com/download.html">here</a>\r
58   You can use Windows Setup Wizard (NT/2000/XP).</li>\r
59  <li>GTK+ 2.0 (and dependencies).  You can obtain gtk+ 2.0 by either of the\r
60 following:\r
61         <ul>\r
62                 <li>You can get a Windows Installer at:\r
63           <a href="http://www.dropline.net/jade/download.html">here</a> </li>\r
64                 <li>or get the separate binary and dev/lib packages at\r
65            at <a href="http://www.gimp.org/~tml/gimp/win32/downloads.html">here</a> </li>\r
66         <li>or binary package from Dev-C++ site <a href="http://www.bloodshed.net/dev/packages/gtk.html">here</a> </li>\r
67                 <li>or get Gtk4Win <a href="http://wingtk.sourceforge.net/index.html">here</a> </li>\r
68                 <li>or the source at <a href="http://www.gtk.org/">here</a> </li>\r
69      </ul>\r
70   </li>\r
71  <li>binary distriubtion of a current web browser\r
72   like Internet Explorer 4.0, Mozilla 1.0, or Netscape 7.0 which\r
73   includes things like msvcrt.dll.</li>\r
74  <li>Microsoft .NET Framework at\r
75   <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
76 \r
77 <p>If you are running Windows 95/98/ME, then you will need Unicode support.\r
78 Look in\r
79 mono-list archives for information about how to get\r
80 Mono to work on Windows 9x.\r
81 <a href="http://lists.ximian.com/archives/public/mono-list/2002-December/004158.html">here</a>\r
82 \r
83 <p>Environment Variables to set:\r
84 <ul>\r
85 <li>PATH - set to your mono installation bin and lib path.\r
86   For example, my mono installation prefix is:\r
87 <pre>\r
88 F:/cygwin/home/DanielMorgan/mono/install\r
89 </pre>\r
90   <p>So, I would set my PATH in the Windows Control Panel as:\r
91 <pre>\r
92 F:/cygwin/home/DanielMorgan/mono/install/bin;F:/cygwin/home/DanielMorgan/mono/install/lib</li>\r
93 </pre>\r
94 </li>\r
95 <li>LD_LIBRARY_PATH - set to your mono installation lib path</li>\r
96 <li>PKG_CONFIG_PATH - set to your mono installation lib/pkgconfig path, such\r
97  as,\r
98 <pre>\r
99   F:/cygwin/home/DanielMorgan/mono/install/lib/pkgconfig</li>\r
100 </pre>\r
101 \r
102  <p>If you got the gtk-sharp source, cd to the gtk-sharp directory, type:\r
103 <pre>\r
104  ./autogen.sh --prefix=~/mono/install\r
105 </pre>\r
106 \r
107  <p>Set your --prefix= to whatever your mono installation prefix is located.\r
108  This will take awhile to go through the ./autogen.sh and ./configure...\r
109 \r
110  <p>After that it finishes succesfully, you run make with the makefile.win32\r
111  like:\r
112 <pre>\r
113  make -f makefile.win32\r
114 </pre>\r
115 \r
116  <p>After that finishes succesfully, you can copy to your mono installation lib\r
117  path like:\r
118 <pre>\r
119  cp */*.dll ~/mono/install/lib\r
120 </pre>\r
121 </ul>\r
122 \r
123 <p>The pkg-config files for\r
124 gtk+ 2.0 and dependencies will need to be set correctly if they haven't\r
125 already been.\r
126 \r
127 <p>Look in your mono installation/lib/pkgconfig, such as,\r
128 <pre>\r
129 F:/cygwin/home/DanielMorgan/mono/install/lib/pkgconfig\r
130 </pre>\r
131 \r
132 <p>You will find files like: gtk+-2.0.pc\r
133 \r
134 <p>Edit the line that says\r
135 \r
136 <pre>\r
137  prefix=something\r
138 </pre>\r
139 \r
140 <p>And set it to your mono installation prefix, such as,\r
141 \r
142 <pre>\r
143  prefix=F:/cygwin/home/DanielMorgan/mono/install\r
144 </pre>\r
145 \r
146 <p>Do this for all the .pc files in that directory.  If there are not any, then\r
147 you will need to create them.  Or get them from somewhere like the dev\r
148 packages at\r
149 <a href="http://www.gimp.org/~tml/gimp/win32/downloads.html">here</a>\r
150 \r
151 ** GTK# On FreeBSD\r
152 \r
153  TODO.  Any volunteers?\r
154 \r
155 ** GTK# On Solaris\r
156 \r
157  TODO.  Any volunteers?\r
158 \r
159 ** GTK# On AIX\r
160 \r
161  TODO.  Any volunteers?\r