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

Add more GApplication docs

Browse Source 
Add more details about ::command-line to the g_application_run docs.
This commit is contained in:
Matthias Clasen 2011-03-04 12:03:15 -05:00
parent 91614bb5fe
commit 34ac69e688
1 changed files with 10 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
gio/gapplication.c
View File

@ -1200,7 +1200,10 @@ g_application_open (GApplication *application,
* *
* If local_command_line() returns %FALSE then the application is registered * If local_command_line() returns %FALSE then the application is registered
* and the #GApplication::command-line signal is emitted in the primary * and the #GApplication::command-line signal is emitted in the primary
* instance (which may or may not be this instance). * instance (which may or may not be this instance). The signal handler
* gets passed a #GApplicationCommandline object that (among other things)
* contains the remaining commandline arguments that have not been handled
* by local_command_line().
* *
* If the application has the %G_APPLICATION_HANDLES_COMMAND_LINE * If the application has the %G_APPLICATION_HANDLES_COMMAND_LINE
* flag set then the default implementation of local_command_line() * flag set then the default implementation of local_command_line()
@ -1216,6 +1219,12 @@ g_application_open (GApplication *application,
* given and the %G_APPLICATION_HANDLES_OPEN flag is set then they * given and the %G_APPLICATION_HANDLES_OPEN flag is set then they
* are assumed to be filenames and g_application_open() is called. * are assumed to be filenames and g_application_open() is called.
* *
* If you need to handle commandline arguments that are not filenames,
* and you don't mind commandline handling to happen in the primary
* instance, you should set %G_APPLICATION_HANDLED_COMMAND_LINE and
* process the commandline arguments in your #GApplication::command-line
* signal handler, either manually or using the #GOptionContext API.
*
* If you are interested in doing more complicated local handling of the * If you are interested in doing more complicated local handling of the
* commandline then you should implement your own #GApplication subclass * commandline then you should implement your own #GApplication subclass
* and override local_command_line(). In this case, you most likely want * and override local_command_line(). In this case, you most likely want