Re: sect3 headers and Yelp

[Shaun McCance <shaunm gnome org>]

Hi Alex,

Sorry for taking so long on this.  I've been out of town for a week.

It seems you'v found the answer yourself.  The new chunking behavior
(always chunk up to two sections deep) isn't really the problem.  The
problem is that Yelp doesn't scroll to an anchor point within a chunk. 
Even with the old Yelp, you would have had the same problem if you had
tried to link to something too deep, like a sect5.

Basically, Yelp 2.4 only marginally works.  It's broken in so many ways,
and there's just nothing that can be done now for the 2.4.x line.  All
these problems and more will be very fixed in 2.6.

--
Shaun

On Wed, 2003-11-26 at 11:45, Alex Roitman wrote:
> On 2003.11.24 10:18, Don Allingham wrote:
> > The project I am working on (GRAMPS - a GNOME genealogy program) has 
> > recently encountered a problem with GNOME 2.4 installations. On GNOME 2.4, 
> > "sect3" headings no longer show up in "yelp", and we can no longer use the 
> > gnome help functions to bring up yelp to a "sect3" location.
> > 
> > Our project is written in python, and we used to be able to do:
> > 
> >      gnome.help_display("gramps-manual","adv-pers")
> > 
> > This would bring up yelp to the "adv-pers" tag (a sect3 heading) in  the 
> > manual. Under GNOME 2.4, it goes to the top of the document. This makes the 
> > context-sensitive help pretty much useless.
> > 
> > When the same code and same manual are run under GNOME 2.2, we get to the 
> > correct heading.
> > 
> > Is this a Yelp problem, or has something else changed?
> 
> In regards to this problem, I stumbled upon bug #114117 and the relevant 
> discussion on this list: 
> http://mail.gnome.org/archives/gnome-doc-list/2003-May/msg00036.html
> 
> It sees that the intention was to have no change in behavior for app 
> developers, but sadly it's not there yet.
> 
> Could you please orient us as to when we should expect the correct behavior 
> with displaying sect3 level headings?
> 
> We are releasing our stable version soon. Releasing it with broken help links 
> is not a nice thing to do for our users.
> 
> Please help!
> 
> Thanks,
> Alex