O GTK 2 possui diversas classes de widgets novas. A maioria das classes faz algo melhor ou de uma forma diferente que as outras classes; então os widgets antigos tornaram-se obsoletos em favor dos novos.

Para manter compatibilidade, os widgets antigos ainda podem ser usados, mas podem ser removidos em um possível GTK 3 e assim por diante. Isto significa que você não precisa reescrever seu programa completamente, mas ainda pode usá-lo sem muitas mudanças. Entretanto, você não deve usar qualquer um dos widgets obsoletos nos seus novos programas. Não façam isso!

A lista pode não estar completa. Se você encontrar algum widget obsoleto que não está listado aqui, por favor, escreva para php-gtk-doc.