/usr/share/doc/libgnome2-doc/html/libgnome-gnome-init.html is in libgnome2-doc 2.32.1-6.
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 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gnome-init: GNOME Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="GNOME Library Reference Manual">
<link rel="up" href="ch01.html" title="Initializing Applications and Starting Programs">
<link rel="prev" href="libgnome-gnome-program.html" title="gnome-program">
<link rel="next" href="libgnome-gnome-exec.html" title="gnome-exec">
<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">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#libgnome-gnome-init.description" class="shortcut">Description</a></span>
</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="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="libgnome-gnome-program.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="libgnome-gnome-exec.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="libgnome-gnome-init"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgnome-gnome-init.top_of_page"></a>gnome-init</span></h2>
<p>gnome-init</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="libgnome-gnome-init.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">const <a class="link" href="libgnome-gnome-program.html#GnomeModuleInfo" title="struct GnomeModuleInfo"><span class="returnvalue">GnomeModuleInfo</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgnome-gnome-init.html#libgnome-module-info-get" title="libgnome_module_info_get ()">libgnome_module_info_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a class="link" href="libgnome-gnome-program.html#GnomeModuleInfo" title="struct GnomeModuleInfo"><span class="returnvalue">GnomeModuleInfo</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgnome-gnome-init.html#gnome-bonobo-module-info-get" title="gnome_bonobo_module_info_get ()">gnome_bonobo_module_info_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="libgnome-gnome-init.html#gnome-user-dir-get" title="gnome_user_dir_get ()">gnome_user_dir_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="libgnome-gnome-init.html#gnome-user-private-dir-get" title="gnome_user_private_dir_get ()">gnome_user_private_dir_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">char</span> *
</td>
<td class="function_name">
<a class="link" href="libgnome-gnome-init.html#gnome-user-accels-dir-get" title="gnome_user_accels_dir_get ()">gnome_user_accels_dir_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="libgnome-gnome-init.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody><tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="libgnome-gnome-init.html#LIBGNOME-MODULE:CAPS" title="LIBGNOME_MODULE">LIBGNOME_MODULE</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="libgnome-gnome-init.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include <libgnome/libgnome.h>
</pre>
</div>
<div class="refsect1">
<a name="libgnome-gnome-init.description"></a><h2>Description</h2>
</div>
<div class="refsect1">
<a name="libgnome-gnome-init.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="libgnome-module-info-get"></a><h3>libgnome_module_info_get ()</h3>
<pre class="programlisting">const <a class="link" href="libgnome-gnome-program.html#GnomeModuleInfo" title="struct GnomeModuleInfo"><span class="returnvalue">GnomeModuleInfo</span></a> *
libgnome_module_info_get (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Retrieves the current libgnome version and the modules it depends on.</p>
<div class="refsect3">
<a name="libgnome-module-info-get.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="libgnome-gnome-program.html#GnomeModuleInfo" title="struct GnomeModuleInfo"><span class="type">GnomeModuleInfo</span></a> structure describing the version and
the versions of the dependents.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-bonobo-module-info-get"></a><h3>gnome_bonobo_module_info_get ()</h3>
<pre class="programlisting">const <a class="link" href="libgnome-gnome-program.html#GnomeModuleInfo" title="struct GnomeModuleInfo"><span class="returnvalue">GnomeModuleInfo</span></a> *
gnome_bonobo_module_info_get (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Retrieves the bonobo module version and indicate that it requires the current
libgnome and its dependencies (although libbonobo does not depend on
libgnome, libbonoboui does and this will also be initialised when
initialising a GNOME app).</p>
<div class="refsect3">
<a name="gnome-bonobo-module-info-get.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="libgnome-gnome-program.html#GnomeModuleInfo" title="struct GnomeModuleInfo"><span class="type">GnomeModuleInfo</span></a> structure describing the version of the
bonobo modules and its dependents.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-user-dir-get"></a><h3>gnome_user_dir_get ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
gnome_user_dir_get (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Retrieves the user-specific directory for GNOME apps to use ($HOME/.gnome2
is the usual GNOME 2 value).</p>
<div class="refsect3">
<a name="gnome-user-dir-get.returns"></a><h4>Returns</h4>
<p> An absolute path to the directory.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-user-private-dir-get"></a><h3>gnome_user_private_dir_get ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
gnome_user_private_dir_get (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Differs from <a class="link" href="libgnome-gnome-init.html#gnome-user-dir-get" title="gnome_user_dir_get ()"><code class="function">gnome_user_dir_get()</code></a> in that the directory returned here will
have had permissions of 0700 (rwx------) enforced when it was created. Of
course, the permissions may have been altered since creation, so care still
needs to be taken.</p>
<div class="refsect3">
<a name="gnome-user-private-dir-get.returns"></a><h4>Returns</h4>
<p> An absolute path to the user-specific private directory that GNOME
apps can use.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-user-accels-dir-get"></a><h3>gnome_user_accels_dir_get ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *
gnome_user_accels_dir_get (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Retrieves the user-specific directory that stores the keyboard shortcut files
for each GNOME app. Note that most applications should be using GConf for
storing this information, but it may be necessary to use the
<a class="link" href="libgnome-gnome-init.html#gnome-user-accels-dir-get" title="gnome_user_accels_dir_get ()"><code class="function">gnome_user_accels_dir_get()</code></a> directory for legacy applications.</p>
<div class="refsect3">
<a name="gnome-user-accels-dir-get.returns"></a><h4>Returns</h4>
<p> The absolute path to the directory.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="libgnome-gnome-init.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="LIBGNOME-MODULE:CAPS"></a><h3>LIBGNOME_MODULE</h3>
<pre class="programlisting">#define LIBGNOME_MODULE libgnome_module_info_get()
</pre>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25</div>
</body>
</html>
|