Re: Docs translating
| From: | Andrei Zmievski | Date: | Wed, 07 Mar 2001 17:00:20 +0000 |
| Subject: | Re: Docs translating | ||
| References: | 1 2 | Groups: | php.gtk |
| Request: | Send a blank email to php-gtk+get-493@lists.php.net to get a copy of this message | ||
On Wed, 07 Mar 2001, James Moore wrote:
> OK if we are going to have lots of translations going on then its probably
> best we split the docs from php-gtk and maybe get a separate mailing list.
> At the moment Im having to commit quite a few large patches etc which will
> be clogging peoples mail boxes.
I'd hold off on creating separate entities just yet. Let's see if there
is indeed enough interest in the translation.
> Andrei, Frank and others Ive just poped the latest build of the docs
> up. Perhaps people can review it and tell me what they think, they are
> currently at http://www.phpuk.org/gtk/. Please tell me what you
> think
> about the format of Classes which is the most important really if we
> are going to document them all.
Each class should have:
* brief description
* class hierarchy leading down to it
* description of signals
* longer description
* properties (if it has any)
* method docs
See http://developer.gnome.org/doc/API/gtk/gtkbutton.html
for an
example. Something similar, basically.
> The docs are very skimpy but I have to figure out myself whats going
> on in the source before I can document them.. Andrei If I send you a
> few questions could you answer them then I might have a slightly
> better Idea of whats going on..
Go ahead.
> the main confusing thing is the lack of a mention of GtkWindow
> anywhere.. is that mapped on the GdkWindow? or is it defined in the
> .def's file? also do your functions map directly on the the gtk
> eqivilents?
What do you mean, lack of mention? It's defined in .defs and the code
for it is generated by the generator.
-Andrei
* Black holes are where God divided by zero. *