ports/167758: Install of x11/yelp fails to create or diddle mimeapps.list file

[Ronald F.Guilmette]

>Number:         167758
>Category:       ports
>Synopsis:       Install of x11/yelp fails to create or diddle mimeapps.list file
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed May 09 20:40:01 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 8.3-RELEASE amd64
>Organization:
entropy
>Environment:
System: FreeBSD segfault.tristatelogic.com 8.3-RELEASE FreeBSD 8.3-RELEASE #0: Mon Apr 9 21:23:18 UTC 2012 root at mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64

>Description:

Some gnome applications (e.g. gthumb) assume that URIs of the form "ghelp:..."
are supported by the installed gtk/gio/glib libraries, e.g. via the GTK
function `gtk_show_uri' (see libgtk) and also via the function
`g_app_info_launch_default_for_uri' (see libgio, part of glib).

Unfortunately, such URIs will not actually be supported unless and until the
file `/usr/local/share/applications/mimeapps.list' is made to contain the
following two magic text lines:

	[Added Associations]
	x-scheme-handler/ghelp=yelp.desktop

Then and only then will the gtk/gio/glib functions properly support URIs
where the URI scheme is "ghelp".  Furthermore, the "ghelp" URI scheme is
only supported when and if the program that has been designed to handles
all URIs that begin with the "ghelp:" is installed.  That program is yelp.

Based upon all of the forgoing, it seems reasonable that a part of the
standard install procedure for the x11/yelp port should be to append the
two magic text lines shown above to the tail end of the
/usr/local/share/applications/mimeapps.list file, creating that file if
it does not already exist.

>How-To-Repeat:

portinstall gthumb
gthumb

(then click on "Help" and then "Contents")

>Fix:

This problem can be fixed by running the following trivial script as part of
the standard install procedure for the x11/yelp port:

=========================================================================
#!/bin/sh

(echo '[Added Associations]'; \
  echo 'x-scheme-handler/ghelp=yelp.desktop') \
    >> /usr/local/share/applications/mimeapps.list
=========================================================================
>Release-Note:
>Audit-Trail:
>Unformatted: