merge -r 58741:59263
[mono.git] / web / gtk-sharp
index dc075765c2ac0f83ce9734ff0315526491c65095..0100f66732732078e93fbd055e16cb70782377b5 100644 (file)
        <a href="http://gtk-sharp.sourceforge.net">Gtk#</a> (Gtk
        sharp) is a set of C# language bindings for the
        <a href="http://www.gtk.org">Gtk+</a> toolkit and other
-       libraries that are part of the <a
-       href="http://www.gnome.org">GNOME</a> platform . 
+       libraries that are part of the 
+       <a href="http://www.gnome.org">GNOME</a> platform . 
+
+* Wiki
+
+       There is a <a
+       href="http://www.nullenvoid.com/gtksharp/wiki/index.php/">Gtk#
+       Wiki</a>.  You are encouraged to contribute to it.
 
 ** API of Gtk#
 
-       The API is browsable 
-       <a
-       href="http://primates.ximian.com/~tvgm/gtk-sharp-docs/">here</a>
+       The Gtk# API is documented using the ECMA XML document format, you can read
+       more about it <a href="documentation.html">here</a>.  You can
+       also use the MonoDoc tool that ships with Gtk# documentation.
 
 ** Where to learn more.
 
-       Visit the official site for the <a
-       href="http://gtk-sharp.sourceforge.net">Gtk# Project</a>.
-       The <a href="http://www.go-mono.org/faq">Mono FAQ</a> has some useful
+       Visit the official site for the <a href="http://gtk-sharp.sourceforge.net">Gtk# Project</a>.
+       The <a href="http://www.go-mono.org/faq.html">Mono FAQ</a> has some useful
        information too.
+       
+** GTK# On Linux
+
+<p>Where to get distributions of GTK# for Linux: 
+       <ul>
+               <li><a href="http://gtk-sharp.sourceforge.net">RPMs</a></li>
+               <li><a href="http://www.debianplanet.org/mono/">Debs</a></li>
+       </ul>
+
+<p>Buidling on Linux:
+
+<ul>
+       <li>Get GTK# source from <a href="http://gtk-sharp.sourceforge.net">Gtk# Project</a>.</li>
+       <li>run ./autogen.sh --prefix=my_mono_installation_prefix</li>
+       <li>make</li>
+       <li>make install</li>
+</ul> 
+
+** GTK# On Windows
+
+<p>Look at our Wiki for installation instructions <a href="http://www.nullenvoid.com/gtksharp/wiki/index.php/InstallingBeginnersGuide">here</a>
+
 
+<p>If you want to build GTK# yourself on Windows:\r
+\r
+<p>To build gtk# under windows, you will need the following:\r
+\r
+<ul>\r
+ <li>cygwin from <a href="http://www.cygwin.com/">here</a>  When installing Cygwin via setup.exe, \r
+   by default binutils and other tools do not get installed; you have to make \r
+   sure to select these items.  Just make\r
+   sure Base and Development are set to Install.</li>\r
+ <li>Mono 0.17 or later from <a href="http://www.go-mono.com/download.html">here</a>\r
+  You can use Windows Setup Wizard (NT/2000/XP).</li>\r
+ <li>GTK+ 2.0 (and dependencies).  You can obtain gtk+ 2.0 by either of the\r
+following:\r
+       <ul>\r
+               <li>You can get a Windows Installer at:\r
+                 <a href="http://www.dropline.net/gtk/download.php">here</a> </li>\r
+               <li>or get the separate binary and dev/lib packages at\r
+           at <a href="http://www.gimp.org/~tml/gimp/win32/downloads.html">here</a> </li>\r
+        <li>or binary package from Dev-C++ site <a href="http://www.bloodshed.net/dev/packages/gtk.html">here</a> </li>\r
+               <li>or get Gtk4Win <a href="http://wingtk.sourceforge.net/index.html">here</a> </li>\r
+               <li>or the source at <a href="http://www.gtk.org/">here</a> </li>\r
+     </ul>\r
+  </li>\r
+ <li>binary distriubtion of a current web browser\r
+  like Internet Explorer 4.0, Mozilla 1.0, or Netscape 7.0 which\r
+  includes things like msvcrt.dll.</li>\r
+ <li>Microsoft .NET Framework at\r
+  <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
+\r
+\r
+<p>Environment Variables to set:\r
+<ul>\r
+<li>PATH - set to your mono installation bin and lib path.\r
+  For example, my mono installation prefix is:\r
+<pre>\r
+F:/cygwin/home/DanielMorgan/mono/install\r
+</pre>\r
+  <p>So, I would set my PATH in the Windows Control Panel as:\r
+<pre>\r
+F:/cygwin/home/DanielMorgan/mono/install/bin;F:/cygwin/home/DanielMorgan/mono/install/lib</li>\r
+</pre>\r
+</li>\r
+<li>LD_LIBRARY_PATH - set to your mono installation lib path</li>\r
+<li>PKG_CONFIG_PATH - set to your mono installation lib/pkgconfig path, such\r
+ as,\r
+<pre>\r
+  F:/cygwin/home/DanielMorgan/mono/install/lib/pkgconfig</li>\r
+</pre>\r
+\r
+ <p>If you got the gtk-sharp source, cd to the gtk-sharp directory, type:\r
+<pre>\r
+ ./autogen.sh --prefix=~/mono/install\r
+</pre>\r
+\r
+ <p>Set your --prefix= to whatever your mono installation prefix is located.\r
+ This will take awhile to go through the ./autogen.sh and ./configure...\r
+\r
+ <p>After that it finishes succesfully, you run make with the makefile.win32\r
+ like:\r
+<pre>\r
+ make -f makefile.win32\r
+</pre>\r
+\r
+ <p>After that finishes succesfully, you can copy to your mono installation lib\r
+ path like:\r
+<pre>\r
+ cp */*.dll ~/mono/install/lib\r
+</pre>\r
+</ul>\r
+\r
+<p>The pkg-config files for\r
+gtk+ 2.0 and dependencies will need to be set correctly if they haven't\r
+already been.\r
+\r
+<p>Look in your mono installation/lib/pkgconfig, such as,\r
+<pre>\r
+F:/cygwin/home/DanielMorgan/mono/install/lib/pkgconfig\r
+</pre>\r
+\r
+<p>You will find files like: gtk+-2.0.pc\r
+\r
+<p>Edit the line that says\r
+\r
+<pre>\r
+ prefix=something\r
+</pre>\r
+\r
+<p>And set it to your mono installation prefix, such as,\r
+\r
+<pre>\r
+ prefix=F:/cygwin/home/DanielMorgan/mono/install\r
+</pre>\r
+\r
+<p>Do this for all the .pc files in that directory.  If there are not any, then\r
+you will need to create them.  Or get them from somewhere like the dev\r
+packages at\r
+<a href="http://www.gimp.org/~tml/gimp/win32/downloads.html">here</a>\r
+\r
+** GTK# On FreeBSD\r
+\r
+ TODO.  Any volunteers?\r
+\r
+** GTK# On Solaris\r
+\r
+ TODO.  Any volunteers?\r
+\r
+** GTK# On AIX\r
+\r
+ TODO.  Any volunteers?\r