MLKBinding, MLKCharacter: Document.

2 files changed, 92 insertions, 1 deletions

diff --git a/MLKBinding.h b/MLKBinding.h
index 0206bdc..725037f 100644
--- a/MLKBinding.h
+++ b/MLKBinding.h
@@ -26,16 +26,52 @@
 
 +(void) initialize;
 
+/* Function: -init
+
+  Initalise unbound binding cell.
+*/
 -(MLKBinding *) init;
+
+/* Function: -initWithValue:
+
+  Initialise binding cell with a value to bind.
+*/
 -(MLKBinding *) initWithValue:(id)something;
 
+/* Function: +binding
+
+  Construct an unbound binding cell.
+*/
 +(MLKBinding *) binding;
+
+/* Function: +bindingWithValue:
+
+  Construct a bound binding cell with a value to bind.
+*/
 +(MLKBinding *) bindingWithValue:(id)something;
 
+/* Function: -setValue:
+
+  Change the binding's bound value.
+*/
 -(void) setValue:(id)something;
+
+/* Function: -value
+
+  Access the binding's bound value.
+*/
 -(id) value;
 
+/* Function: -boundp
+
+  Determine whether the binding cell is non-empty.
+*/
 -(BOOL) boundp;
+
+/* Function: -makunbound
+
+  Empty the binding.
+*/
 -(void) makunbound;
 
 -(void) dealloc;
diff --git a/MLKCharacter.h b/MLKCharacter.h
index def7142..c87327d 100644
--- a/MLKCharacter.h
+++ b/MLKCharacter.h
@@ -24,20 +24,75 @@
   unichar unichar;
 }
 
+/* Function: -initWithUnichar:
+
+  Initialise character with a given numeric value.
+*/
 -(MLKCharacter *) initWithUnichar:(unichar)anUnichar;
 
+/* Function: +characterWithUnichar:
+
+  Construct a character with a given numeric value.
+*/
 +(MLKCharacter *) characterWithUnichar:(unichar)anUnichar;
 
+/* Function: -unicharValue
+
+  Access the character's numeric value.
+*/
 -(unichar) unicharValue;
 
+/* Function: -uppercaseCharacter
+
+  Return the uppercase form of the character.
+
+  If the character does not have case, -uppercaseCharacter returns self.
+*/
 -(MLKCharacter *) uppercaseCharacter;
+
+/* Function: -lowercaseCharacter
+
+  Return the lowercase form of the character.
+
+  If the character does not have case, -lowercaseCharacter returns self.
+*/
 -(MLKCharacter *) lowercaseCharacter;
 
+/* Function: -uppercaseCharacter
+
+  Return the uppercase form of the character as a numeric value.
+
+  If the character does not have case, -uppercaseChar returns [self unicharValue].
+*/
 -(unichar) uppercaseChar;
--(unichar) lowercaseChar;
 
+/* Function: -uppercaseChar
+
+  Return the lowercase form of the character as a numeric value.
+
+  If the character does not have case, -lowercaseChar returns [self unicharValue].
+*/
+-(unichar) uppercaseCharForChar;
+
+/* Function: +uppercaseCharForChar:
+
+  Convert a unichar to its corresponding uppercase version.
+
+  If the character does not have case, the argument is returned unchanged.
+*/
 +(unichar) uppercaseCharForChar:(unichar)ch;
+
+/* Function: +lowercaseCharForChar:
+
+  Convert a unichar to its corresponding lowercase version.
+
+  If the character does not have case, the argument is returned unchanged.
+*/
 +(unichar) lowercaseCharForChar:(unichar)ch;
 
+/* Function: -isEqual:
+
+  Test whether two <MLKCharacter>s represent the same character.
+*/
 -(BOOL) isEqual:(id)thing;
 @end