Re: Rabbit in the Sawfish Capplet's Headlights

[Alexander Kirillov <kirillov math sunysb edu>]

Looking at the current docs for control-center
(control-center/doc/C/gnomecc.sgml, in control-center-1-0 branch of
CVS), I'd suggest making sawfish capplet docs in a manner similar to other
docs - that is, as an article, using gnome-app-template, with a
separate <sect1> for each capplet.  You may also want to talk to
gnomecc maintainer, hovinen helixcode com who knows more on how
capplet help is linked to help menu etc.

Sasha 



On Mon, Oct 30, 2000 at 08:37:51PM +1100, Jeff Waugh wrote:
> Hi all,
> 
> Okay, so Michael and I have kinda chosen the bits we're interested in doing,
> and I'm just about to start putting some of the text I've written into
> DocBook format (yes, I'm one of those people who DocBooks afterwards)...
> 
> However, I don't want to do this and stuff it up for future integration.
> 
> 
> Problem: There is no capplet template, and therefore, no guide to the
> integration issues we'll have with such a document.
> 
> Problem: Sawfish is an application, and when you put the documentation work
> that Michael and I are doing together, it will fill the role of 'application
> documentation' quite well.
> 
> Problem: I'm doing the capplet options documentation, and that will almost
> certainly be referenced as context-sensitive help.
> 
> 
> So, what should I do? :)
> 
> Given that Michael and I haven't got to the integration stage yet, and that
> only parts of the entire document need to be accessible for
> context-sensitive help and whatnot, I'm not entirely sure how I should
> structure what I'm writing.
> 
> 
> If worst comes to worst, I'll just document section by section, without
> thought to where these fit into a larger document (let alone help system),
> and do the integration later with John and Michael.
> 
> - Jeff
> 
> 
> -- jdub aphid net ----------------------------- http://lazarus.aphid.net/ --
> 
>       I must be getting old... Buying toothpaste with gel in it is no       
>                        longer an Absolute Necessity.                        
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list