docs/reference/glib/resources.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3                "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4 ]>
   5 <refentry id="glib-resources" revision="17 Jan 2002">
   6 <refmeta>
   7 <refentrytitle>Mailing lists and bug reports</refentrytitle>
   8 <manvolnum>3</manvolnum>
   9 <refmiscinfo>Mailing lists and bug reports</refmiscinfo>
  10 </refmeta>
  11
  12 <refnamediv>
  13 <refname>Mailing lists and bug reports</refname>
  14 <refpurpose>
  15 Getting help with GLib
  16 </refpurpose>
  17 </refnamediv>
  18
  19 <refsect1>
  20 <title>Filing a bug report or feature request</title>
  21
  22 <para>
  23 If you encounter a bug, misfeature, or missing feature in GLib, please
  24 file a bug report on the issue tracker at
  25 <ulink url="https://gitlab.gnome.org/GNOME/glib/issues/new">https://gitlab.gnome.org/GNOME/glib/issues/new</ulink>.
  26 We'd also appreciate reports of incomplete or misleading information in
  27 the GLib documentation; file those with the ‘Documentation’ label.
  28 </para>
  29
  30 <para>
  31 Don't hesitate to file a bug report, even if you think we may know
  32 about it already, or aren't sure of the details. Just give us as much
  33 information as you have, and if it's already fixed or has already been
  34 discussed, we'll add a note to that effect in the report.
  35 </para>
  36
  37 <para>
  38 The issue tracker should definitely be used for feature requests, it's
  39 not only for bugs. We track all GLib development in GitLab, so it's
  40 the way to be sure the GLib developers won't forget about an issue.
  41 </para>
  42
  43 </refsect1>
  44
  45 <refsect1>
  46 <title>Code Contributions</title>
  47
  48 <para>
  49 If you develop a bugfix or enhancement for GLib, please open a merge request
  50 for that in GitLab as well. All branches must be offered under the terms of
  51 the GNU LGPL license, so be sure you  are authorized to give us the branch
  52 under those terms.
  53 </para>
  54
  55 <para>
  56 If you want to discuss your branch before or after developing it, mail
  57 <ulink url="mailto:gtk-devel-list@gnome.org">gtk-devel-list@gnome.org</ulink>.
  58 But be sure to create the GitLab merge request as well; if the branch is only
  59 on the list and not in GitLab, it's likely to slip through the cracks.
  60 </para>
  61
  62 </refsect1>
  63
  64 <refsect1>
  65 <title>Mailing lists</title>
  66
  67 <para>
  68 There are several mailing lists dedicated to GTK+ and related
  69 libraries. Discussion of GLib generally takes place on these lists.
  70 You can subscribe or view the archives of these lists on
  71 <ulink url="http://mail.gnome.org">http://mail.gnome.org</ulink>.
  72 </para>
  73
  74 <para>
  75 <variablelist>
  76
  77 <varlistentry>
  78 <term><ulink url="mailto:gtk-list@gnome.org">gtk-list@gnome.org</ulink></term>
  79 <listitem><para>
  80 gtk-list covers general GTK+ (and GLib) topics; questions about using GLib
  81 in programs, GLib from a user standpoint, announcements of GLib-related projects
  82 would all be on-topic. The bulk of the traffic consists of GTK+ programming
  83 questions.
  84 </para></listitem>
  85 </varlistentry>
  86
  87 <varlistentry>
  88 <term><ulink url="mailto:gtk-devel-list@gnome.org">gtk-devel-list@gnome.org</ulink></term>
  89 <listitem><para>
  90 gtk-devel-list is for discussion of work on GTK+ (and GLib) itself, it is
  91 <emphasis>not</emphasis> for asking questions about how to use GTK+ (or GLib)
  92 in applications. gtk-devel-list is appropriate for discussion of branches,
  93 bugs, proposed features, and so on.
  94 </para></listitem>
  95 </varlistentry>
  96
  97 <varlistentry>
  98 <term><ulink url="mailto:gtk-doc-list@gnome.org">gtk-doc-list@gnome.org</ulink></term>
  99 <listitem><para>
 100 gtk-doc-list is for discussion of the <application>gtk-doc</application>
 101 documentation system (used to document GTK+ and Glib), and for work on the GTK+
 102 (and GLib) documentation.
 103 </para></listitem>
 104 </varlistentry>
 105
 106 </variablelist>
 107 </para>
 108
 109 </refsect1>
 110
 111
 112 </refentry>