Mark modules as STABLE/UNSTABLE/DEPRECATED.

5 files changed, 20 insertions, 1 deletions

diff --git a/src/sugar/activity/activity.py b/src/sugar/activity/activity.py
index 4d5fa7c..500143a 100644
--- a/src/sugar/activity/activity.py
+++ b/src/sugar/activity/activity.py
@@ -26,6 +26,8 @@ interesting buttons for the user, like for example 'exit activity'
 
 See the methods of the Activity class below for more information on what you
 will need for a real activity.
+
+STABLE.
 """
 # Copyright (C) 2006-2007 Red Hat, Inc.
 # Copyright (C) 2007-2008 One Laptop Per Child
diff --git a/src/sugar/activity/activityfactory.py b/src/sugar/activity/activityfactory.py
index 97583a0..e92314d 100644
--- a/src/sugar/activity/activityfactory.py
+++ b/src/sugar/activity/activityfactory.py
@@ -1,4 +1,3 @@
-"""Shell side object which manages request to start activity"""
 # Copyright (C) 2006-2007 Red Hat, Inc.
 #
 # This library is free software; you can redistribute it and/or
@@ -16,6 +15,12 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""Shell side object which manages request to start activity
+
+UNSTABLE. Activities are currently not allowed to run other activities so at
+the moment there is no reason to stabilize this API.
+"""
+
 import logging
 
 import dbus
diff --git a/src/sugar/activity/activityhandle.py b/src/sugar/activity/activityhandle.py
index 3f4a44c..f255fd5 100644
--- a/src/sugar/activity/activityhandle.py
+++ b/src/sugar/activity/activityhandle.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 class ActivityHandle(object):
     """Data structure storing simple activity metadata"""
     def __init__(
diff --git a/src/sugar/activity/activityservice.py b/src/sugar/activity/activityservice.py
index b2f7e15..81bd6dd 100644
--- a/src/sugar/activity/activityservice.py
+++ b/src/sugar/activity/activityservice.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+UNSTABLE. It should really be internal to the Activity class.
+"""
+
 import logging
 
 import dbus
diff --git a/src/sugar/activity/bundlebuilder.py b/src/sugar/activity/bundlebuilder.py
index ce8787a..ab3679b 100644
--- a/src/sugar/activity/bundlebuilder.py
+++ b/src/sugar/activity/bundlebuilder.py
@@ -15,6 +15,10 @@
 # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 # Boston, MA 02111-1307, USA.
 
+"""
+STABLE.
+"""
+
 import os
 import sys
 import zipfile