After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 706223 - Yelp cannot display local manuals from a path using help: but it works with ghelp:
Yelp cannot display local manuals from a path using help: but it works with g...
Status: RESOLVED NOTABUG
Product: yelp
Classification: Applications
Component: General
3.8.x
Other Linux
: Normal major
: ---
Assigned To: Yelp maintainers
Yelp maintainers
Depends on:
Blocks: 682886
 
 
Reported: 2013-08-18 04:04 UTC by Jean-François Fortin Tam
Modified: 2013-08-18 15:55 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Jean-François Fortin Tam 2013-08-18 04:04:42 UTC 
As discovered in bug #687563,

----------
"yelp uses file:// urls for local files and help:app_id urls for installed help
packages.

this command does not work:
yelp help:///home/bmonkey/workspace/ges/pitivi/help/C/

but this does:
yelp file:///home/bmonkey/workspace/ges/pitivi/help/C/

Pitivi uses Gtk.show_uri to open the file. The file url would open the
directory in nautilus. When index.page would be chosen, it would open either a
web browser or a text editor, depending on which mime type was recognized and
which application is associated with it. Yelp does not install a mime type for
*.page files, could be something like x-mallard. So this won't work.

But this still works:

yelp ghelp:///home/bmonkey/workspace/ges/pitivi/help/C/
"
------------

TL;DR: "help:" URIs don't work like "ghelp:" URIs used to for local files. We can't move to them in Pitivi until they do...
Comment 1 Shaun McCance 2013-08-18 15:55:33 UTC 
This is how the help: URI scheme was designed. If you need to load help from an arbitrary location, use a file: URI (but note that you need to handle loading the right translation yourself). If you're just installing to a non-standard prefix, then set XDG_DATA_DIRS.\

The help: URI scheme is for locating resources, not overriding MIME types. And using it with a full path like that would break compatibility with the legacy KDE scheme, which it was designed to coexist with.