luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-01-13 15:56:23 +01:00
Code Issues Packages Projects Releases Wiki Activity

[GApplication] Tweak docs a bit

Browse Source
This commit is contained in:
Colin Walters 2010-06-09 17:17:14 -04:00
parent cc19922183
commit 8cab5e4693
1 changed files with 24 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
gio/gapplication.c
View File

@ -45,18 +45,32 @@
* @title: GApplication * @title: GApplication
* @short_description: Core application class * @short_description: Core application class
* *
* A #GApplication is the foundation of an application, unique for * A #GApplication is the foundation of an application, unique for a
* a given application identifier. The #GApplication wraps some * given application identifier. The #GApplication wraps some
* low-level platform-specific services; it's expected that most * low-level platform-specific services and is intended to act as the
* software will use a higher-level application class such as * foundation for higher-level application classes such as
* #GtkApplication or #MxApplication. * #GtkApplication or #MxApplication. In general, you should not use
* this class outside of a higher level framework. By default,
* g_application_register_with_data() will invoke g_error() if it is
* run in a context where it cannot support its core features. Note
* that g_error() is by default fatal.
* *
* In addition to single-instance-ness, #GApplication provides support * One of the core features that #GApplication provides is process
* for 'actions', which can be presented to the user in a platform-specific * uniqueness, in the context of a "session". The session concept is
* way (e.g. Windows 7 jump lists). Note that these are just simple actions * platform-dependent, but corresponds roughly to a graphical desktop
* without parameters. For more flexible scriptability, implementing a * login. When your application is launched again, its arguments
* a separate D-Bus interface is recommended, see e.g. * are passed through platform communication to the already running
* program.
*
* In addition, #GApplication provides support for 'actions', which
* can be presented to the user in a platform-specific way
* (e.g. Windows 7 jump lists). Note that these are just simple
* actions without parameters. For more flexible scriptability,
* implementing a a separate D-Bus interface is recommended, see e.g.
* <xref linkend="gdbus-convenience"/>. * <xref linkend="gdbus-convenience"/>.
*
* Finally, #GApplication acts as a basic lifecycle root; see the
* g_application_run() and g_application_quit_with_data() methods.
* *
* Before using #GApplication, you must choose an "application identifier". * Before using #GApplication, you must choose an "application identifier".
* The expected form of an application identifier is very close to that of * The expected form of an application identifier is very close to that of