--- a/CharacterEncoder.st	Tue Dec 06 07:06:38 2016 +0100
+++ b/CharacterEncoder.st	Sun Dec 18 11:19:27 2016 +0000
@@ -1666,6 +1666,8 @@
 !CharacterEncoder::InverseEncoder methodsFor:'queries'!
 
 characterSize:charOrcodePoint
+    "return the number of bytes required to encode codePoint"
+
     ^ decoder characterSize:charOrcodePoint
 ! !
 
@@ -1780,6 +1782,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)