Bug 175880

Summary: Yelp fails to open any docbook files, with error "An unknown error occured There is no default action associated with this location."
Product: [Fedora] Fedora Reporter: Dave Malcolm <dmalcolm>
Component: yelpAssignee: Dave Malcolm <dmalcolm>
Status: CLOSED RAWHIDE QA Contact:
Severity: medium Docs Contact:
Priority: medium    
Version: rawhide   
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2005-12-19 23:51:50 EST Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---
Bug Depends On:    
Bug Blocks: 150221    

Description Dave Malcolm 2005-12-15 17:08:30 EST
Description of problem:
Yelp seems to be totally broken; any attempt to open an xml help file fails

Version-Release number of selected component (if applicable):

How reproducible:

Steps to Reproduce:
1.  Click on Desktop/System menu -> Help, or run "yelp" from terminal
2.  See "Help Topics", click on e.g. Desktop
3.  Mouseover "User Guide", then click it.
Actual results:
mouseover shows a local URL of an xml file, of the form
Clicking on it brings up an error dialog:
bold text "An unknown error occured"
extra text: "There is no default action associated with this location."

Expected results:
It should open the help file.
Comment 1 Dave Malcolm 2005-12-15 17:10:38 EST
Confirmed on another machine, with yelp-2.13.1-1
Comment 2 Dave Malcolm 2005-12-15 18:51:48 EST
It's doing a gnome_url_show on the URL, which internally calls
gnome_vfs_url_show_with_env, which appears to be returning
Comment 3 Dave Malcolm 2005-12-15 18:59:24 EST
Looking in Nautilus at a typical file:

It's reported as having mimetype:

Open With tab gives no applications selected for handling files of type DocBook

Comment 4 Dave Malcolm 2005-12-15 19:11:47 EST
Looks like Yelp should be registered as a handler for DocBook files.

yelp.desktop.in.in (from upstream tarball) doesn't include any mime types, and
neither does the generated yelp.desktop (in the resulting rpm) 

See http://www.fedoraproject.org/wiki/ScriptletSnippets
for related packaging notes for the specfile.
Comment 5 Dave Malcolm 2005-12-16 11:46:02 EST
That doesn't fix it, and running 
yelp /usr/share/gnome/help/user-guide/C/user-guide.xml
also fails (yelp tries to spawn an external progam, and if it's registered to
handle docbook, spawns itself in a loop)

Looks like get_doc_type doesn't recognize the new mimetype for DocBook, and is
returning YELP_DOC_TYPE_EXTERNAL; I'll patch this for our packages and send it
Comment 6 Dave Malcolm 2005-12-16 12:08:56 EST
Hmmm.. nautilus is reporting it as "application/docbook+xml", but inside yelp,
gnome_vfs_get_mime_type is reporting it as "application/xml".  (slow vs fast
mime sniffing?)  I'll patch it so that yelp can survive either...
Comment 7 Dave Malcolm 2005-12-16 12:24:45 EST
Grrr... at least it can start loading the user guide now, but gives an error
dialog generating the HTML:

Could not process document

The document ‘/usr/share/gnome/help/user-guide/C/user-guide.xml’ could not be
processed. The file ‘/usr/share/yelp/xslt/db2html.xsl’ is either missing, or it
is not a valid XSLT stylesheet.

On starting from a terminal we get some extra debug output:
I/O warning : failed to load external entity "/usr/share/xml/gnome/xslt/d
compilation error: file /usr/share/xml/gnome/xslt/docbook/html/db2html.xsl line
45 element include
xsl:include : unable to load
Comment 8 Dave Malcolm 2005-12-16 12:26:24 EST
Seems to affect all documentation, not just the user guide...
Comment 9 Dave Malcolm 2005-12-16 14:28:59 EST
This was with gnome-doc-utils-0.5.1-1; db2html-bibliography.xsl is indeed
referenced but not installed (the various other stylesheets are) 

Comment 10 Dave Malcolm 2005-12-16 14:34:13 EST
Looks like this was fixed 2 weeks ago in the upstream Makefile.am and we need a
new upstream tarball of gnome-doc-utils:
Comment 11 Dave Malcolm 2005-12-16 14:48:37 EST
I've filed the gnome-doc-utils problem here:

Building with the fix for the mimetype problem into rawhide as yelp-2.13.2-2 
Comment 12 Dave Malcolm 2005-12-16 15:15:47 EST
Sent upstream (with patch) here: http://bugzilla.gnome.org/show_bug.cgi?id=324296