2001-09-08 04:39:53 +00:00
|
|
|
<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
|
Markup fixes.
* gdk-pixbuf/tmpl/creating.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-from-drawables.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-rendering.sgml,
gdk-pixbuf/tmpl/refcounting.sgml: Markup fixes.
* gtk/building.sgml, gtk/resources.sgml: Markup fixes.
* gtk/gtk.types: Remove gtk_text_layout_get_type(). (???)
* gdk/tmpl/general.sgml: Use <envar>, not <envvar>.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
2001-12-17 23:06:47 +00:00
|
|
|
file 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+"
|
2001-09-08 04:39:53 +00:00
|
|
|
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
|
Markup fixes.
* gdk-pixbuf/tmpl/creating.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-from-drawables.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-rendering.sgml,
gdk-pixbuf/tmpl/refcounting.sgml: Markup fixes.
* gtk/building.sgml, gtk/resources.sgml: Markup fixes.
* gtk/gtk.types: Remove gtk_text_layout_get_type(). (???)
* gdk/tmpl/general.sgml: Use <envar>, not <envvar>.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
2001-12-17 23:06:47 +00:00
|
|
|
not only for bugs. We track all GTK+ development in Bugzilla, so it's
|
2001-09-08 04:39:53 +00:00
|
|
|
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
|
Markup fixes.
* gdk-pixbuf/tmpl/creating.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-from-drawables.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-rendering.sgml,
gdk-pixbuf/tmpl/refcounting.sgml: Markup fixes.
* gtk/building.sgml, gtk/resources.sgml: Markup fixes.
* gtk/gtk.types: Remove gtk_text_layout_get_type(). (???)
* gdk/tmpl/general.sgml: Use <envar>, not <envvar>.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
2001-12-17 23:06:47 +00:00
|
|
|
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.
|
2001-09-08 04:39:53 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
If you want to discuss your patch before or after developing it, mail
|
More precise documentation about underscores and mnemonics. (#66380)
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
2001-12-20 23:09:29 +00:00
|
|
|
<ulink url="mailto:gtk-devel-list@gnome.org">gtk-devel-list@gnome.org</ulink>.
|
Markup fixes.
* gdk-pixbuf/tmpl/creating.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-from-drawables.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-rendering.sgml,
gdk-pixbuf/tmpl/refcounting.sgml: Markup fixes.
* gtk/building.sgml, gtk/resources.sgml: Markup fixes.
* gtk/gtk.types: Remove gtk_text_layout_get_type(). (???)
* gdk/tmpl/general.sgml: Use <envar>, not <envvar>.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
2001-12-17 23:06:47 +00:00
|
|
|
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.
|
2001-09-08 04:39:53 +00:00
|
|
|
</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
|
Markup fixes.
* gdk-pixbuf/tmpl/creating.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-from-drawables.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-rendering.sgml,
gdk-pixbuf/tmpl/refcounting.sgml: Markup fixes.
* gtk/building.sgml, gtk/resources.sgml: Markup fixes.
* gtk/gtk.types: Remove gtk_text_layout_get_type(). (???)
* gdk/tmpl/general.sgml: Use <envar>, not <envvar>.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
2001-12-17 23:06:47 +00:00
|
|
|
archives of these lists on
|
|
|
|
|
<ulink url="http://mail.gnome.org">http://mail.gnome.org</ulink>.
|
2001-09-08 04:39:53 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
<variablelist>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
More precise documentation about underscores and mnemonics. (#66380)
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
2001-12-20 23:09:29 +00:00
|
|
|
<term><ulink url="mailto:gtk-list@gnome.org">gtk-list@gnome.org</ulink></term>
|
2001-09-08 04:39:53 +00:00
|
|
|
<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>
|
More precise documentation about underscores and mnemonics. (#66380)
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
2001-12-20 23:09:29 +00:00
|
|
|
<term><ulink url="mailto:gtk-app-devel-list@gnome.org">gtk-app-devel-list@gnome.org</ulink></term>
|
|
|
|
|
<listitem><para>
|
2001-09-08 04:39:53 +00:00
|
|
|
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>
|
More precise documentation about underscores and mnemonics. (#66380)
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
2001-12-20 23:09:29 +00:00
|
|
|
<term><ulink url="mailto:gtk-devel-list@gnome.org">gtk-devel-list@gnome.org</ulink></term>
|
2001-09-08 04:39:53 +00:00
|
|
|
<listitem><para>
|
2002-01-17 23:04:19 +00:00
|
|
|
gtk-devel-list is for discussion of work on GTK+ itself, it is
|
|
|
|
|
<emphasis>not</emphasis> for
|
2001-09-08 04:39:53 +00:00
|
|
|
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>
|
More precise documentation about underscores and mnemonics. (#66380)
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
2001-12-20 23:09:29 +00:00
|
|
|
<term><ulink url="mailto:gtk-i18n-list@gnome.org">gtk-i18n-list@gnome.org</ulink></term>
|
2001-09-08 04:39:53 +00:00
|
|
|
<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>
|
More precise documentation about underscores and mnemonics. (#66380)
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
2001-12-20 23:09:29 +00:00
|
|
|
<term><ulink url="mailto:gtk-doc-list@gnome.org">gtk-doc-list@gnome.org</ulink></term>
|
2001-09-08 04:39:53 +00:00
|
|
|
<listitem><para>
|
Markup fixes.
* gdk-pixbuf/tmpl/creating.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-from-drawables.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml,
gdk-pixbuf/tmpl/gdk-pixbuf-xlib-rendering.sgml,
gdk-pixbuf/tmpl/refcounting.sgml: Markup fixes.
* gtk/building.sgml, gtk/resources.sgml: Markup fixes.
* gtk/gtk.types: Remove gtk_text_layout_get_type(). (???)
* gdk/tmpl/general.sgml: Use <envar>, not <envvar>.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
2001-12-17 23:06:47 +00:00
|
|
|
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.
|
2001-09-08 04:39:53 +00:00
|
|
|
</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
</variablelist>
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</refentry>
|
