--- a/CharacterEncoder.st	Thu Dec 15 13:58:52 2016 +0100
+++ b/CharacterEncoder.st	Thu Dec 15 14:04:40 2016 +0100
@@ -1666,6 +1666,8 @@
 !CharacterEncoder::InverseEncoder methodsFor:'queries'!
 
 characterSize:charOrcodePoint
+    "return the number of bytes required to encode codePoint"
+
     ^ decoder characterSize:charOrcodePoint
 ! !
 
@@ -1768,6 +1770,8 @@
 !CharacterEncoder::TwoStepEncoder methodsFor:'queries'!
 
 characterSize:codePoint
+    "return the number of bytes required to encode codePoint"
+
     "/ naive; actually, we have to do a real encoding to get this info proper
     ^ (encoder2 characterSize:codePoint)