.NET wrapper for Gtk and other related libraries
Find a file
2017-09-06 13:16:56 -03:00
Source Ignore warnings on generated glue code 2017-09-06 13:16:56 -03:00
.gitattributes Add a .gitattributes file to have git keep CRLF endings in *.sln files 2015-05-25 17:03:31 +02:00
.gitignore Add meson build definitions (#30) 2017-08-24 15:21:41 +02:00
AUTHORS Quick Reorganization 2017-09-04 22:36:28 -03:00
GENERATOR.md Quick Reorganization 2017-09-04 22:36:28 -03:00
LICENSE Quick Reorganization 2017-09-04 22:36:28 -03:00
meson.build meson: Require meson 0.43 or higher 2017-09-06 13:11:31 -03:00
meson_options.txt Add a meson.build file in the toplevel folder 2017-09-04 22:40:02 -03:00
README.md Quick Reorganization 2017-09-04 22:36:28 -03: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=`pkg-config --variable=prefix mono`
    make
    make install

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/docs/gui/gtksharp/

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).