Re: Aisleriot help files

[Shaun McCance <shaunm wolfram com>]

On Mon, 2003-05-26 at 08:37, John Fleck wrote:
> On Sun, 2003-05-25 at 22:42, Brendan McEnaney wrote:
> > I can't get the help files for the various games
> > in Aisleriot to show in the yelp window that pops
> > up with F1 or Help-->Contents from the menu. I get
> > the index but choosing a game from the list just
> > shows a blank page no mater what game gets clicked.
> > 
> > I see the help files in: /usr/share/gnome/help/aisleriot/C/
> > and can view them with text viewer apps but it's a little
> > inelegant reading around all the xml tags. Is this just me
> > or is help in Aisleriot broken? I'm running the stock
> > Gnome 2.2 that ships with RedHat 9.
> 
> The help is indeed broken.
> 
> http://bugzilla.gnome.org/show_bug.cgi?id=98805

There's a lot of perfectly-valid DocBook that just won't work in Yelp.
The issue is that Yelp's chunking machinery isn't all too sophisticated,
and DocBook requires some sophistication to get right.  I'm working on a
fairly extensive set of changes to Yelp's stylesheet customizations, and
issues like this should largely disappear.  I'll be sure to test against
AisleRoot.

--
Shaun