<HTML
><HEAD
><TITLE
>gnome-dentry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome Library"
HREF="libgnome.html"><LINK
REL="PREVIOUS"
TITLE="gnome-defs"
HREF="gnome-gnome-defs.html"><LINK
REL="NEXT"
TITLE="gnome-exec"
HREF="gnome-gnome-exec.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnome-gnome-defs.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-gnome-exec.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOME-GNOME-DENTRY"
>gnome-dentry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1302"
></A
><H2
>Name</H2
>gnome-dentry&nbsp;--&nbsp;Manipulation of .desktop files.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1305"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>;
<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-LOAD"
>gnome_desktop_entry_load</A
> (const char *file);
<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-LOAD-FLAGS"
>gnome_desktop_entry_load_flags</A
>
                                            (const char *file,
                                             int clean_from_memory_after_load);
<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-LOAD-FLAGS-CONDITIONAL"
>gnome_desktop_entry_load_flags_conditional</A
>
                                            (const char *file,
                                             int clean_from_memory_after_load,
                                             int unconditional);
<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-LOAD-UNCONDITIONAL"
>gnome_desktop_entry_load_unconditional</A
>
                                            (const char *file);
void        <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-SAVE"
>gnome_desktop_entry_save</A
>        (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *dentry);
void        <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-FREE"
>gnome_desktop_entry_free</A
>        (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item);
void        <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-DESTROY"
>gnome_desktop_entry_destroy</A
>     (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item);
void        <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-LAUNCH"
>gnome_desktop_entry_launch</A
>      (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item);
void        <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-LAUNCH-WITH-ARGS"
>gnome_desktop_entry_launch_with_args</A
>
                                            (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item,
                                             int the_argc,
                                             char *the_argv[]);
<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* <A
HREF="gnome-gnome-dentry.html#GNOME-DESKTOP-ENTRY-COPY"
>gnome_desktop_entry_copy</A
> (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *source);
gchar*      <A
HREF="gnome-gnome-dentry.html#GNOME-IS-PROGRAM-IN-PATH"
>gnome_is_program_in_path</A
>        (const gchar *program);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1333"
></A
><H2
>Description</H2
><P
>The routines in this module provide a way to load and save files in
the format expected by the panel to create the menus and applet
definitions.&#13;</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1336"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN1338"
></A
><H3
><A
NAME="GNOMEDESKTOPENTRY"
></A
>struct GnomeDesktopEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	char *name;		/* These contain the translated name/comment */
	char *comment;
	int exec_length;	/* Length of `exec' vector.  Does not
				   include the NULL terminator.  */
	char **exec;		/* Command to execute.  Must be NULL
				   terminated.  */
	char *tryexec;		/* Test program to execute */
	char *icon;		/* Icon name */
	char *docpath;		/* Path to the documentation */
	int   terminal;		/* flag: requires a terminal to run */
	char *type;		/* type of this dentry */
	char *location;		/* path of this dentry */
	char *geometry;		/* geometry for this icon */
	
	unsigned int multiple_args:1;
	unsigned int is_kde:1;  /* If this is a .kdelink file */
} GnomeDesktopEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1343"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-LOAD"
></A
>gnome_desktop_entry_load ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* gnome_desktop_entry_load (const char *file);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a file name that contains a desktop entry.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a newly created desktop entry loaded from <TT
CLASS="PARAMETER"
><I
>file</I
></TT
> or NULL
if the file does not exist or contains stale data.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1364"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-LOAD-FLAGS"
></A
>gnome_desktop_entry_load_flags ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* gnome_desktop_entry_load_flags
                                            (const char *file,
                                             int clean_from_memory_after_load);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a file name that contains a desktop entry.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clean_from_memory_after_load</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> flag</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a newly created desktop entry loaded from <TT
CLASS="PARAMETER"
><I
>file</I
></TT
> or NULL
if the file does not exist or contains stale data.

if <TT
CLASS="PARAMETER"
><I
>clean_from_memory_after_load</I
></TT
> is TRUE, then any data cached used by loading
process is discarded after loading the desktop entry.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1390"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-LOAD-FLAGS-CONDITIONAL"
></A
>gnome_desktop_entry_load_flags_conditional ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* gnome_desktop_entry_load_flags_conditional
                                            (const char *file,
                                             int clean_from_memory_after_load,
                                             int unconditional);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a file name that contains a desktop entry.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clean_from_memory_after_load</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> flag</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>unconditional</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> flag</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a newly created desktop entry loaded from <TT
CLASS="PARAMETER"
><I
>file</I
></TT
> or NULL
if the file does not exist.

if <TT
CLASS="PARAMETER"
><I
>unconditional</I
></TT
> is TRUE then the desktop entry is loaded even if
it contains stale data, otherwise, NULL is returned if stale data
is found (like, the program referenced not existing).

if <TT
CLASS="PARAMETER"
><I
>clean_from_memory_after_load</I
></TT
> is TRUE, then any data cached used by loading
process is discarded after loading the desktop entry.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1421"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-LOAD-UNCONDITIONAL"
></A
>gnome_desktop_entry_load_unconditional ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* gnome_desktop_entry_load_unconditional
                                            (const char *file);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> file name where the desktop entry resides</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a newly created GnomeDesktopEntry loaded from
<TT
CLASS="PARAMETER"
><I
>file</I
></TT
> even if the file does not contain a valid desktop entry or NULL
if the file does not exist.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1442"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-SAVE"
></A
>gnome_desktop_entry_save ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_desktop_entry_save        (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *dentry);</PRE
></TD
></TR
></TABLE
><P
>Saves the desktop entry to disk</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A gnome desktop entry.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1458"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-FREE"
></A
>gnome_desktop_entry_free ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_desktop_entry_free        (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Releases the information used by <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome desktop entry.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1475"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-DESTROY"
></A
>gnome_desktop_entry_destroy ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_desktop_entry_destroy     (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Erases the file that represents <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> and releases the 
memory used by <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome deskop entry.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1493"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-LAUNCH"
></A
>gnome_desktop_entry_launch ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_desktop_entry_launch      (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Launchs the program associated to the <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> desktop entry.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome desktop entry.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1510"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-LAUNCH-WITH-ARGS"
></A
>gnome_desktop_entry_launch_with_args ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_desktop_entry_launch_with_args
                                            (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *item,
                                             int the_argc,
                                             char *the_argv[]);</PRE
></TD
></TR
></TABLE
><P
>Launches the program associated with <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> with <TT
CLASS="PARAMETER"
><I
>the_argv</I
></TT
> as its
arguments.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a gnome desktop entry.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>the_argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the number of arguments to invoke the desktop entry with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>the_argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a vector of arguments for calling the program in <TT
CLASS="PARAMETER"
><I
>item</I
></TT
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1537"
></A
><H3
><A
NAME="GNOME-DESKTOP-ENTRY-COPY"
></A
>gnome_desktop_entry_copy ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
>* gnome_desktop_entry_copy (<A
HREF="gnome-gnome-dentry.html#GNOMEDESKTOPENTRY"
>GnomeDesktopEntry</A
> *source);</PRE
></TD
></TR
></TABLE
><P
>Makes a copy of a <TT
CLASS="PARAMETER"
><I
>source</I
></TT
> GnomeDesktopEntry</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>source</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a GnomeDesktop entry.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A copy of the <TT
CLASS="PARAMETER"
><I
>source</I
></TT
> GnomeDesktopEntry</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1560"
></A
><H3
><A
NAME="GNOME-IS-PROGRAM-IN-PATH"
></A
>gnome_is_program_in_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>gchar*      gnome_is_program_in_path        (const gchar *program);</PRE
></TD
></TR
></TABLE
><P
>Looks for program in the PATH, if it is found, a g_strduped
string with the full path name is returned.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>program</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a program name.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>NULL if program is not on the path or a string 
allocated with g_malloc with the full path name of the program
found</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnome-gnome-defs.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-gnome-exec.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-defs</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-exec</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>