--- a/states.py	Fri Jul 29 18:54:05 2011 +0200
+++ b/states.py	Mon Aug 01 14:12:48 2011 +0200
@@ -123,7 +123,16 @@
 
 
 def cmdstates(ui, repo, *states, **opt):
-    """show enabled states"""
+    """view and modify activated states.
+
+    With no argument, list activated state.
+
+    With argument, activate the state in argument.
+
+    With argument plus the --off switch, deactivate the state in argument.
+
+    note: published state are alway activated."""
+
     if not states:
         for st in sorted(repo._enabledstates):
             ui.write('%s\n' % st)