GNOME Bugzilla – Bug 760313
Make it possible to install additional docs from devhelp itself
Last modified: 2017-06-29 11:48:12 UTC
Created attachment 318473 [details] Add-ons for Firefox in Gnome-Software OS: Fedora 23 HW: HP ProBook 4740s I did a fresh installation of Fedora 23, and installed Devhelp 3.18.1 using "dnf install devhelp". Once I opened Devhelp the first time, I found that many APIs are missing. For example, APIs about Gtk+, GLib, etc. Later on, I asked for David's found that I should install some packages like gtk3-devel-docs and gtk-doc to get those APIs available in Devhelp. So I'm thinking a way to improve this(some ideas from David King). I think Devhelp should recommend users those packages that may be needed by itself. For example, in Gnome-Software, add a "Add-ons" section to recommend those docs packages(as shown in the attached picture). If users are installing Devhelp using command line, maybe devhelp can recommend those documentation packages. That way, it would be better so that some users like me will not google it or ask someone else for help. It would be a very nice improvement, in my opinion.
This looks like a request for the Fedora package, for example the Debian package already has this line: Recommends: libgtk-3-doc, libglib2.0-doc, libpango1.0-doc Could you file it in the Fedora bugzilla? (bugzilla.redhat.com, product: Fedora, component: devhelp)
(In reply to Frederic Peters from comment #1) > This looks like a request for the Fedora package, for example the Debian > package already has this line: > > Recommends: libgtk-3-doc, libglib2.0-doc, libpango1.0-doc > > Could you file it in the Fedora bugzilla? (bugzilla.redhat.com, product: > Fedora, component: devhelp) Thanks for the information. I'll file a bug in the Fedora bugzilla.
(In reply to Frederic Peters from comment #1) > This looks like a request for the Fedora package, for example the Debian > package already has this line: > > Recommends: libgtk-3-doc, libglib2.0-doc, libpango1.0-doc I don't think we can expect downstream packagers of all distributions to maintain the list of all packages that might be shipping gtk-doc documentation. eg., that list doesn't include clutter-doc and webkitgtk4-doc. :) Instead, I would expect devhelp to look at all the libraries installed on my system and offer to install the documentation for those, if they are missing. Maybe we can achieve something like this using PackageKit and gnome-software?
Instead of taking the docs from the distro, it's probably a better idea to download the latest versions, see bug #761284.
(In reply to Sébastien Wilmet from comment #4) > Instead of taking the docs from the distro, it's probably a better idea to > download the latest versions, see bug #761284. So as a first step to improve the situation, I think it would be a good idea to implement bug #761284. Once it is done, we'll see what can be done for non-gnome libraries. *** This bug has been marked as a duplicate of bug 761284 ***