GLib Dependency Model

2007-08-15 Thread Emilio Monti
Recently I have developed a python script that scans all the symbols
defined in a group of object files and libraries (through nm), it
checks the inter-dependencies and it generates a "Lattix Data Import"
xml file ready to be imported in Lattix.

My first test case has been the GLib:
http://www.emilmont.net/doku.php?id=python:dependency_model

In that "test case" there is an highlighting of the cross-dependencies
of the "core" of the glib.

It also shows that different objects could be left out of the library,
even without conditional compilation, but just at link time.

Of course, GLib doesn't need to left out any object currently
included, but the fact that there is the possibility to do so is, in
my opinion, an index of the good quality of the GLib design.

Do not hesitate to ask me Dependency Model for other open source
libraries if you find them useful.

Kind regards,
Emilio Monti
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-devel-list


Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

2007-08-15 Thread Behdad Esfahbod
On Tue, 2007-08-14 at 16:31 -0400, Olav Vitters wrote: 
> GTK+ is the main user of the developer API reference with links from:
>   http://www.gtk.org/api/
> 
> I want to redirect:
>   http://developer.gnome.org/doc/API/2.0/
> to:
>   http://library.gnome.org/developer/
> 
> See for instance the GTK+ API reference on:
>   http://library.gnome.org/developers/gtk/2.11/

Looks very nice.  Minor comments:

  - In http://library.gnome.org/developers/pango/ I see the following
available versions:

  * 1.10
  * 1.12
  * 1.14
  * 1.16
  * 1.17

It makes sense to clearly mark 1.17 as devel/unstable.

  - Like others have said already, a
http://library.gnome.org/developers/pango/latest alias that links to the
latest stable release may make sense.

  - Why not list the minor version of each of those available versions?

  - The page http://library.gnome.org/developers/ links to a specific
version, not the listing.  How is one supposed to get to the listing?

  - This one may need changes in gtk-doc, but would be very useful if we
could have something like
http://library.gnome.org/developers/pango/symbols/pango_layout_set_text
and have it work.  In fact, what would be more useful would be to make
http://library.gnome.org/pango_layout_set_text redirect to where it
should.  That's how php.net works and it has been extremely useful.  If
I want to read docs for the function phpinfo(), I go to
http://php.net/phpinfo

> Note: GNOME Library currently finds new tarballs every night. At one
> point this will start after install-module runs (low priority right
> now).
> 
> If nobody objects within a week I'll make this change.


Cheers,

-- 
behdad
http://behdad.org/

"Those who would give up Essential Liberty to purchase a little
 Temporary Safety, deserve neither Liberty nor Safety."
-- Benjamin Franklin, 1759



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


Re: No new GLib announcements on gtk.org

2007-08-15 Thread Matthias Clasen
On 8/14/07, Tshepang Lekhonkhobe <[EMAIL PROTECTED]> wrote:
> On 3/3/07, Ben Combee <[EMAIL PROTECTED]> wrote:
> > I just realized that GLIb 2.12.9 had been released almost a month ago
> > after seeing it mentioned in a message here.  Is there a reason that
> > the main page of gtk.org doesn't have any 2007 updates?
>
> It's just an issue of manpower. Look at: http://live.gnome.org/GtkTasks

I have updated the web page now.
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-devel-list


Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

2007-08-15 Thread Frederic Peters
David Nečas (Yeti) wrote:

> > do you believe a "latest" symlink would
> > be useful ?  As well as a "stable" symlink ?
> 
> A stable or latest alias would be definitely useful, but...

This has been taken care of.


> Let me explain: The conclusion on gtk-doc was that it is not
> feasible to keep the on-line location of everything in
> gtk-doc, instead libraries should advertise their on-line
> reference base URLs (if there is any) and a mechanisms for
> this and for base URL switching/correction have been already
> implemented.
> 
> This would work well with the current state when each
> library has one on-line location (containing the latest
> version).  The new scheme leaves me wondering what to do
> when one just wants to link to GObject (gboolean, whatever)
> documentation.  What is the canonical link?  Is there any?

Okay, I understand your problem now.  Although I don't have a perfect
answer.  Canonical link would be
  http://library.gnome.org/developers/{doc_module}/latest/{whatever}

Current directory layout is the only one making sense if we want to
maintain several versions in library.gnome.org; however we could
probably devise a few mod_rewrite rules to expose other URI schemes,
such as http://library.gnome.org/api/{doc_module}/{whatever}.



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


Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

2007-08-15 Thread Frederic Peters
Murray Cumming wrote:

> > http://library.gnome.org/developers/gtk/ is a page listing available
> > versions of the documentation; do you believe a "latest" symlink would
> > be useful ?  As well as a "stable" symlink ?
> 
> I would [find] them very useful.

I just ran an update on library.gnome.org and such links are now
installed; 
  http://library.gnome.org/developers/gtk/stable/
  http://library.gnome.org/developers/gtk/latest/


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


Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

2007-08-15 Thread Yeti
On Tue, Aug 14, 2007 at 11:26:03PM +0200, Frederic Peters wrote:
> David Nečas (Yeti) wrote:
> > 
> > What is the unversioned link to the latest available API
> > reference of a library?
> 
> http://library.gnome.org/developers/gtk/ is a page listing available
> versions of the documentation;

But this does not allow to construct links, because

  
http://library.gnome.org/developers/gobject/gobject-The-Base-Object-Type.html#GObject

does not exist, only versioned URLs such as

  
http://library.gnome.org/developers/gobject/2.10/gobject-The-Base-Object-Type.html#GObject

I want to fix a particular cross-library link, for instance

  
/home/mclasen/gnome-2.18/install/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject

in Gtk+ API reference to something equivalent to

  
http://developer.gnome.org/doc/API/2.0/gobject/gobject-The-Base-Object-Type.html#GObject

So, if only versioned URLs were available, the links would
have to point to a random version of GObject, determined by
what the guy making dists had installed.

> do you believe a "latest" symlink would
> be useful ?  As well as a "stable" symlink ?

A stable or latest alias would be definitely useful, but...
Let me explain: The conclusion on gtk-doc was that it is not
feasible to keep the on-line location of everything in
gtk-doc, instead libraries should advertise their on-line
reference base URLs (if there is any) and a mechanisms for
this and for base URL switching/correction have been already
implemented.

This would work well with the current state when each
library has one on-line location (containing the latest
version).  The new scheme leaves me wondering what to do
when one just wants to link to GObject (gboolean, whatever)
documentation.  What is the canonical link?  Is there any?

Also, the possibility to use relative links such as

  ../gobject/gobject-The-Base-Object-Type.html#GObject

that would work both on-line and in the typical off-line
installation has been lost as the new URLs are one directory
level more separated, though this is not a big problem.

Yeti

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


Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

2007-08-15 Thread Murray Cumming

On Tue, 2007-08-14 at 23:26 +0200, Frederic Peters wrote:
> David Nečas (Yeti) wrote:
> 
> > > See for instance the GTK+ API reference on:
> > >   http://library.gnome.org/developers/gtk/2.11/
> > 
> > What is the unversioned link to the latest available API
> > reference of a library?
> 
> http://library.gnome.org/developers/gtk/ is a page listing available
> versions of the documentation; do you believe a "latest" symlink would
> be useful ?  As well as a "stable" symlink ?

I would them very useful.

library.gnome.org is looking really good.

-- 
[EMAIL PROTECTED]
www.murrayc.com
www.openismus.com

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


Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

2007-08-15 Thread Arnaud Charlet
> http://library.gnome.org/developers/gtk/ is a page listing available
> versions of the documentation; do you believe a "latest" symlink would
> be useful ?  As well as a "stable" symlink ?

Yes, that would be useful indeed.

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