gtk2/docs/reference/gtk/resources.sgml
Havoc Pennington ecc13fb5a5 remove CellRendererTextPixbuf
2001-09-08  Havoc Pennington  <hp@pobox.com>

	* gtk/gtk-docs.sgml: remove CellRendererTextPixbuf

	* gtk/resources.sgml: add section on mailing lists, bugzilla, etc.

	* gtk/tmpl/gtkaccelgroup.sgml: add long description

	* gtk/gtk-sections.txt: reorder accel group section; probably need
	to delete most of it

	* gtk/tmpl/gtkmain.sgml: Clean it up a little bit

	* gtk/gtk-docs.sgml: rearrange the list of "core/misc" sections so
	that useful things are near the top and stupid junk is near the
	bottom.

	* gtk/tmpl/gtkfeatures.sgml: fix/finish this section

	* gtk/gtk-docs.sgml: create a separate section for
	overview/tutorial material and special notes, and put the
	reference docs for the "misc non-widget" stuff into its own
	section.

	* gtk/compiling.sgml: write this section

	* gtk/gtk-docs.sgml: The intro section weirdly had two paragraphs
	that said the same thing. Delete one of them.
2001-09-08 04:39:53 +00:00

128 lines
3.8 KiB
Plaintext

<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+, please
file a bug report on http://bugzilla.gnome.org. 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 "diff" utility, using the "-u" 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
gtk-devel-list@gnome.org. 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 http://mail.gnome.org.
</para>
<para>
<variablelist>
<varlistentry>
<term>gtk-list@gnome.org</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>gtk-app-devel-list@gnome.org</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>gtk-devel-list@gnome.org</term>
<listitem><para>
gtk-devel-list is for discussion of work on GTK+ itself, it is NOT 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>gtk-i18n-list@gnome.org</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>gtk-doc-list@gnome.org</term>
<listitem><para>
gtk-doc-list is for discussion of the gtk-doc documentation system
(used to document GTK+), and for work on the GTK+ documentation.
</para></listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
</refentry>