headers
Matt Keenan | 7 Jun 2006 20:21
Picon

Re: Docbook versions supported by Yelp

Shaun McCance wrote:
> On Fri, 2006-05-12 at 11:13 +0100, Matt Keenan wrote:
>   
>> Hi,
>>
>> Just wanted to find out what versions of docbook yelp suppored. Does it 
>> support Docbook 5 ?
>> I know dobook 5 is only at beta stage but I presume there is plans for 
>> yelp to support it ?
>>     
>
> There is currently no support for DocBook 5,
> and it's not very high on my priority list.
> I'd rather put that kind of time and effort
> into moving away from DocBook.

Moving away from DocBook ?, I thought the push was to have all GNOME 
documentation
written in DocBook, even man pages ?

If not DocBook then what would be the preferred supported documentation 
format. ?

Matt
Permalink | Reply | 2 comments |
headers
Don Scorgie | 7 Jun 2006 19:38
Picon
Favicon

The great "Yelp Patch Cleanup"

Hey,

As part of the ever-ongoing "Great Bugzilla Cleanup" for Yelp, I've been
looking at the patches that are currently sitting there.  This email is
to try and get a consensus on some of them (and hopefully get at least a
few applied)

So, in no particular order, the big patches are:

*Notes support for info pages (bug #343524) [1]
*Notes are supposed to act like hyperlinks for info files.  The patch
makes them into actual hyperlinks.  Works for me.  I'd like to see
committed.

Translated man pages (bug #343275) [2]
Don't really know the man page stuff, but looks good from the screenies
smitten showed a bit ago.

New look TOC (bug #337584) [3]
I'd definitely like to see a new look TOC added.  Patch needs a bit of
work though and the categories would really need re-thunk

DBUS activation (bug #337540) [4]
Kill Bonobo activation in favour of DBUS.  Seems to be the way the wind
is swaying.  chpe thinks this may not be the best idea (after epiphany
switched to dbus activation).  It would allow (in future) us to provide
dbus signals for other applications to load help files and do our part
for the die-libgnome-die campaign

Section auto-expanding (bug #167070) [5]
(Continue reading)

Permalink | Reply | 3 comments |
headers
Shaun McCance | 9 Jun 2006 18:52
Picon
Gravatar

Web Designers Wanted

I've just posted the following call for mockups to my blog:

http://blogs.gnome.org/edit/shaunm/2006/06/09/0

Basically, I'm looking for talented designers to submit mockups
for our help pages.  I've been largely the sole designer of the
layout for quite some time, and I think it'll be good to get a
fresh perspective on things.

Do feel free to post this anywhere you think we might get some
fresh new contributors.  This is a great opportunity to get
non-programmers involved with Gnome.

--
Shaun
Permalink | Reply | 0 comments |
headers
Shaun McCance | 9 Jun 2006 19:03
Picon
Gravatar

Re: The great "Yelp Patch Cleanup"

On Wed, 2006-06-07 at 18:38 +0100, Don Scorgie wrote:
> Hey,
> 
> As part of the ever-ongoing "Great Bugzilla Cleanup" for Yelp, I've been
> looking at the patches that are currently sitting there.  This email is
> to try and get a consensus on some of them (and hopefully get at least a
> few applied)
> 
> So, in no particular order, the big patches are:
> 
> *Notes support for info pages (bug #343524) [1]
> *Notes are supposed to act like hyperlinks for info files.  The patch
> makes them into actual hyperlinks.  Works for me.  I'd like to see
> committed.

Seems right to me.  I'll trust your judgment on this.

> Translated man pages (bug #343275) [2]
> Don't really know the man page stuff, but looks good from the screenies
> smitten showed a bit ago.

We definitely want this working, and I trust Brent's judgment on this.

> New look TOC (bug #337584) [3]
> I'd definitely like to see a new look TOC added.  Patch needs a bit of
> work though and the categories would really need re-thunk

Categorization is hard.  And it's made all the harder by the fact
that the last thing people want to see when they open Yelp is a
list of categories to browse through.
(Continue reading)

Permalink | Reply | 1 comment |
headers
Don Scorgie | 9 Jun 2006 21:56
Picon
Favicon

Re: The great "Yelp Patch Cleanup"

On Fri, 2006-06-09 at 12:03 -0500, Shaun McCance wrote:
> On Wed, 2006-06-07 at 18:38 +0100, Don Scorgie wrote:
> > Hey,
> > 
> > As part of the ever-ongoing "Great Bugzilla Cleanup" for Yelp, I've been
> > looking at the patches that are currently sitting there.  This email is
> > to try and get a consensus on some of them (and hopefully get at least a
> > few applied)
> > 
> > So, in no particular order, the big patches are:
> > 
> > *Notes support for info pages (bug #343524) [1]
> > *Notes are supposed to act like hyperlinks for info files.  The patch
> > makes them into actual hyperlinks.  Works for me.  I'd like to see
> > committed.
> 
> Seems right to me.  I'll trust your judgment on this.
> 
> > Translated man pages (bug #343275) [2]
> > Don't really know the man page stuff, but looks good from the screenies
> > smitten showed a bit ago.
> 
> We definitely want this working, and I trust Brent's judgment on this.
> 
> > New look TOC (bug #337584) [3]
> > I'd definitely like to see a new look TOC added.  Patch needs a bit of
> > work though and the categories would really need re-thunk
> 
> Categorization is hard.  And it's made all the harder by the fact
> that the last thing people want to see when they open Yelp is a
(Continue reading)

Permalink | Reply | 0 comments |
headers
Brent Smith | 12 Jun 2006 06:44

Re: The great "Yelp Patch Cleanup"

Don Scorgie wrote:

[snip]

> There we go.  That's the big patches (or at least the ones I'd like to
> see closed).  So, any comments on any of the above (or any other patch
> in bugzilla)?
> 
> Don
> 
> [1] http://bugzilla.gnome.org/show_bug.cgi?id=343524
> [2] http://bugzilla.gnome.org/show_bug.cgi?id=343275
> [3] http://bugzilla.gnome.org/show_bug.cgi?id=337584
> [4] http://bugzilla.gnome.org/show_bug.cgi?id=337540
> [5] http://bugzilla.gnome.org/show_bug.cgi?id=167070
> [6] http://bugzilla.gnome.org/show_bug.cgi?id=67966
> 

Following up:

Yelp will have the following patches in 2.15.3
Notes support for info pages
Translated Man Pages
DBus activation
Section auto-expanding
Recently View List
New Help Infrastructure, (see bug 343788)

I would love to see some people testing this release!
(Continue reading)

Permalink | Reply | 0 comments |
headers
Don Scorgie | 14 Jun 2006 17:01
Picon
Favicon

Re: Docbook versions supported by Yelp

Hi,

(Sorry, I apparently missed this first time around)

On Wed, 2006-06-07 at 19:21 +0100, Matt Keenan wrote:
> Shaun McCance wrote:
> > On Fri, 2006-05-12 at 11:13 +0100, Matt Keenan wrote:
> >   
> >> Hi,
> >>
> >> Just wanted to find out what versions of docbook yelp suppored. Does it 
> >> support Docbook 5 ?
> >> I know dobook 5 is only at beta stage but I presume there is plans for 
> >> yelp to support it ?
> >>     
> >
> > There is currently no support for DocBook 5,
> > and it's not very high on my priority list.
> > I'd rather put that kind of time and effort
> > into moving away from DocBook.
> 
> Moving away from DocBook ?, I thought the push was to have all GNOME 
> documentation
> written in DocBook, even man pages ?
> 
> If not DocBook then what would be the preferred supported documentation 
> format. ?

I believe Shaun is referring to the much anticipated, much rumoured,
Project Mallard [1], an attempt to move the documentation to a more
(Continue reading)

Permalink | Reply | 1 comment |
headers
Matt Keenan | 15 Jun 2006 10:21
Picon

Re: Docbook versions supported by Yelp

Thanks Don :)

Don Scorgie wrote:
> Hi,
>
> (Sorry, I apparently missed this first time around)
>
> On Wed, 2006-06-07 at 19:21 +0100, Matt Keenan wrote:
>   
>> Shaun McCance wrote:
>>     
>>> On Fri, 2006-05-12 at 11:13 +0100, Matt Keenan wrote:
>>>   
>>>       
>>>> Hi,
>>>>
>>>> Just wanted to find out what versions of docbook yelp suppored. Does it 
>>>> support Docbook 5 ?
>>>> I know dobook 5 is only at beta stage but I presume there is plans for 
>>>> yelp to support it ?
>>>>     
>>>>         
>>> There is currently no support for DocBook 5,
>>> and it's not very high on my priority list.
>>> I'd rather put that kind of time and effort
>>> into moving away from DocBook.
>>>       
>> Moving away from DocBook ?, I thought the push was to have all GNOME 
>> documentation
>> written in DocBook, even man pages ?
(Continue reading)

Permalink | Reply | 0 comments |
headers
Shaun McCance | 27 Jun 2006 15:38
Picon
Gravatar

Threaded Transforms

I'm attaching a rough first pass at a threaded
wrapper for XSLT transformations.  I'm going to
be offline for a couple of days, and I know at
least Brent wanted to see this.

Basically, you make a YelpTransform struct with
some callback functions for chunks, errors, and
finalization.  The YelpTransform forks off a new
thread with the libxslt stuff.  Internally, it
manages a GAsyncQueue and adds idle handlers to
call your callbacks in the main thread (or, more
pedantically, in whatever thread your main loop
is running in).

Outside this module, you never see the thread or
the queue or any of that.  It encapsulates the
threading completely.

This implementation is not production-quality.
Notably, freeing a running YelpTransform will
result in Very Bad Things happening.  Ideally,
we'd find a way to set some sort of stop bit
in the xsltTransformContext on free and wait
for the thread to exit cleanly.  The thread
itself could then clean everything up in its
dying breath if the stop bit was set.  We'd
probably rename free to release, I guess.

It is not a GObject, because it's designed to
be managed from only one place.  In the brave
(Continue reading)

Permalink | Reply | 0 comments |
headers
Shaun McCance | 29 Jun 2006 20:35
Picon
Gravatar

Re: Change in gnome-doc-utils.make file

On Tue, 2006-06-27 at 21:07 +0530, Ravishankar Haranath wrote:
> 
> The line continuation mark '\' were missing for the if construct
> starting at line 506.
> It has been added properly for this if construct....
> 
> if ENABLE_SK \
> _ENABLE_SK = true \
> else \
> _ENABLE_SK = false \
> endif
> 
> attaching the changed make file

There is no need for line continuations like this in make
conditionals.  Is there some specific problem that you've
encountered that you think was caused by this?

For future reference, the correct mailing list for problems
in gnome-doc-utils is gnome-doc-devel-list.  Better yet, you
can file bugs in bugzilla.gnome.org with the gnome-doc-utils
product.  We far preferred unified (-u) diffs to modified
files, as it's much easier to see what you've changed.

--
Shaun
Permalink | Reply | 0 comments |

Gmane