GtkSharp/sources

The contents of this directory are (basically) the first step
in creating .NET bindings, to libraries based on GObject.

WHO USES THE SOURCES DIRECTORY
------------------------------

    This directory is essentially the starting point in the creation
    of a .NET binding. Most people can safely ignore it. (If all
    you want to do is build Gtk#, then you can ignore what's in this
    directory.)

    This directory is not part of the normal build process for Gtk#.
    But is instead used by people wishing to update an existing .NET
    binding; or to create a new .NET binding (for a GObject based library).

    The result of running "make api" on this directory (once everything
    is set up) are the various '*-api.raw' XML files that you find in the
    corresponding directories. Those XML files will then be used to generate
    the C# code. And then that C# code is used to create the various .DLL
    files.

    Please refer to http://www.mono-project.com/GAPI for a more complete and
    up-to-date guide to this process.


WHAT'S REQUIRED
---------------

    Before you can do anything here, you need to get the source
    code to the various libraries (which you are generating .NET
    bindings for). And then do a little configuring. The current
    list of libraries that Gtk# supports is in the sources.xml and Makefile.am
    files.

    If you create a new binding that is part of Gtk#, be sure to add it to this
    list.

    There are two ways to get this source code, as you will see in the
    next section.


SETTING THINGS UP
-----------------

    To set things up, you need to get the source code to the libraries listed
    above. There are two (alternate) methods of doing this.

        Method 1)
            Download and unpack the source code manually.

        Method 2)
            Run:
                make get-source-code

    (Method 2 is probably the easiest way to do it for most people. It
    automatically goes and downloads everything you need, and sets everything
    up for you.)

    For more information, please refer to http://www.mono-project.com/GAPI