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 704655 - Switch from gnome-doc-utils to yelp-tools
Switch from gnome-doc-utils to yelp-tools
Status: RESOLVED WONTFIX
Product: pdfmod
Classification: Other
Component: general
0.9.x
Other Linux
: Normal normal
: ---
Assigned To: pdfmod-maint
pdfmod-maint
gnome[unmaintained]
Depends on:
Blocks: 681609
 
 
Reported: 2013-07-22 02:39 UTC by Jeremy Bicha
Modified: 2018-07-16 10:12 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Switch from gnome-doc-utils to yelp-tools (3.71 KB, patch)
2013-07-22 02:40 UTC, Jeremy Bicha
none Details | Review

Description Jeremy Bicha 2013-07-22 02:39:29 UTC
https://wiki.gnome.org/GnomeGoals/NewDocumentationInfrastructure

This patch should work but I couldn't test-build it because of bug 704654.

I'm not sure how to handle src/PdfMod/Gui/Actions.cs though. I've not really worked with Mono before but I think just calling
Process.Start ("help:pdfmod");
should be sufficient.

Behind the scenes, yelp-tools installs the help to

/usr/share/help/C/pdfmod/index.docbook

instead of

/usr/share/gnome/help/pdfmod/C/pdfmod.xml

I think the help:pdfmod link will work as long as the help is installed to one of $XDG_DATA_DIRS or $XDG_DATA_HOME as help/C/pdfmod/index.docbook.

I don't think yelp will load docbook from an arbitrary directory but loading Mallard works fine assuming you have an index.page. (maybe that's a Yelp bug...)

Anyway I decided not to touch the file but I think you should be able to significantly simplify the help handling.

Once the build is fixed, you should be able to run
$ jhbuild buildone pdfmod
$ jhbuild run pdfmod
or jhbuild run yelp help:pdfmod

and then you don't have to worry about running help from the source directory.
Comment 1 Jeremy Bicha 2013-07-22 02:40:18 UTC
Created attachment 249763 [details] [review]
Switch from gnome-doc-utils to yelp-tools
Comment 2 André Klapper 2018-07-16 10:12:41 UTC
pdfmod is not under active development anymore and had its last code changes
in 2011. Its codebase has been archived:
https://gitlab.gnome.org/Archive/pdfmod/commits/master

Closing this report as WONTFIX as part of Bugzilla Housekeeping to reflect
reality. Please feel free to reopen this ticket (or rather transfer the project
to GNOME Gitlab, as GNOME Bugzilla is deprecated) if anyone takes the
responsibility for active development again.