GtkSharp/README

The Gtk# website can be found at: http://gtk-sharp.sourceforge.net/

Gtk# is a .NET language binding for the GTK+ toolkit and assorted GNOME
libraries.  Gtk# is free software, licensed under the GNU LGPL.  The target
is the 2.2 platform, and no plans are currently in place to backport to 1.2.

The effort essentially boils down to an exercise in PInvoke against the C
dynamic libraries.  It may end up being slow as hell, but we'll see when we get 
there and adjust accordingly.

Building & Installing Gtk#:
---------------------------

    To compile Gtk# on Win32 using the .NET framework compiler and libraries,
    in the top level directory, type:

        make -f makefile.win32

    The Linux build is the traditional:

        ./configure
        make
        make install

    You may want to consider using configure's prefix option to install
    Gtk# using the same prefix as Mono.  That way all of your .NET assemblies
    get placed in the same place, and you don't need to do any extra "configuring"
    to make it so mono (and mint) can find your assemblies.  In other words,
    doing something like:

        ./configure --prefix=/the/path/that/was/used/for/mono
        make
        make install

    (Of course, replace "/the/path/that/was/used/for/mono" with whatever path
    which was used for Mono.  This might have been "/usr", "/usr/local", or
    something similar.)

    If you are compiling from CVS, you will need libtool and the auto* tools
    and will need to replace the configure above with autogen.sh.


Discussion & Support:
---------------------

    A mailing list for Gtk# discussion is available.

    You can subscribe to the mailing list by visiting:

        http://lists.ximian.com/mailman/listinfo/gtk-sharp-list

    And following the instructions (on that page) to subscribe.
    Messages are posted on this mailing list by sending them to:

        gtk-sharp-list@ximian.com

    (The mailing list requires you to subscribe in order to post
    messages.)

    An archive of this mailing list can be found at:

        http://lists.ximian.com/archives/public/gtk-sharp-list/

    Further, a Wiki is available for Gtk#, and can be found at:

        http://www.nullenvoid.com/gtksharp/wiki/

    Also, people can get help with and discuss Gtk# on IRC via the
    #mono channel on the irc.gnome.org IRC server.

    People looking for general help with C# should visit the
    #c# channel on irc.freenode.net IRC server.


Developers:
-----------

    For developers wishing to "get started" with Gtk#, they are encouraged
    to read the Mono Hand Book:

        http://www.go-mono.com/tutorial

    In the Mono Hand Book, Chapter 21 is on Gtk#.  (In the Mono Hand Book,
    the Gtk# .NET bindings are refered to as GNOME.NET.)


Hackers:
--------

    For those who wish to help with the development of Gtk#, they should
    read the file named: HACKING.

    Also, anyone wishing to hack Gtk# is encouraged to join the Gtk#
    mailing list.  And to visit the #mono IRC channel (on irc.gnome.org).