forked from AuroraMiddleware/gtk
140 lines
4.6 KiB
XML
140 lines
4.6 KiB
XML
<?xml version="1.0"?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
|
]>
|
|
<refentry id="gtk-resources">
|
|
<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+, please
|
|
file a bug report on
|
|
<ulink url="https://bugzilla.gnome.org">https://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 know
|
|
about it already, or aren't sure of the details. Just give us as much
|
|
information as you have, and if it's already fixed or has already been
|
|
discussed, we'll add a note to that effect in the report.
|
|
</para>
|
|
|
|
<para>
|
|
The bug tracker should definitely be used for feature requests, it's
|
|
not only for bugs. We track all GTK+ development in Bugzilla, so it's
|
|
the 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 in
|
|
Bugzilla as well. Bugzilla allows you to attach files; please attach a
|
|
patch 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 related
|
|
libraries. Discussion of GLib, Pango, and ATK in addition to GTK+
|
|
proper is welcome on these lists. You can subscribe or view the
|
|
archives of these lists on
|
|
<ulink url="https://mail.gnome.org">http://mail.gnome.org</ulink>.
|
|
If you aren't subscribed to the list, any message you post to
|
|
the list will be held for manual moderation, which might take
|
|
some 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 projects
|
|
such as themes or GTK+ modules would all be on-topic. The bulk of the
|
|
traffic 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 narrower
|
|
in scope than gtk-list, but the two lists overlap quite a
|
|
bit. 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> for
|
|
asking 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, are
|
|
all 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>
|