.NET wrapper for Gtk and other related libraries
Go to file
Bertrand Lorentz 7180011c22 Add and use gapi.xsd to validate GAPI XML files
The structure of a GAPI XML file is now defined by the XML schema in
gapi.xsd.

This XSD is now used by the generator to do a first sanity check on an
XML file before trying to generate code from it. Each generatable object
still does its own validation.

The XSD can also be seen as a documentation of the GAPI XML format, and
can be used by third-parties that produce GAPI XML to validate their
output.
2013-02-23 14:32:04 +01:00
atk Add a MonoDevelop solution and projects for browsing the codebase 2012-10-13 16:44:10 +02:00
audit 2008-12-12 Mike Kestner <mkestner@novell.com> 2008-12-12 16:10:15 +00:00
cairo cairo: Fix rectangles returned by StrokeExtents and FillExtents methods 2012-12-27 15:26:42 +01:00
doc doc: Run the automatic documentation updater 2012-08-05 20:06:32 +02:00
gdk Remove obsolete fix-ups for needs_ref attribute 2013-02-23 13:41:50 +01:00
generator generator: Add option to validate GAPI XML against an XSD schema 2013-02-23 13:41:50 +01:00
gio gio: Rename the DBus.Address* methods 2012-11-18 12:22:17 +01:00
glib glib: Fix crash when freeing lists with elements typed as interfaces 2012-11-18 16:06:34 +01:00
gtk Remove obsolete fix-ups for needs_ref attribute 2013-02-23 13:41:50 +01:00
gtkdotnet gtkdotnet: Fixed P/Invokes and Dllmap to use GDK 3.0 instead of 2.0 2012-10-02 17:20:45 +02:00
pango pango: Remove invalid fix-up for pango_layout_get_lines_readonly 2013-02-23 13:41:50 +01:00
parser Add support for class const fields 2011-09-26 13:52:12 +02:00
sample Add and use gapi.xsd to validate GAPI XML files 2013-02-23 14:32:04 +01:00
sources Update various bits of documentation in READMEs and HACKING 2012-10-14 15:22:47 +02:00
.gitignore Add *.pidb and *.userprefs to .gitignore 2012-10-13 16:44:18 +02:00
AssemblyInfo.cs.in Remove ClassInitializer attributes. 2011-02-09 10:05:40 -06:00
AUTHORS Update AUTHORS 2012-10-21 14:27:59 +02:00
autogen.sh build: Remove inexisting configure options from autogen.sh 2012-10-14 16:10:30 +02:00
ChangeLog.old Archive Changelog as Changelog.old 2012-10-14 16:10:05 +02:00
configure.ac build: Belated post-release version bump to 2.99.1 2012-11-04 18:25:40 +01:00
COPYING Replaced COPYING with LGPL2-only license 2012-11-17 23:24:56 +01:00
gapi.xsd Add and use gapi.xsd to validate GAPI XML files 2013-02-23 14:32:04 +01:00
gtk-sharp-2.0-dev.wxs.in 2008-10-13 Brad Taylor <brad@getcoded.net> 2008-10-13 16:36:33 +00:00
gtk-sharp-2.0-lib.wxs.in 2008-10-13 Brad Taylor <brad@getcoded.net> 2008-10-13 16:36:33 +00:00
gtk-sharp.sln Fix indentation configured in gtk-sharp.sln 2012-10-21 18:22:13 +02:00
gtk-sharp.snk Add gtk-sharp.snk 2004-06-08 17:32:50 +00:00
HACKING Update various bits of documentation in READMEs and HACKING 2012-10-14 15:22:47 +02:00
Makefile.am Add and use gapi.xsd to validate GAPI XML files 2013-02-23 14:32:04 +01:00
Makefile.include Add and use gapi.xsd to validate GAPI XML files 2013-02-23 14:32:04 +01:00
NEWS release: Small changes to NEWS 2012-10-23 18:58:53 +02:00
policy.config.in 2005-09-21 Mike Kestner <mkestner@novell.com> 2005-09-22 04:26:52 +00:00
README gui-thread-check: Merge README with gtk-sharp's 2012-11-04 00:42:01 +00:00
README.generator silly typo 2006-04-16 02:43:41 +00:00
TODO Update TODO 2012-10-14 15:11:43 +02:00

The Gtk# website can be found at: http://www.mono-project.com/GtkSharp

Gtk# is a .NET language binding for the GTK+ toolkit and assorted GNOME
libraries. Gtk# is free software, licensed under the GNU LGPL.

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

    Install the gtk-3 development headers first. On Debian, this can be done using:
    apt-get install libgtk-3-dev

    The 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 GIT, you will need libtool and the auto* tools
    and will need to replace the configure above with autogen.sh.


The gui-thread-check profiler module.
-------------------------------------

    Since version 3 of gtk# a profiler called "gui-thread-check" is included as
    part of the install for debugging purposes. (It's located in the subfolder
    gtk/gui-thread-check .)

    This profiler module can be used to check if a GTK# application is trying to
    invoke gtk or gdk methods from a thread which is not the main GUI thread.

    To use it, run your application with the command:

        mono --profile=gui-thread-check yourapp.exe

    If the profiler is properly installed, you'll see an output like this:

        *** Running with gui-thread-check ***
        *** GUI THREAD INITIALIZED: 2861676352

    While the application is running, if the profiler detects a non-gui thread
    invoking gtk methods, it will print a warning message together with a
    stack trace. For example:

        *** GTK CALL NOT IN GUI THREAD: Widget.gtk_widget_get_parent
           Widget.get_Parent
           SourceEditorWidget.SetLastActiveEditor
           SourceEditorWidget.get_TextEditor
           SourceEditorWidget.get_Document
           SourceEditorWidget.HandleParseInformationUpdaterWorkerThreadDoWork
           BackgroundWorker.OnDoWork
           BackgroundWorker.ProcessWorker


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/

    Also, people can get help with and discuss Gtk# on IRC via the
    #gtk# or #mono channels 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.mono-project.com/Monkeyguide


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 #gtk# IRC channel (on irc.gnome.org).