Re: What's wrong with the docs?
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?
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?
> > - 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?
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?
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?
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