<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="gnome-desktop3-Miscellaneous-Functions">
<refmeta>
<refentrytitle role="top_of_page" id="gnome-desktop3-Miscellaneous-Functions.top_of_page">Miscellaneous Functions</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  GNOME-DESKTOP3 Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Miscellaneous Functions</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="gnome-desktop3-Miscellaneous-Functions.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
#include &lt;libgnome/gnome-desktop-utils.h&gt;

<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="gnome-desktop-prepend-terminal-to-vector">gnome_desktop_prepend_terminal_to_vector</link>
                                                        (<parameter><link linkend="int"><type>int</type></link> *argc</parameter>,
                                                         <parameter><link linkend="char"><type>char</type></link> ***argv</parameter>);
</synopsis>
</refsynopsisdiv>

<refsect1 id="gnome-desktop3-Miscellaneous-Functions.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>
<refsect1 id="gnome-desktop3-Miscellaneous-Functions.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="gnome-desktop-prepend-terminal-to-vector" role="function">
<title>gnome_desktop_prepend_terminal_to_vector ()</title>
<indexterm zone="gnome-desktop-prepend-terminal-to-vector"><primary>gnome_desktop_prepend_terminal_to_vector</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                gnome_desktop_prepend_terminal_to_vector
                                                        (<parameter><link linkend="int"><type>int</type></link> *argc</parameter>,
                                                         <parameter><link linkend="char"><type>char</type></link> ***argv</parameter>);</programlisting>
<para>
Prepends a terminal (either the one configured as default in
the user's GNOME setup, or one of the common xterm emulators) to the passed
in vector, modifying it in the process.  The vector should be allocated with
<link linkend="g-malloc"><type>g_malloc</type></link>, as this will <link linkend="g-free"><type>g_free</type></link> the original vector.  Also all elements must
have been allocated separately.  That is the standard glib/GNOME way of
doing vectors however.  If the integer that <parameter>argc</parameter> points to is negative, the
size will first be computed.  Also note that passing in pointers to a vector
that is empty, will just create a new vector for you.
</para><variablelist role="params">
<varlistentry><term><parameter>argc</parameter>&#160;:</term>
<listitem><simpara>a pointer to the vector size
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>argv</parameter>&#160;:</term>
<listitem><simpara>a pointer to the vector
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
