Re: Docs packaging and Yelp

[Matthias Clasen <mclasen redhat com>]

On Tue, 2005-11-29 at 13:31 -0600, Shaun McCance wrote:
> I'm on fedora-docs-list, but I'm afraid I can't usually manage
> to stay current with it.  So my apologies for coming back to
> this discussion late in the game.  I am one of the maintainers
> of Yelp, Gnome's help browser.
> 
> It's my understanding that Matthias Clasen has patched Yelp
> to display some of the Fedora documentation on the front page.
> There was a lot of talk in threads on this list about how to
> manage things with upstream.
> 
> Currently, we have a situation where at least Ubuntu and Fedora
> are both patching Yelp in different ways to accomplish the same
> thing, which rather sucks.  Ubuntu did contact me about this,
> but we were unable to work something out in the time-frame they
> needed, so they ended up doing their own hack.  One reason we
> had problems is that I wasn't sure how best to make this work
> for all downstream distributors.
> 
> Just as a point of reference, in the future, when there's some
> question as to how to coordinate things with upstream, you might
> consider actually contacting the upstream developers.
> 
> I know how Ubuntu changed Yelp.  And my understanding is that
> Fedora is just putting General|Linux|Distributions|Other on the
> front page.  I assume this was done by changing scrollkeeper.xml
> slightly.  Could somebody send me the patch?  With a clear idea
> of how both Ubuntu and Fedora have done this, we should be able
> to produce a better upstream method in 2.14 or 2.16.
> 
> // Shaun

Shaun, I looked at the Ubuntu patch for inspiration when working on
this, and I believe we are doing essentially the same as they do.

I'll attach our patch FYI.

Matthias


--- yelp-2.12.1/data/scrollkeeper.xml.fedora-docs	2005-10-17 14:57:18.000000000 -0400
+++ yelp-2.12.1/data/scrollkeeper.xml	2005-10-17 14:57:44.000000000 -0400
@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?><!-- -*- indent-tabs-mode: nil -*- -->
 <toc>
+  <toc id="index">
+    <subject category="General|Linux|Distributions|Other"/>
+  </toc>
   <toc id="Desktop">
     <subject category="GNOME"/>
     <subject category="GNOME|Core Desktop"/>
@@ -251,7 +254,6 @@
     <subject category="General|Linux|Distributions|Red Hat"/>
     <subject category="General|Linux|Distributions|Slackware"/>
     <subject category="General|Linux|Distributions|SuSE"/>
-    <subject category="General|Linux|Distributions|Other"/>
     <subject category="General|Linux|General"/>
     <subject category="General|Linux|Other"/>
     <subject category="General|Other"/>