[glib] Document that g_app_info_create_from_commandline() does unquoting according to fd.o



commit 0e6d9df35c948d5e65eae0edb6652a9cce88f557
Author: Holger Berndt <hb gnome org>
Date:   Thu May 17 22:24:10 2012 +0200

    Document that g_app_info_create_from_commandline() does unquoting according to fd.o
    
    https://bugzilla.gnome.org/show_bug.cgi?id=676277

 gio/gdesktopappinfo.c |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
---
diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c
index fafea1c..60c49e2 100644
--- a/gio/gdesktopappinfo.c
+++ b/gio/gdesktopappinfo.c
@@ -2143,6 +2143,12 @@ g_desktop_app_info_delete (GAppInfo *appinfo)
  *
  * Creates a new #GAppInfo from the given information.
  *
+ * Note that for @commandline, the quoting rules of the Exec key of the
+ * <ulink url="http://freedesktop.org/Standards/desktop-entry-spec";>freedesktop.org Desktop
+ * Entry Specification</ulink> are applied. For example, if the @commandline contains
+ * percent-encoded URIs, the percent-character must be doubled in order to prevent it from
+ * being swallowed by Exec key unquoting. See the specification for exact quoting rules.
+ *
  * Returns: (transfer full): new #GAppInfo for given command.
  **/
 GAppInfo *



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]