GNOME Bugzilla – Bug 163404
Yelp cannot display many man pages
Last modified: 2009-09-22 01:48:06 UTC
Please describe the problem: Yelp is missing a support for many nroff tags that make it impossible to view man pages on FreeBSD. GNU man pages (such as nm.1) work, but trigger an constant stream of: Unmatched element: R' On the screen. FreeBSD man pages (such as ls.1) do not display at all do to the following (amongst other unsupported tags): (yelp-bin:76145): Yelp-WARNING **: No rule matching the tag '\" The' (yelp-bin:76145): Yelp-WARNING **: No rule matching the tag '\" This' (yelp-bin:76145): Yelp-WARNING **: No rule matching the tag '\" California,' (yelp-bin:76145): Yelp-WARNING **: No rule matching the tag 'Nm' (yelp-bin:76145): Yelp-WARNING **: No rule matching the tag 'Nd' Finally, as a third example, XFree86 man pages (such as XFree86.1) work, but display the following: Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: RS Unmatched element: Indent Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: R Unmatched element: br Unmatched element: R Unmatched element: br Unmatched element: R Unmatched element: br Unmatched element: R Unmatched element: br Unmatched element: R Unmatched element: br Unmatched element: R Unmatched element: br Unmatched element: R Unmatched element: RS Unmatched element: Indent Unmatched element: RS Unmatched element: Indent Unmatched element: R Steps to reproduce: 1. Install Yelp 2.9.2 or HEAD with man page support 2. Try to view any of the man pages mentioned in this report 3. Actual results: The errors listed in the description are seen. Expected results: The man pages should be displayed with minimal console output. Does this happen every time? Yes. Other information: All three of these example man pages can be found here: http://www.marcuscom.com/downloads/man/nm.1.gz http://www.marcuscom.com/downloads/man/ls.1.gz http://www.marcuscom.com/downloads/man/XFree86.1.gz
This happens also with several man pages in Ubuntu 5.04. In particular the manpage rand(3) causes yelp to hang in this version of Ubuntu. The source for the page is available at http://www.mpq.mpg.de/Theorygroup/CIRAC/people/ripoll/rand.3.gz Here:
This happens also with several man pages in Ubuntu 5.04. In particular the manpage rand(3) causes yelp to hang in this version of Ubuntu. The source for the page is available at http://www.mpq.mpg.de/Theorygroup/CIRAC/people/ripoll/rand.3.gz Here: yelp (2.6.3) gnome (2.10) Ubuntu (5.04)
Created attachment 51306 [details] [review] adds <br> element handling to man2html.xsl This takes care of one of the issues with the formatting of the mplayer.1 man page. Screenshot of before and after is here: http://www.nextreality.net/~smitten/yelp.png I'm not too up to date on my XSL, but this seems pretty straight forward and seems to produce the desired effect for the mplayer man page. I checked a few other pages in yelp, to make sure it didn't produce any adverse effects. I didn't do a comprehensive check though.
Marking NEW and upping version.
committed in HEAD.
This is fixed by the new patch I'm about to commit. Marking depends on bug 326058
fixed in HEAD.