Bug 872853 - User manual is not readable in Yelp
Summary: User manual is not readable in Yelp
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Fedora
Classification: Fedora
Component: gnofract4d
Version: 17
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Jerry James
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-11-03 20:19 UTC by Mario Blättermann
Modified: 2012-11-19 02:29 UTC (History)
2 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2012-11-19 02:19:04 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)
Removes some entities from the DocBook file to make it readable in Yelp (508 bytes, patch)
2012-11-03 20:19 UTC, Mario Blättermann
no flags Details | Diff

Description Mario Blättermann 2012-11-03 20:19:50 UTC
Created attachment 637646 [details]
Removes some entities from the DocBook file to make it readable in Yelp

The user manual is not readable due to some missing files. The files stdlib.xml and commands.xml are missing from the tarball. That's why Yelp considers this as malformed XML code. The attached patch removes the appropriate entities from gnofract4d-manual.xml.

Well, it's not the best solution because the reader gets empty pages, but for the time being it's better than nothing. I will ask the upstream folks if they need help with converting the manual to Mallard (as proposed anyway for Gnome software) and migrating it to itstool instead of gnome-doc-utils.

In general, it affects not f17 only, rather all supported Fedora versions and Rawhide.

Comment 1 Mario Blättermann 2012-11-03 20:38:22 UTC
Patch has been submitted upstream:
https://sourceforge.net/tracker/?func=detail&aid=3582862&group_id=785&atid=100785

Comment 2 Jerry James 2012-11-09 16:05:20 UTC
Thanks for the report, Mario.  I'm attempting to fix this by actually producing the documentation, rather than excising it.  I'll have new builds ready for testing shortly.

Comment 3 Fedora Update System 2012-11-09 16:51:43 UTC
gnofract4d-3.14-2.fc17 has been submitted as an update for Fedora 17.
https://admin.fedoraproject.org/updates/gnofract4d-3.14-2.fc17

Comment 4 Fedora Update System 2012-11-09 16:51:55 UTC
gnofract4d-3.14-2.fc18 has been submitted as an update for Fedora 18.
https://admin.fedoraproject.org/updates/gnofract4d-3.14-2.fc18

Comment 5 Fedora Update System 2012-11-09 16:52:06 UTC
gnofract4d-3.14-2.fc16 has been submitted as an update for Fedora 16.
https://admin.fedoraproject.org/updates/gnofract4d-3.14-2.fc16

Comment 6 Fedora Update System 2012-11-09 21:07:39 UTC
Package gnofract4d-3.14-2.fc18:
* should fix your issue,
* was pushed to the Fedora 18 testing repository,
* should be available at your local mirror within two days.
Update it with:
# su -c 'yum update --enablerepo=updates-testing gnofract4d-3.14-2.fc18'
as soon as you are able to.
Please go to the following url:
https://admin.fedoraproject.org/updates/FEDORA-2012-17898/gnofract4d-3.14-2.fc18
then log in and leave karma (feedback).

Comment 7 Mario Blättermann 2012-11-09 21:58:11 UTC
Works as expected, thanks! I'll keep this bug open so that Bodhi can close it properly once the updates are stable.

Comment 8 Fedora Update System 2012-11-19 02:19:05 UTC
gnofract4d-3.14-2.fc17 has been pushed to the Fedora 17 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 9 Fedora Update System 2012-11-19 02:29:07 UTC
gnofract4d-3.14-2.fc16 has been pushed to the Fedora 16 stable repository.  If problems still persist, please make note of it in this bug report.


Note You need to log in before you can comment on or make changes to this bug.