diff --git a/doc/en/GLib/AppInfo.xml b/doc/en/GLib/AppInfo.xml index 633b66a1b..64d1a1474 100644 --- a/doc/en/GLib/AppInfo.xml +++ b/doc/en/GLib/AppInfo.xml @@ -9,7 +9,7 @@ - This interface provides application information and launch contexts. See and for concretes implementations and usage. + This interface provides application information. See and for concretes implementations and usage. The following code sample lists all the application installed on your system: diff --git a/doc/en/GLib/AppInfoAdapter.xml b/doc/en/GLib/AppInfoAdapter.xml index 858a09927..832941684 100644 --- a/doc/en/GLib/AppInfoAdapter.xml +++ b/doc/en/GLib/AppInfoAdapter.xml @@ -15,7 +15,8 @@ - To be added. + + : an implementation of the interface. To be added. @@ -67,9 +68,14 @@ To be added. - To be added. - To be added. - To be added. + Adds a content type to the application. + Always returns True. Throw a if something went wrong. + + Adds a content type to the application information to indicate the application is capable of opening files with the given content type. + +This method always returns True, or throw a if something went wrong. + + @@ -80,9 +86,9 @@ GLib.List - To be added. - To be added. - To be added. + A list of all the applications currently registered on this system. + A of + For desktop files, this includes applications that have NoDisplay=true set or are excluded from display by means of OnlyShowIn or NotShowIn. See . The returned list does not include applications which have the Hidden key set. @@ -93,8 +99,8 @@ System.Boolean - To be added. - To be added. + If a supported content type can be removed from an application. + True if it is possible to remove supported content types from the application, False if not. To be added. @@ -127,8 +133,8 @@ System.String - To be added. - To be added. + An human-readable description of an installed application. + A string containing a description of the application, or null if none. To be added. @@ -171,8 +177,8 @@ System.String - To be added. - To be added. + The executable's name for the installed application. + A string containing the AppInfo's application binary's name. To be added. @@ -187,9 +193,11 @@ - To be added. - To be added. - To be added. + The content type to find a for. + Gets an array of all for a given content type. + + + An array of for given content_type, or null on error. To be added. @@ -205,10 +213,10 @@ - To be added. - To be added. - To be added. - To be added. + The content type to find a for. + If True, the is expected to support URIs. + Gets the that correspond to a given content type. + A for given content_type or null on error. To be added. @@ -223,10 +231,10 @@ - To be added. - To be added. - To be added. - To be added. + A string containing a URI scheme. + Gets the default application for launching applications using this URI scheme. + A for given uri_scheme or null on error. + A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip". @@ -299,8 +307,8 @@ GLib.Icon - To be added. - To be added. + The for the application. + The default for the application. To be added. @@ -312,9 +320,9 @@ System.String - To be added. - To be added. - To be added. + The ID of an application. + A string containing the application's ID. + An id is a string that identifies the application. The exact format of the id is platform depenedent. For instance, on Unix, this is the desktop file id from the xdg menu specification. @@ -342,11 +350,16 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + A of objects, or null to launch the application without arguments. + An , or null. + Launches the application. + Always returns True. Throws a if something went wrong. + + Launches the application. Passes files to the launched application as arguments, using the optional launch_context to get information about the details of the launcher (like what screen it is on). Throws a on error. + To lauch the application without arguments pass a null files list. + Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. + Some URIs can be changed when passed through a (for instance unsupported uris with strange formats like mailto:), so if you have a textual uri you want to pass in as argument, consider using instead. + @@ -361,11 +374,11 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The uri to show. + An optional , or null. + Utility function that launches the default application registered to handle the specified uri. + Always returns True. Throws a if something went wrong. + Synchronous I/O is done on the uri to detect the type of the file if required. @@ -380,11 +393,15 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + A of containing URIs to launch, or null. + A , or null. + Launches the application. + Always returns True. Throws a if something went wrong. + + Launches the application. Passes uris to the launched application as arguments, using the optional launch_context to get information about the details of the launcher (like what screen it is on). On error, throws a + To lauch the application without arguments pass a null uris list. + Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. + @@ -395,8 +412,8 @@ System.String - To be added. - To be added. + The name of the installed application. + A containing the name of the application. To be added. @@ -411,10 +428,10 @@ - To be added. - To be added. - To be added. - To be added. + A containing a content type. On Unix, content types are mimetypes, so "image/jpeg" is a valid content type. + Removes a supported type from an application, if possible. + Always returns True. Throws a if something went wrong. + This method always returns True, but throws on any error. Checking first will avoid some exceptions, but that doesn't mean it won't throw at all. @@ -428,10 +445,10 @@ - To be added. - To be added. - To be added. - To be added. + A containing the file extension (without the dot). + Sets the application as the default handler for the given file extension. + Always returns True. Throws a if something went wrong. + This method always returns True, or throw a if something went wrong. @@ -445,10 +462,10 @@ - To be added. - To be added. - To be added. - To be added. + A containing the content type. + Sets the application as the default handler for a given type + Always returns True. Throws a if something went wrong. + This method always returns True, or throw a if something went wrong. @@ -459,8 +476,8 @@ System.Boolean - To be added. - To be added. + If the application info should be shown in menus that list available applications. + True if the application should be shown, False otherwise. To be added. @@ -472,8 +489,8 @@ System.Boolean - To be added. - To be added. + If the application accepts files as arguments. + True if the application supports files. To be added. @@ -485,11 +502,11 @@ System.Boolean - To be added. - To be added. + If the application supports reading files and directories from URIs. + True if the application supports URIs. To be added. - + \ No newline at end of file diff --git a/doc/en/GLib/AppInfoCreateFlags.xml b/doc/en/GLib/AppInfoCreateFlags.xml index 7ca6655a7..25e67d71f 100644 --- a/doc/en/GLib/AppInfoCreateFlags.xml +++ b/doc/en/GLib/AppInfoCreateFlags.xml @@ -15,7 +15,7 @@ - To be added. + Flags used when creating a . To be added. @@ -27,7 +27,7 @@ GLib.AppInfoCreateFlags - To be added. + Application opens in a terminal window. @@ -38,7 +38,7 @@ GLib.AppInfoCreateFlags - To be added. + No flags. @@ -49,9 +49,9 @@ GLib.AppInfoCreateFlags - To be added. + Application supports URI arguments. - + \ No newline at end of file diff --git a/doc/en/GLib/AppLaunchContext.xml b/doc/en/GLib/AppLaunchContext.xml index 4f821c436..fb0df09cb 100644 --- a/doc/en/GLib/AppLaunchContext.xml +++ b/doc/en/GLib/AppLaunchContext.xml @@ -8,7 +8,7 @@ - To be added. + Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application on the same screen as the launching window. To be added. @@ -18,8 +18,8 @@ Constructor - To be added. - To be added. + Creates a new application launch context. + This is not normally used, instead you instantiate a subclass of this, such as . @@ -65,11 +65,11 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + A . + A of . + Gets the display string for the display. + A display string for the display. + This is used to ensure new applications are started on the same display as the launching application. @@ -84,11 +84,11 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + A . + A of . + Initiates startup notification for the application. + The DESKTOP_STARTUP_ID for the launched operation, if supported. + Startup notification IDs are defined in the FreeDesktop.Org Startup Notifications standard (http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt). @@ -115,11 +115,11 @@ - To be added. - To be added. - To be added. + The startup notification id that was returned by . + Called when an application has failed to launch. + Called when an application has failed to launch, so that it can cancel the application startup notification started in . - + \ No newline at end of file