|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/libgnome/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gnome-util</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GNOME Library Reference Manual">
<link rel="up" href="ch01s04.html" title="Miscellaneous">
<link rel="prev" href="ch01s04.html" title="Miscellaneous">
<link rel="next" href="libgnome-gnome-sound.html" title="gnome-sound">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="libgnome.html" title="GNOME Library (libgnome)">
</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="2">
<tr valign="middle">
<td><a accesskey="p" href="ch01s04.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch01s04.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNOME Library Reference Manual</th>
<td><a accesskey="n" href="libgnome-gnome-sound.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2822350" class="shortcut">Top</a>
 | 
<a href="#id2822642" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgnome-gnome-util"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2822350"></a><span class="refentrytitle">gnome-util</span>
</h2>
<p>gnome-util — Miscellaneous utility functions.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <libgnome/libgnome.h>
#define <a href="libgnome-gnome-util.html#gnome-is-program-in-path">gnome_is_program_in_path</a> (program)
const char* <a href="libgnome-gnome-util.html#g-extension-pointer">g_extension_pointer</a> (const char *path);
#define <a href="libgnome-gnome-util.html#gnome-util-prepend-user-home">gnome_util_prepend_user_home</a> (x)
#define <a href="libgnome-gnome-util.html#gnome-util-home-file">gnome_util_home_file</a> (afile)
char* <a href="libgnome-gnome-util.html#gnome-util-user-shell">gnome_util_user_shell</a> (void);
int <a href="libgnome-gnome-util.html#gnome-setenv">gnome_setenv</a> (const char *name,
const char *value,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> overwrite);
void <a href="libgnome-gnome-util.html#gnome-unsetenv">gnome_unsetenv</a> (const char *name);
void <a href="libgnome-gnome-util.html#gnome-clearenv">gnome_clearenv</a> (void);
#define <a href="libgnome-gnome-util.html#g-concat-dir-and-file">g_concat_dir_and_file</a> (dir,file)
#define <a href="libgnome-gnome-util.html#g-file-exists">g_file_exists</a> (filename)
#define <a href="libgnome-gnome-util.html#g-unix-error-string">g_unix_error_string</a> (error_num)
#define <a href="libgnome-gnome-util.html#gnome-util-user-home">gnome_util_user_home</a> ()
#define <a href="libgnome-gnome-util.html#g-copy-vector">g_copy_vector</a> (vec)
#define <a href="libgnome-gnome-util.html#gnome-libdir-file">gnome_libdir_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-datadir-file">gnome_datadir_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-sound-file">gnome_sound_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-pixmap-file">gnome_pixmap_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-config-file">gnome_config_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-unconditional-libdir-file">gnome_unconditional_libdir_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-unconditional-datadir-file">gnome_unconditional_datadir_file</a>(f)
#define <a href="libgnome-gnome-util.html#gnome-unconditional-sound-file">gnome_unconditional_sound_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-unconditional-pixmap-file">gnome_unconditional_pixmap_file</a> (f)
#define <a href="libgnome-gnome-util.html#gnome-unconditional-config-file">gnome_unconditional_config_file</a> (f)
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2822642"></a><h2>Description</h2>
<p>
The functions in this section provide some shortcuts to finding certain file
paths. There are also some functions for manipulating environment variables for
those systems that do not have <code class="function"><code class="function">getenv()</code></code> and similar
functions.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
Many of the function in here are now deprecated in favour of similar
functions in glib. The preferred replacement function in those cases is
indicated below.
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2822684"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2822695"></a><h3>
<a name="gnome-is-program-in-path"></a>gnome_is_program_in_path()</h3>
<a class="indexterm" name="id2822710"></a><pre class="programlisting">#define gnome_is_program_in_path(program)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_is_program_in_path</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated, use <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-find-program-in-path"
><span class="type">g_find_program_in_path</span></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>program</code></em> :</span></td>
<td> A program name.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if program is not on the path or a string
allocated with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-malloc"
><code class="function">g_malloc()</code></a> with the full path name of the program
found.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2822802"></a><h3>
<a name="g-extension-pointer"></a>g_extension_pointer ()</h3>
<a class="indexterm" name="id2822815"></a><pre class="programlisting">const char* g_extension_pointer (const char *path);</pre>
<p>
Extracts the extension from the end of a filename (the part after the final
'.' in the filename).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A filename or file path.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A pointer to the extension part of the filename, or a
pointer to the end of the string if the filename does not
have an extension.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2822880"></a><h3>
<a name="gnome-util-prepend-user-home"></a>gnome_util_prepend_user_home()</h3>
<a class="indexterm" name="id2822893"></a><pre class="programlisting">#define gnome_util_prepend_user_home(x)</pre>
<p>
Prepends the home directory of the user to a filename.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td>A relative filename in the user's home directory.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A string containing <em class="parameter"><code>x</code></em> with the user's home directory path prepended.
The string should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when no longer required.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2822957"></a><h3>
<a name="gnome-util-home-file"></a>gnome_util_home_file()</h3>
<a class="indexterm" name="id2822970"></a><pre class="programlisting">#define gnome_util_home_file(afile)</pre>
<p>
Similar to <a href="libgnome-gnome-util.html#gnome-util-prepend-user-home"><code class="function">gnome_util_prepend_user_home()</code></a>, except that "/home/fred/.gnome2",
instead of just "/home/fred/" is put on the front.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>afile</code></em> :</span></td>
<td> A filename relative to the user's .gnome2 directory.
Returns: A string containing <em class="parameter"><code>afile</code></em> with the user's home directory path and
"/.gnome2" prepended. The string should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when no longer
required.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823036"></a><h3>
<a name="gnome-util-user-shell"></a>gnome_util_user_shell ()</h3>
<a class="indexterm" name="id2823049"></a><pre class="programlisting">char* gnome_util_user_shell (void);</pre>
<p>
Retrieves the user's preferred shell.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A newly allocated string that is the path to the shell.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823090"></a><h3>
<a name="gnome-setenv"></a>gnome_setenv ()</h3>
<a class="indexterm" name="id2823103"></a><pre class="programlisting">int gnome_setenv (const char *name,
const char *value,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> overwrite);</pre>
<p>
Adds "<em class="parameter"><code>name</code></em>=<em class="parameter"><code>value</code></em>" to the environment. Note that on systems without setenv,
this leaks memory so please do not use inside a loop or anything like that.
The semantics are the same as the glibc <code class="function">setenv()</code> (if <code class="function">setenv()</code> exists, it is
used).
</p>
<p>
If <em class="parameter"><code>overwrite</code></em> is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> and the variable already exists in the environment,
then <code class="literal">0</code> is returned and the value is not changed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> An environment variable name.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td> The value to assign to the environment variable.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>overwrite</code></em> :</span></td>
<td> If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, overwrite the existing <em class="parameter"><code>name</code></em> variable in the
environment.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <code class="literal">0</code> on success, <code class="literal">-1</code> on error
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823311"></a><h3>
<a name="gnome-unsetenv"></a>gnome_unsetenv ()</h3>
<a class="indexterm" name="id2823324"></a><pre class="programlisting">void gnome_unsetenv (const char *name);</pre>
<p>
Removes <em class="parameter"><code>name</code></em> from the environment.
In case there is no native implementation of unsetenv,
this could cause leaks depending on the implementation of
environment.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> The environment variable to unset.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823382"></a><h3>
<a name="gnome-clearenv"></a>gnome_clearenv ()</h3>
<a class="indexterm" name="id2823395"></a><pre class="programlisting">void gnome_clearenv (void);</pre>
<p>
Clears out the environment completely.
In case there is no native implementation of clearenv,
this could cause leaks depending on the implementation
of environment.</p>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823422"></a><h3>
<a name="g-concat-dir-and-file"></a>g_concat_dir_and_file()</h3>
<a class="indexterm" name="id2823438"></a><pre class="programlisting">#define g_concat_dir_and_file(dir,file)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_concat_dir_and_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-build-filename"
><code class="function">g_build_filename()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dir</code></em> :</span></td>
<td>Directory name.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>file</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A newly allocated string that is the concatenation of <em class="parameter"><code>dir</code></em> and <em class="parameter"><code>file</code></em>,
with seperators appropriate for the filesystem automatically taken care of.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823535"></a><h3>
<a name="g-file-exists"></a>g_file_exists()</h3>
<a class="indexterm" name="id2823550"></a><pre class="programlisting">#define g_file_exists(filename)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_file_exists</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use g_file_test(<em class="parameter"><code>filename</code></em>, G_FILE_TEST_EXISTS) instead of this
function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>filename</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>Returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>filename</code></em> exists, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823640"></a><h3>
<a name="g-unix-error-string"></a>g_unix_error_string()</h3>
<a class="indexterm" name="id2823656"></a><pre class="programlisting">#define g_unix_error_string(error_num)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_unix_error_string</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strerror"
><code class="function">g_strerror()</code></a> instead of this function. Also, note that the
returned string is only valid until the next call to <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strerror"
><code class="function">g_strerror()</code></a> or
<a href="libgnome-gnome-util.html#g-unix-error-string"><code class="function">g_unix_error_string()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>error_num</code></em> :</span></td>
<td>A system error number (see C <span class="type">errno</span> documentation for more info).
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A string describing the error code.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823756"></a><h3>
<a name="gnome-util-user-home"></a>gnome_util_user_home()</h3>
<a class="indexterm" name="id2823771"></a><pre class="programlisting">#define gnome_util_user_home()</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_util_user_home</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-home-dir"
><code class="function">g_get_home_dir()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>The current user's home directory.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823827"></a><h3>
<a name="g-copy-vector"></a>g_copy_vector()</h3>
<a class="indexterm" name="id2823842"></a><pre class="programlisting">#define g_copy_vector(vec)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_copy_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Use <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strdupv"
><code class="function">g_strdupv()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>vec</code></em> :</span></td>
<td>An array of strings. <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> terminated.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A copy of the <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>-terminated string array.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823931"></a><h3>
<a name="gnome-libdir-file"></a>gnome_libdir_file()</h3>
<a class="indexterm" name="id2823946"></a><pre class="programlisting">#define gnome_libdir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_libdir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
library directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824022"></a><h3>
<a name="gnome-datadir-file"></a>gnome_datadir_file()</h3>
<a class="indexterm" name="id2824037"></a><pre class="programlisting">#define gnome_datadir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_datadir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
data directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824112"></a><h3>
<a name="gnome-sound-file"></a>gnome_sound_file()</h3>
<a class="indexterm" name="id2824127"></a><pre class="programlisting">#define gnome_sound_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_sound_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
sound files directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824203"></a><h3>
<a name="gnome-pixmap-file"></a>gnome_pixmap_file()</h3>
<a class="indexterm" name="id2824218"></a><pre class="programlisting">#define gnome_pixmap_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_pixmap_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
pixmap directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824293"></a><h3>
<a name="gnome-config-file"></a>gnome_config_file()</h3>
<a class="indexterm" name="id2824308"></a><pre class="programlisting">#define gnome_config_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
config directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824383"></a><h3>
<a name="gnome-unconditional-libdir-file"></a>gnome_unconditional_libdir_file()</h3>
<a class="indexterm" name="id2824399"></a><pre class="programlisting">#define gnome_unconditional_libdir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_libdir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
library directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824475"></a><h3>
<a name="gnome-unconditional-datadir-file"></a>gnome_unconditional_datadir_file()</h3>
<a class="indexterm" name="id2824491"></a><pre class="programlisting">#define gnome_unconditional_datadir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_datadir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
data directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824567"></a><h3>
<a name="gnome-unconditional-sound-file"></a>gnome_unconditional_sound_file()</h3>
<a class="indexterm" name="id2824582"></a><pre class="programlisting">#define gnome_unconditional_sound_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_sound_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
sound files directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824659"></a><h3>
<a name="gnome-unconditional-pixmap-file"></a>gnome_unconditional_pixmap_file()</h3>
<a class="indexterm" name="id2824675"></a><pre class="programlisting">#define gnome_unconditional_pixmap_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_pixmap_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
pixmap directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824751"></a><h3>
<a name="gnome-unconditional-config-file"></a>gnome_unconditional_config_file()</h3>
<a class="indexterm" name="id2824767"></a><pre class="programlisting">#define gnome_unconditional_config_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_config_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em> :</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
config directory (not the application's directory).
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>