callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Advise to use gtk_show_uri_on_window()

Browse Source 
Instead of gtk_show_uri() which is now deprecated, and mention an
additional benefit of doing so.

https://bugzilla.gnome.org/show_bug.cgi?id=778726
This commit is contained in:
Bastien Nocera 2017-02-16 04:51:23 +01:00
parent d93dd81e65
commit eca35180f9
1 changed files with 3 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/reference/gtk/migrating-2to3.xml
View File

@ -184,8 +184,9 @@
<listitem>If you are opening a document or URI by launching a command
like <literal>firefox http://my-favourite-website.com</literal> or
<literal>gnome-open ghelp:epiphany</literal>, it is best to just use
gtk_show_uri(); as an added benefit, your application will henceforth
respect the users preference for what application to use.</listitem>
gtk_show_uri_on_window(); as an added benefit, your application will
henceforth respect the users preference for what application to use and
correctly open links in sandboxed applications.</listitem>
<listitem>If you are launching a regular, installed application that
has a desktop file, it is best to use GIOs #GAppInfo with a suitable
launch context.