On Wed, 2005-09-28 at 18:21 -0400, Karsten Wade wrote:
Author: kwade
Update of /cvs/fedora/CVSROOT In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18929
Modified Files: avail Log Message: Some traction on this guide?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Ha! Just republishing as UTF-8 for now. But this would be the right place to canonize what's on the Wiki for posterity, methinks.
Call to a few select RH'ers... Do you think the maintainers of redhat-menus (hopefully I hit at least one of them on the CC list above) would have a problem issuing an update that puts the "Documentation" directory back in the menu system?
I can't seem to figure out a graceful way of adding our stuff into the Main Menu without it -- it just ends up in "Other" when I use the "Documentation" category, and I haven't been able to figure out how to make a drop-file for /etc/xdg/menus/applications-merged/ to make this work. If either of them had input, that would be great, even if that input is "you're an idiot, here's the drop file you need." (The first part all by itself is not as helpful, probably.)
On Wed, 2005-09-28 at 18:43 -0400, Paul W. Frields wrote:
Call to a few select RH'ers... Do you think the maintainers of redhat-menus (hopefully I hit at least one of them on the CC list above) would have a problem issuing an update that puts the "Documentation" directory back in the menu system?
Instead of adding new menu entries, would it make more sense to plug into the existing desktop documentation system (accessible via Desktop->Help)? What is that, yelp?
We could have a "Fedora Documenation" link added to the main TOC (/usr/share/yelp/toc.xml). I'm not incredibly familiar with the path from that point, perhaps someone can point me in the right direction.
Thanks, James Laska
On Thu, 2005-09-29 at 08:25 -0400, James Laska wrote:
On Wed, 2005-09-28 at 18:43 -0400, Paul W. Frields wrote:
Call to a few select RH'ers... Do you think the maintainers of redhat-menus (hopefully I hit at least one of them on the CC list above) would have a problem issuing an update that puts the "Documentation" directory back in the menu system?
Instead of adding new menu entries, would it make more sense to plug into the existing desktop documentation system (accessible via Desktop->Help)? What is that, yelp?
This is already in the plan, as it were. I've got that part working even! (OMF creation and installation is part of the package process I've been working on, as well.) Right now a Fedora doc sits in "Other Documentation," about which I'm not entirely happy. I see you found the same top-level point-of-entry I did, the /usr/share/yelp/toc.xml file.
We could have a "Fedora Documenation" link added to the main TOC (/usr/share/yelp/toc.xml). I'm not incredibly familiar with the path from that point, perhaps someone can point me in the right direction.
The only problem I see with that, is that the yelp system doesn't seem to have any built-in way of dropping in modular XML to alter the ToC. (i.e., no way to have individual doc packages alter the table of contents appropriately on package install/removal). Therefore, changing it would be a departure from upstream, and I know that in general Fedora maintainers have been moving away from that methodology. I'm happy if someone says he will take on such a patch; if so, I'll Bugzilla it.
As far as redhat-menus goes, I would think that changing that package is much less hassle, since upstream is Red Hat. I'm hoping Ray Strode will chime in with his take, since I see him prominently mentioned in the % changelog for both these packages.
Ray, in case you are boggled for background, this is about getting official Fedora docs from the Fedora Documentation Project packaged into Core or Extras. (Our preference is the former, since these packages are small and not redundant with anything currently there.)
On Thu, 2005-09-29 at 08:45 -0400, Paul W. Frields wrote:
The only problem I see with that, is that the yelp system doesn't seem to have any built-in way of dropping in modular XML to alter the ToC. (i.e., no way to have individual doc packages alter the table of contents appropriately on package install/removal). Therefore, changing it would be a departure from upstream, and I know that in general Fedora maintainers have been moving away from that methodology. I'm happy if someone says he will take on such a patch; if so, I'll Bugzilla it.
Oh, good point. That doesn't seem optimal. I'd have thought there be a more dynamic method for dropping in distro specific docs and 3rd party pubs without changing the packaging.
Thanks, James Laska
On Thu, 2005-09-29 at 09:51 -0400, James Laska wrote:
On Thu, 2005-09-29 at 08:45 -0400, Paul W. Frields wrote:
The only problem I see with that, is that the yelp system doesn't seem to have any built-in way of dropping in modular XML to alter the ToC. (i.e., no way to have individual doc packages alter the table of contents appropriately on package install/removal). Therefore, changing it would be a departure from upstream, and I know that in general Fedora maintainers have been moving away from that methodology. I'm happy if someone says he will take on such a patch; if so, I'll Bugzilla it.
Oh, good point. That doesn't seem optimal. I'd have thought there be a more dynamic method for dropping in distro specific docs and 3rd party pubs without changing the packaging.
Me too -- the idea of drop directories is so well-used now, it's kind of a shock when developers *don't* use it. So while I do intend to make use of yelp (and likely khelpcenter), those solutions are not as pleasing, given the way Fedora development currently works, as using a "Documentation" submenu off the main menu. I'm not sure why that was removed in Fedora; in RHEL -- at least back when I used RHEL 2.1, and maybe in 3 too -- when you installed official Red Hat documentation, it ended up on the Main Menu under Documentation as expected.
There may be a way to drop the Documentation submenu into the current freedesktop.org menu system in /etc/xdg, but I've tried eight ways to Sunday with no luck. Drop directories are supported there, but they don't appear to work the way it looks like they should. I've been through the fd.o standards without joy. Any insight someone else could provide would be much appreciated.
docs@lists.stg.fedoraproject.org
-
James Laska -
Paul W. Frields