Re: gtop documentation

[Martin Baulig <martin home-of-linux org>]

Telsa Gwynne <hobbit@aloss.ukuu.org.uk> writes:

> Some time ago, someone summarised a bunch of Gnome apps which lacked
> documentation on gnome-doc-list@gnome.org:
> 
> > Date: Sat, 30 Oct 1999 23:15:28 -0400 (EDT)
> > From: Alexander Kirillov <kirillov@math.sunysb.edu>
> > CC: docs@gnome.org
> > Subject: Re: Help with Gnome documentation
> [snip]
> > 3. There are also some GNOME applications and utitlities missing
> > documentation; IMHO, the most urgent are common utilities such as font
> > and color selector, gtop, and PPP tool. If you want something more
> > challenging, try writing docs for one of them. Just announce it to
> > this list to avoid duplication of efforts, and get in touch with the
> > author of the software - maybe, he is doing it himself.
> > 
> > 	Disclaimer: the above are my suggestions, not approved or
> > authorised by anyone...
> > 
> > 		Best,
> > 			Sasha
> 
> Okay, so that was more than "some time ago" :) I do keep an eye on
> the Gnome CVS commits list, and I haven't seen anything which looks
> to my ignorant eyes like "Brand new gtop documentation".
> 
> I now have the beginnings of a guide to gtop written in what is probably
> very bad Docbook. Before I go any further, I have a few questions: 
> 
> (1) Is anyone doing this already? 
 
Well, at least I don't know of any such project so most likely there's
noone currently working on it.

> (2) Can I pester you for clarifications? I have been reading lots of
> manual pages and /usr/doc/wotnots and so on, but there's still things
> I'm not sure I have understood correctly. Also, I only have access to 
> Linux: if it does different things on, say, Solaris, it would be good 
> to know before I blithely assume that because it's like that on Linux 
> it's like that everywhere. I gather that it certainly works differently
> underneath. I mean more 'what it looks like to users'. 

Feel free to ask me for everything you don't understand ... I'm pretty busy
at the moment with other things, but I'll try to help you as good as
possible - having documentation for GTop would really be great !

> Oh yes. When I say beginnings, I really mean that :) I've covered most
> of what I have found out about the processes window, but the memory
> and filesystem stuff is sketchy, and still in plain old ascii.
> It took me six weeks to get this far, but I hope I might start
> speeding up now..

-- 
Martin Baulig - martin@home-of-linux.org - http://www.home-of-linux.org