Re: GNOME DVB Daemon documentation

[Mario Blättermann <mariobl gnome org>]

Am Mittwoch, den 31.03.2010, 22:00 +0200 schrieb Sebastian Pölsterl:
> The Totem plugin is just a frontend/viewer for the daemon, though 
> currently the only one. Currently beside the Totem plugin there are two 
> more GUIs, gnome-dvb-setup (assistant to setup you card/search for 
> channels) and gnome-dvb-control (browse program guide, manage 
> recordings, channels and devices). The Totem plugin for the most part 
> uses the UI elements that gnome-dvb-control does, therefore you can do 
> everything within Totem.

If these GUIs are working as a standalone app, then a standalone
documentation would be better. But the manual should be available via
the plugin settings in Totem, too.

> I see your point, it would make sense to include it in Totem. Is it 
> possible to cross-reference documentation?

Cross-references are possible between Mallard docs. But the current
Totem manual is written in old-style DocBook. The only way to
cross-reference would be a link within the Totem manual, but this is not
the best way.

I propose to provide a standalone manual for the DVB daemon for the time
being. Later it could be cross-referenced with an (upcoming) Mallard
documentation for Totem, and it could be provided both as standalone and
as part of the Totem docs. The Mallard format makes it easy to snap a
new *.page file into another.

Cheers,
Mario