<refentry id="gtk-resources" revision="5 Sept 2001"><refmeta><refentrytitle>Mailing lists and bug reports</refentrytitle><manvolnum>3</manvolnum><refmiscinfo>Mailing lists and bug reports</refmiscinfo></refmeta><refnamediv><refname>Mailing lists and bug reports</refname><refpurpose>Getting help with GTK+</refpurpose></refnamediv><refsect1><title>Filing a bug report or feature request</title><para>If you encounter a bug, misfeature, or missing feature in GTK+, pleasefile a bug report on <ulink url="http://bugzilla.gnome.org">http://bugzilla.gnome.org</ulink>. We'd also appreciate reports of incomplete or misleading information in the GTK+ documentation; file those against the "docs" component of the "gtk+"product in Bugzilla.</para><para>Don't hesitate to file a bug report, even if you think we may knowabout it already, or aren't sure of the details. Just give us as muchinformation as you have, and if it's already fixed or has already beendiscussed, we'll add a note to that effect in the report.</para><para>The bug tracker should definitely be used for feature requests, it'snot only for bugs. We track all GTK+ development in Bugzilla, so it'sthe way to be sure the GTK+ developers won't forget about an issue.</para></refsect1><refsect1><title>Submitting Patches</title><para>If you develop a bugfix or enhancement for GTK+, please file that inBugzilla as well. Bugzilla allows you to attach files; please attach apatch generated by the <command>diff</command> utility, using the <option>-u</option> option to make the patch more readable. All patches must be offered under the terms of the GNU LGPL license, so be sure you are authorized to give us the patch under those terms.</para><para>If you want to discuss your patch before or after developing it, mail <ulink url="mailto:gtk-devel-list@gnome.org">gtk-devel-list@gnome.org</ulink>. But be sure to file the Bugzilla report as well; if the patch is only on the list and not in Bugzilla, it's likely to slip through the cracks.</para></refsect1><refsect1><title>Mailing lists</title><para>There are several mailing lists dedicated to GTK+ and relatedlibraries. Discussion of GLib, Pango, and ATK in addition to GTK+proper is welcome on these lists. You can subscribe or view thearchives of these lists on <ulink url="http://mail.gnome.org">http://mail.gnome.org</ulink>.If you aren't subscribed to the list, any message you post tothe list will be held for manual moderation, which might takesome days to happen.      </para><para><variablelist><varlistentry><term><ulink url="mailto:gtk-list@gnome.org">gtk-list@gnome.org</ulink></term><listitem><para>gtk-list covers general GTK+ topics; questions about using GTK+ in programs,GTK+ from a user standpoint, announcements of GTK+-related projectssuch as themes or GTK+ modules would all be on-topic. The bulk of thetraffic consists of GTK+ programming questions.</para></listitem></varlistentry><varlistentry><term><ulink url="mailto:gtk-app-devel-list@gnome.org">gtk-app-devel-list@gnome.org</ulink></term> <listitem><para>gtk-app-devel-list covers writing applications in GTK+. It's narrowerin scope than gtk-list, but the two lists overlap quite abit. gtk-app-devel-list is a good place to ask questions about GTK+programming.  </para></listitem></varlistentry><varlistentry><term><ulink url="mailto:gtk-devel-list@gnome.org">gtk-devel-list@gnome.org</ulink></term><listitem><para>gtk-devel-list is for discussion of work on GTK+ itself, it is <emphasis>not</emphasis> forasking questions about how to use GTK+ in applications. gtk-devel-list is appropriate for discussion of patches, bugs, proposed features, and so on.</para></listitem></varlistentry><varlistentry><term><ulink url="mailto:gtk-i18n-list@gnome.org">gtk-i18n-list@gnome.org</ulink></term><listitem><para>gtk-i18n-list is for discussion of internationalization in GTK+; Pango is the main focus of the list. Questions about the details of using Pango, and discussion of proposed Pango patches or features, areall on topic.</para></listitem></varlistentry><varlistentry><term><ulink url="mailto:gtk-doc-list@gnome.org">gtk-doc-list@gnome.org</ulink></term><listitem><para>gtk-doc-list is for discussion of the <application>gtk-doc</application> documentation system (used to document GTK+), and for work on the GTK+ documentation.</para></listitem></varlistentry></variablelist></para></refsect1></refentry>