Mark modules as STABLE/UNSTABLE/DEPRECATED.

21 files changed, 86 insertions, 11 deletions

diff --git a/src/sugar/graphics/alert.py b/src/sugar/graphics/alert.py
index 13a4a51..6cfa0fa 100644
--- a/src/sugar/graphics/alert.py
+++ b/src/sugar/graphics/alert.py
@@ -25,6 +25,7 @@ create a simple alert message.
         self.add_alert(alert)
         alert.show()
 
+STABLE.
 """
 # Copyright (C) 2007, One Laptop Per Child
 #
diff --git a/src/sugar/graphics/animator.py b/src/sugar/graphics/animator.py
index 347b1d8..5d5b355 100644
--- a/src/sugar/graphics/animator.py
+++ b/src/sugar/graphics/animator.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import time
 
 import gobject
diff --git a/src/sugar/graphics/combobox.py b/src/sugar/graphics/combobox.py
index 4c43f99..4e094ab 100644
--- a/src/sugar/graphics/combobox.py
+++ b/src/sugar/graphics/combobox.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gobject
 import gtk
 
diff --git a/src/sugar/graphics/entry.py b/src/sugar/graphics/entry.py
index 08ea3ca..62975da 100644
--- a/src/sugar/graphics/entry.py
+++ b/src/sugar/graphics/entry.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gtk
 import hippo
 
diff --git a/src/sugar/graphics/icon.py b/src/sugar/graphics/icon.py
index 40627c7..37af191 100644
--- a/src/sugar/graphics/icon.py
+++ b/src/sugar/graphics/icon.py
@@ -1,7 +1,3 @@
-"""
-A small fixed size picture, typically used to decorate components.
-
-"""
 # Copyright (C) 2006-2007 Red Hat, Inc.
 #
 # This library is free software; you can redistribute it and/or
@@ -19,6 +15,12 @@ A small fixed size picture, typically used to decorate components.
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+A small fixed size picture, typically used to decorate components.
+
+STABLE.
+"""
+
 import re
 import math
 import logging
diff --git a/src/sugar/graphics/menuitem.py b/src/sugar/graphics/menuitem.py
index 3d6764b..70c08f7 100644
--- a/src/sugar/graphics/menuitem.py
+++ b/src/sugar/graphics/menuitem.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gtk
 from sugar.graphics.icon import Icon
 
diff --git a/src/sugar/graphics/notebook.py b/src/sugar/graphics/notebook.py
index e159bb3..4965b24 100644
--- a/src/sugar/graphics/notebook.py
+++ b/src/sugar/graphics/notebook.py
@@ -1,10 +1,3 @@
-"""Notebook class
-
-This class create a gtk.Notebook() widget supporting 
-a close button in every tab when the 'can-close-tabs' gproperty
-is enabled (True)
-"""
-
 # Copyright (C) 2007, Eduardo Silva (edsiper@gmail.com)
 #
 # This library is free software; you can redistribute it and/or
@@ -22,6 +15,15 @@ is enabled (True)
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""Notebook class
+
+This class create a gtk.Notebook() widget supporting 
+a close button in every tab when the 'can-close-tabs' gproperty
+is enabled (True)
+
+STABLE.
+"""
+
 import gtk
 import gobject
 
diff --git a/src/sugar/graphics/objectchooser.py b/src/sugar/graphics/objectchooser.py
index 861d0ab..1188b04 100644
--- a/src/sugar/graphics/objectchooser.py
+++ b/src/sugar/graphics/objectchooser.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import logging
 
 import gobject
diff --git a/src/sugar/graphics/palette.py b/src/sugar/graphics/palette.py
index 71eb8a8..706bc1c 100644
--- a/src/sugar/graphics/palette.py
+++ b/src/sugar/graphics/palette.py
@@ -16,6 +16,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import logging
 
 import gtk
diff --git a/src/sugar/graphics/palettegroup.py b/src/sugar/graphics/palettegroup.py
index bdae76b..e95b5aa 100644
--- a/src/sugar/graphics/palettegroup.py
+++ b/src/sugar/graphics/palettegroup.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gobject
 
 _groups = {}
diff --git a/src/sugar/graphics/panel.py b/src/sugar/graphics/panel.py
index bf3ed24..bc48db8 100644
--- a/src/sugar/graphics/panel.py
+++ b/src/sugar/graphics/panel.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gtk
 
 class Panel(gtk.VBox):
diff --git a/src/sugar/graphics/radiotoolbutton.py b/src/sugar/graphics/radiotoolbutton.py
index 1fb18cc..11f962d 100644
--- a/src/sugar/graphics/radiotoolbutton.py
+++ b/src/sugar/graphics/radiotoolbutton.py
@@ -16,6 +16,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gtk
 import gobject
 
diff --git a/src/sugar/graphics/roundbox.py b/src/sugar/graphics/roundbox.py
index 573344e..28644bc 100644
--- a/src/sugar/graphics/roundbox.py
+++ b/src/sugar/graphics/roundbox.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import math
 
 import hippo
diff --git a/src/sugar/graphics/style.py b/src/sugar/graphics/style.py
index 5b74bc5..16b78ed 100644
--- a/src/sugar/graphics/style.py
+++ b/src/sugar/graphics/style.py
@@ -18,6 +18,8 @@
 """
 All the constants are expressed in pixels. They are defined for the XO screen
 and are usually adapted to different resolution by applying a zoom factor.
+
+STABLE.
 """
 
 import os
diff --git a/src/sugar/graphics/toggletoolbutton.py b/src/sugar/graphics/toggletoolbutton.py
index 35c4bf1..9bb2f58 100644
--- a/src/sugar/graphics/toggletoolbutton.py
+++ b/src/sugar/graphics/toggletoolbutton.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gobject
 import gtk
 
diff --git a/src/sugar/graphics/toolbox.py b/src/sugar/graphics/toolbox.py
index f0889be..1cfbe93 100644
--- a/src/sugar/graphics/toolbox.py
+++ b/src/sugar/graphics/toolbox.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gtk
 import gobject
 import hippo
diff --git a/src/sugar/graphics/toolbutton.py b/src/sugar/graphics/toolbutton.py
index a80c67a..6205b8a 100644
--- a/src/sugar/graphics/toolbutton.py
+++ b/src/sugar/graphics/toolbutton.py
@@ -16,6 +16,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import logging
 
 import gtk
diff --git a/src/sugar/graphics/toolcombobox.py b/src/sugar/graphics/toolcombobox.py
index 460dcee..16e14bd 100644
--- a/src/sugar/graphics/toolcombobox.py
+++ b/src/sugar/graphics/toolcombobox.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gtk
 import gobject
 
diff --git a/src/sugar/graphics/tray.py b/src/sugar/graphics/tray.py
index 21ecbb0..5df7170 100644
--- a/src/sugar/graphics/tray.py
+++ b/src/sugar/graphics/tray.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gobject
 import gtk
 
diff --git a/src/sugar/graphics/window.py b/src/sugar/graphics/window.py
index ced5595..1ad2bca 100644
--- a/src/sugar/graphics/window.py
+++ b/src/sugar/graphics/window.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import gobject
 import gtk
 
diff --git a/src/sugar/graphics/xocolor.py b/src/sugar/graphics/xocolor.py
index d5e906f..beb9565 100644
--- a/src/sugar/graphics/xocolor.py
+++ b/src/sugar/graphics/xocolor.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import random
 
 colors = [