Re: Features Page

Nice work Anant. A few comments though... Anant Narayanan wrote:

<h1>PHP-GTK 2 Features</h1> object-orientation and a rich widget base. Although PHP-GTK 2 is mostly backwards compatible, it is broken where necessary. This page

This makes it sound like PHP-GTK 2 is broken where necessary. How about something like, "Although every attempt has been made to maintain backward compatibility, some backward compatibility breaks were necessary." Also, can we really consider PHP-GTK 2 mostly backward compatible? The change in how constants are handled enough to break even the simplest PHP-GTK 1 apps when running in PHP-GTK 2.

<li><b>Atk and Pango support</b><br /> Although the alpha release of PHP-GTK 2 does not include support for

Use zeta instead of alpha. (This will be somewhat explained in the release announcement)

<li><b>Connecting Signals</b><br /> The semantically confusing connect_object() method of PHP-GTK 1 has been deprecated in favor of simpler substitutes, connect() and connect_simple().

semantically confusing connect_object() and connect_object_after() methods ... substitutes, connect_simple() and connect_simple_after(). Also, these methods should probably link to the docs page. In fact, it might not be a bad idea to link any classes, methods or constants to their respective docs pages.

<li><b>Deprecated Widgets</b><br /> Some of the older widgets have been deprecated in favor of more powerful and easy to use widgets. Although the deprecated widgets will still work with PHP-GTK, you will receive a warning that urges you to use the new replacement widget instead. </ul>

There should be a link to the deprecated widgets page somewhere in this block. I am not recommending any changes here but keep in mind that "deprecated widgets will still work" is not always true. GtkText never worked to begin with.

<p> We've covered these differences in more detail in the 'Changes since PHP-GTK 1' tutorial. Do have a look at that to make your transition from PHP-GTK 1 to 2 easier. The documentation is an invaluable resource, and of course the mailing lists are always there to help you out in troublesome situations. Hope you enjoy using PHP-GTK 2 as much as we enjoyed making it! </p>

Links!