This file is indexed.

/usr/share/gtk-doc/html/gmime-3.2/gmime-question-index.html is in libgmime-3.0-doc 3.2.0-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

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