gnome-init

Name

gnome-init — Initialize GNOME libraries.

Synopsis


#include <gnome.h>


int         gnome_init                      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv);
int         gnome_init_with_popt_table      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv,
                                             const struct poptOption *options,
                                             int flags,
                                             poptContext *return_ctx);

Description

These routines initialize the GNOME libraries in an application. As part of the initialization these routines do command line argument parsing.

The gnome_init() function family initializes the Gtk+ toolkit, the Imlib graphics library, initializes session management for the application and loads the user preferences. During this process it parses the command line arguments and dispatches the arguments to the proper argument parsers.

To provide your own arguments, you need to provide a poptOption array (see the man page for popt(3) for more information) that contains the list of arguments that your application recognizes.

Details

gnome_init ()

int         gnome_init                      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv);

Initializes the application. This sets up all of the GNOME internals and prepares them (imlib, gdk, session-management, triggers, sound, user preferences)

app_id : Application id.
app_version : Application version.
argc : argc (for example, as received by main)
argv : argv (for example, as received by main)
Returns : 


gnome_init_with_popt_table ()

int         gnome_init_with_popt_table      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv,
                                             const struct poptOption *options,
                                             int flags,
                                             poptContext *return_ctx);

Initializes the application. This sets up all of the GNOME internals and prepares them (imlib, gdk, session-management, triggers, sound, user preferences)

Unlike gnome_init, with gnome_init_with_popt_table you can provide a table of popt options (popt is the command line argument parsing library).

app_id : Application id.
app_version : Application version.
argc : pointer to argc (for example, as received by main)
argv : pointer to argc (for example, as received by main)
options : poptOption table with options to parse
flags : popt flags.
return_ctx : if non-NULL, the popt context is returned here.
Returns :

See Also

Manual page popt(3).