docs/reference/html/gmime-question-index.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Frequently Asked Questions</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GMime 2.6 Reference Manual">
   8 <link rel="up" href="gmime.html" title="Part I. GMime Overview">
   9 <link rel="prev" href="gmime-resources.html" title="Mailing lists and bug reports">
  10 <link rel="next" href="fundamentals.html" title="Part II. GMime Fundamentals">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
  16 <td><a accesskey="p" href="gmime-resources.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  17 <td><a accesskey="u" href="gmime.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  18 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  19 <th width="100%" align="center">GMime 2.6 Reference Manual</th>
  20 <td><a accesskey="n" href="fundamentals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  21 </tr></table>
  22 <div class="refentry">
  23 <a name="gmime-question-index"></a><div class="titlepage"></div>
  24 <div class="refnamediv"><table width="100%"><tr>
  25 <td valign="top">
  26 <h2><span class="refentrytitle">Frequently Asked Questions</span></h2>
  27 <p>Frequently Asked Questions —
  28 Find answers to common questions in the GMime manual
  29 </p>
  30 </td>
  31 <td valign="top" align="right"></td>
  32 </tr></table></div>
  33 <div class="refsect1">
  34 <a name="idp5189120"></a><h2>Questions and Answers</h2>
  35 <p>This is an "index" of the reference manual
  36     organized by common "How do I..." questions. If you
  37     aren't sure which documentation to read for the question you have,
  38     this list is a good place to start.
  39     </p>
  40 <div class="qandaset">
  41 <a name="idp5200944"></a><table border="0" width="100%" summary="Q and A Set">
  42 <col align="left" width="1%">
  43 <col>
  44 <tbody>
  45 <tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
  46 <a name="idp5201200"></a>1. General</h5></td></tr>
  47 <tr class="question">
  48 <td align="left" valign="top">
  49 <a name="idp5201872"></a><a name="idp5202128"></a><p><b>1.1.</b></p>
  50 </td>
  51 <td align="left" valign="top"><p>Where can I get help with GMime, submit a bug report, or make a feature request?</p></td>
  52 </tr>
  53 <tr class="answer">
  54 <td align="left" valign="top"></td>
  55 <td align="left" valign="top"><p>See the <a class="link" href="gmime-resources.html" title="Mailing lists and bug reports">documentation on this
  56             topic</a>.</p></td>
  57 </tr>
  58 <tr class="question">
  59 <td align="left" valign="top">
  60 <a name="idp5204368"></a><a name="idp5204624"></a><p><b>1.2.</b></p>
  61 </td>
  62 <td align="left" valign="top"><p>How do I port from one GMime version to another?</p></td>
  63 </tr>
  64 <tr class="answer">
  65 <td align="left" valign="top"></td>
  66 <td align="left" valign="top"><p>See the <a class="link" href="gmime-changes-2-4.html" title="Changes from 2.2 to 2.4">list of
  67             incompatible changes from 2.2 to 2.4</a>.</p></td>
  68 </tr>
  69 <tr class="question">
  70 <td align="left" valign="top">
  71 <a name="idp5237584"></a><a name="idp5237840"></a><p><b>1.3.</b></p>
  72 </td>
  73 <td align="left" valign="top"><p>How does memory management work in GMime? Should I free data returned from functions?</p></td>
  74 </tr>
  75 <tr class="answer">
  76 <td align="left" valign="top"></td>
  77 <td align="left" valign="top">
  78 <p>Most accessor functions return a pointer to internal
  79             members. When these internal members are objects
  80             themselves (e.g. subclasses
  81             of <a class="ulink" href="http://developer.gnome.org/doc/API/2.0/gobject/gobject-The-Base-Object-Type.html" target="_top">GObject</a>),
  82             there is no need to unref them unless otherwise stated in
  83             the documentation for that particular function.</p>
  84 <p>For accessor functions that return strings, they will be
  85             declared "const" if they should not be freed. Non-const
  86             strings should be freed with <a class="ulink" href="http://developer.gnome.org/doc/API/2.0/glib/glib-Memory-Allocation.html#g-free" target="_top">g_free()</a>.</p>
  87 </td>
  88 </tr>
  89 <tr class="question">
  90 <td align="left" valign="top">
  91 <a name="idp5241536"></a><a name="idp5241792"></a><p><b>1.4.</b></p>
  92 </td>
  93 <td align="left" valign="top"><p>How do I use GMime with threads?</p></td>
  94 </tr>
  95 <tr class="answer">
  96 <td align="left" valign="top"></td>
  97 <td align="left" valign="top">
  98 <p>First, read the <a class="ulink" href="http://developer.gnome.org/doc/API/2.0/glib/glib-Threads.html" target="_top">GThread</a> documentation for
  99             portable threading primitives.</p>
 100 <p>Secondly, all functions
 101             in gmime-charset, gmime-iconv
 102             and gmime-utils should
 103             be thread-safe. Objects subclassing
 104             <a class="ulink" href="http://developer.gnome.org/doc/API/2.0/gobject/gobject-The-Base-Object-Type.html" target="_top">GObject</a>
 105             are not. This means that you'll have to do your own mutex
 106             locking if you want to access the same GObjects from
 107             multiple threads.
 108             </p>
 109 </td>
 110 </tr>
 111 <tr class="question">
 112 <td align="left" valign="top">
 113 <a name="idp5247232"></a><a name="idp5247488"></a><p><b>1.5.</b></p>
 114 </td>
 115 <td align="left" valign="top"><p>How do I use GMime with C++?</p></td>
 116 </tr>
 117 <tr class="answer">
 118 <td align="left" valign="top"></td>
 119 <td align="left" valign="top"><p>The GMime header files use the subset of C that's
 120             also valid C++, so you can simply use the normal GMime API
 121             in a C++ program.</p></td>
 122 </tr>
 123 </tbody>
 124 </table>
 125 </div>
 126 </div>
 127 </div>
 128 <div class="footer">
 129 <hr>
 130           Generated by GTK-Doc V1.18</div>
 131 </body>
 132 </html>