Re: evolution.xml and bridgehead tag

[Claude Paroz <claude 2xlibre net>]

Le mardi 03 avril 2007 �0:44 -0500, Shaun McCance a �it :
> On Mon, 2007-04-02 at 10:27 +0200, Claude Paroz wrote:
> > Hi,
> > 
> > In Evolution help (evolution.xml), the tag bridghead is used many times, but
> > yelp doesn't render the corresponding text.
> > Is it a yelp bug (should render the bridgehead tag) or an Evolution bug
> > (shouldn't use bridgehead tag in help)?
> 
> Yelp just doesn't support bridgehead.  It's not that it's all
> that difficult to support.  It's just that, with 400+ elements,
> I had to prioritize which parts of DocBook to work on, and I
> never got around to bridgehead.
> 
> It was a low priority because a) we weren't using it anywhere,
> and b) I couldn't think of anywhere we would want to use it.
> 
> And that begs the question, why does Evolution use bridgehead?

Returning to this problem...

I don't know why it was used. I just stumbled across them while
translating the guide to French.

I think the aim was to find a sort of subtitle, without transforming it
into a section in itself.

Seeing in other guides, it was sometimes resolved by using a
variablelist. But I don't think this makes sense in every case.

What do you suggest? Do you have a proposal for a replacement tag (=
title of a little paragraph).

Or would it be interesting to support it in the next version of Yelp,
rending it in bold on one line? See "Setting the Page Options" section
in the gedit guide for an example of a possible use, even if in this
case, the variablelist may be more appropriate.

Anyway, I entered a bug report to track this issue.
http://bugzilla.gnome.org/show_bug.cgi?id=435942

Claude