- * This is a convenience function for launching the default application to show
- * the uri. The uri can amongst others (depending on support in gio/gvfs) take
- * the following forms:
- * "file:///home/gnome/pict.jpg",
- * "http://www.gnome.org",
- * "mailto:me@gnome.org",
- * "ghelp:eog".
- * Ideally the timestamp is taken from the event triggering gtk_show_uri.
- * If timestamp is not known you can take %GDK_CURRENT_TIME
+ * This is a convenience function for launching the default application
+ * to show the uri. The uri must be of a form understood by GIO (i.e. you
+ * need to install gvfs to get support for uri schemes such as http://
+ * or ftp://, as only local files are handled by GIO itself).
+ * Typical examples are
+ * <simplelist>
+ * <member><filename>file:///home/gnome/pict.jpg</filename></member>
+ * <member><filename>http://www.gnome.org</filename></member>
+ * <member><filename>mailto:me@gnome.org</filename></member>
+ * </simplelist>
+ * Ideally the timestamp is taken from the event triggering
+ * the gtk_show_uri() call. If timestamp is not known you can take
+ * %GDK_CURRENT_TIME.
+ *
+ * This function can be used as a replacement for gnome_vfs_url_show()
+ * and gnome_url_show().