mercurial/ui.py

--- a/mercurial/ui.py	Mon Jun 07 18:35:54 2010 +0200
+++ b/mercurial/ui.py	Thu Jun 03 23:18:18 2010 -0500
@@ -546,5 +546,9 @@
 
         ui.write(s, 'label') is equivalent to
         ui.write(ui.label(s, 'label')).
+
+        Callers of ui.label() should pass labeled text back to
+        ui.write() with a label of 'ui.labeled' so implementations know
+        that the text has already been escaped and marked up.
         '''
         return msg