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 163404 - Yelp cannot display many man pages
Yelp cannot display many man pages
Status: RESOLVED FIXED
Product: yelp
Classification: Applications
Component: Man Pages
git master
Other FreeBSD
: Normal major
: ---
Assigned To: Yelp maintainers
Yelp maintainers
Depends on: 326058
Blocks:
 
 
Reported: 2005-01-09 01:40 UTC by Joe Marcus Clarke
Modified: 2009-09-22 01:48 UTC
See Also:
GNOME target: ---
GNOME version: 2.11/2.12


Attachments
adds <br> element handling to man2html.xsl (600 bytes, patch)
2005-08-25 02:16 UTC, Brent Smith (smitten)
committed Details | Review

Description Joe Marcus Clarke 2005-01-09 01:40:44 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
Comment 1 Juanjo Garcia-Ripoll 2005-07-11 17:44:43 UTC
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:
Comment 2 Juanjo Garcia-Ripoll 2005-07-11 17:45:23 UTC
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)
Comment 3 Brent Smith (smitten) 2005-08-25 02:16:46 UTC
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.
Comment 4 Brent Smith (smitten) 2005-08-25 02:18:29 UTC
Marking NEW and upping version.
Comment 5 Brent Smith (smitten) 2005-10-14 04:36:02 UTC
committed in HEAD.
Comment 6 Brent Smith (smitten) 2006-01-09 04:56:49 UTC
This is fixed by the new patch I'm about to commit.  Marking depends on bug 326058
Comment 7 Brent Smith (smitten) 2006-01-09 05:08:00 UTC
fixed in HEAD.