Re: What's wrong with the docs?

2008-02-03 Thread John Coppens
On Sun, 03 Feb 2008 18:40:37 +0200
Stefan Kost <[EMAIL PROTECTED]> wrote:

> > - Are those docs maybe declared unaccessible by the spider engines?
> >   (by robots.txt or so)
> 
> I guess library.gnome.org is just too new and maybe not linked that
> much yet (I used good to search for sites that link to it and found
> links inside it).

Mmmm... But, as far as I can see, library.gnome.org is a (very) nicely
reorganization of the same information that already existed. I check
some more, but many, if not all docs seem familiar. Eg. the GTK+-2.0
tutorial is still missing docs for several frequently used widgets 
(menus and menuitems, to name a couple)

X> > 
> > - Or are those alternative languages just much more popular than C?
> > 
> > Which makes this question pop up: Wouldn't it be interesting/practical
> > to have _common_ documentation. Say, GtkWidget is used in Python like
> > this, in C like this, etc.? I could even serve as an educational tool
> > to compare languages.
> >
> I though about this several times, but don't think it will work. Too
> much of the api is specific to the environment.

But with the power of modern computers it might not be impossible.
The texts are (mostly) common between all languages.

John
___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list


Re: What's wrong with the docs?

2008-02-03 Thread Stefan Kost
Hi,

John Coppens schrieb:
> Hello all...
> 
> There must be something terribly wrong somewhere, when I try to find
> documentation on operation with GTK+ or GDK elements, I always seem to
> get _much_ more documentation from the Python/Perl libraries than from
> the actual C interface. I'm sure others noticed the same trend.
> 
> So, why is this?
> 
> - Are the original (C/C++) docs really so scarse they don't appear at
>   the top of of the list? or...
> 
> - Is something in the google algorithms preferencial to anything but C?
> 
> - Are those docs maybe declared unaccessible by the spider engines?
>   (by robots.txt or so)

I guess library.gnome.org is just too new and maybe not linked that much yet (I
used good to search for sites that link to it and found links inside it).

> 
> - Or are those alternative languages just much more popular than C?
> 
> Which makes this question pop up: Wouldn't it be interesting/practical
> to have _common_ documentation. Say, GtkWidget is used in Python like
> this, in C like this, etc.? I could even serve as an educational tool
> to compare languages.
>
I though about this several times, but don't think it will work. Too much of the
api is specific to the environment.

Stefan

> 
> Just idle thoughts...
> 
> John
> ___
> gtk-app-devel-list mailing list
> gtk-app-devel-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list

___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list


Re: What's wrong with the docs?

2008-02-01 Thread Dan H.

> > - Is something in the google algorithms preferencial to anything but C?

In a way, yes. It's impossible to make C-specific queries because a single C
in the query is either ignored, or machtches pretty much the entire WWW. And
C API docs seldom mention the fact that they're intended to be used in a C
environment ;-)

--D.
___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list

Re: What's wrong with the docs?

2008-01-31 Thread Thomas Stover
I feel the same way. I can't think of an example off of the top of my 
head, but I swear there have been things that the only way I figured 
them out was by reading the python documentation and sort of guessing at 
the C API. Yes I look at the reference docs on gtk.org and gnome.org.
> Date: Wed, 30 Jan 2008 17:27:33 -0200
> From: John Coppens <[EMAIL PROTECTED]>
> Subject: What's wrong with the docs?
> To: gtk-app-devel-list@gnome.org
> Message-ID: <[EMAIL PROTECTED]>
> Content-Type: text/plain; charset=US-ASCII
>
> Hello all...
>
> There must be something terribly wrong somewhere, when I try to find
> documentation on operation with GTK+ or GDK elements, I always seem to
> get _much_ more documentation from the Python/Perl libraries than from
> the actual C interface. I'm sure others noticed the same trend.
>
> So, why is this?
>
> - Are the original (C/C++) docs really so scarse they don't appear at
>   the top of of the list? or...
>
> - Is something in the google algorithms preferencial to anything but C?
>
> - Are those docs maybe declared unaccessible by the spider engines?
>   (by robots.txt or so)
>
> - Or are those alternative languages just much more popular than C?
>
> Which makes this question pop up: Wouldn't it be interesting/practical
> to have _common_ documentation. Say, GtkWidget is used in Python like
> this, in C like this, etc.? I could even serve as an educational tool
> to compare languages.
>
> Just idle thoughts...
>
> John
>
>   
>


___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list


Re: What's wrong with the docs?

2008-01-30 Thread A. Walton
On Jan 30, 2008 2:27 PM, John Coppens <[EMAIL PROTECTED]> wrote:
> Hello all...
>
> There must be something terribly wrong somewhere, when I try to find
> documentation on operation with GTK+ or GDK elements, I always seem to
> get _much_ more documentation from the Python/Perl libraries than from
> the actual C interface. I'm sure others noticed the same trend.
>
> So, why is this?

Because Google is silly sometimes. Do yourself a favor and bookmark a link to
http://library.gnome.org/devel/ paying special attention to the
reference section
(the Guides are a bit out of date in places).

Good Luck!
-A. Walton
>
> John
> ___
> gtk-app-devel-list mailing list
> gtk-app-devel-list@gnome.org
> http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list
>
___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list


What's wrong with the docs?

2008-01-30 Thread John Coppens
Hello all...

There must be something terribly wrong somewhere, when I try to find
documentation on operation with GTK+ or GDK elements, I always seem to
get _much_ more documentation from the Python/Perl libraries than from
the actual C interface. I'm sure others noticed the same trend.

So, why is this?

- Are the original (C/C++) docs really so scarse they don't appear at
  the top of of the list? or...

- Is something in the google algorithms preferencial to anything but C?

- Are those docs maybe declared unaccessible by the spider engines?
  (by robots.txt or so)

- Or are those alternative languages just much more popular than C?

Which makes this question pop up: Wouldn't it be interesting/practical
to have _common_ documentation. Say, GtkWidget is used in Python like
this, in C like this, etc.? I could even serve as an educational tool
to compare languages.

Just idle thoughts...

John
___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list