Added more header documentation

Author: TimOliver

TOPasscodeViewController/Views/Main/TOPasscodeView.h

@@ -106,7 +106,7 @@ NS_ASSUME_NONNULL_BEGIN
 /*
  Reset the passcode to nil and optionally play animation / vibration to match
 
- @param animated Play a shaking animation to reset the password.
+ @param animated Play a shaking animation to reset the passcode.
  @param impact On supported devices, play a small reset vibration as well.
  */
 - (void)resetPasscodeAnimated:(BOOL)animated playImpact:(BOOL)impact;

TOPasscodeViewController/Views/Settings/TOPasscodeSettingsKeypadButton.h

@@ -27,7 +27,6 @@
 /**
  A single button view that is used in a number keypad views styled in
  a pseudo-skeuomorphic style.
-
  */
 @interface TOPasscodeSettingsKeypadButton : UIButton
 

TOPasscodeViewController/Views/Settings/TOPasscodeSettingsKeypadView.h

@@ -25,6 +25,10 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
+/**
+ A keypad view of 9 buttons that allow numerical input on both iPad and iPhone.
+ Designed to match the base system, with a pseudo-skeuomorphical styling.
+ */
 @interface TOPasscodeSettingsKeypadView : UIView
 
 /* Whether the control is allowing input */

TOPasscodeViewController/Views/Settings/TOPasscodeSettingsWarningLabel.h

@@ -22,6 +22,10 @@
 
 #import <UIKit/UIKit.h>
 
+/**
+ When a user enters an incorrect passcode in the settings interface,
+ this view is displayed to show the number of failed attempts.
+ */
 @interface TOPasscodeSettingsWarningLabel : UIImageView
 
 /** The number of incorrect passcode attempts to display */

TOPasscodeViewController/Views/Shared/TOPasscodeButtonLabel.h

@@ -24,6 +24,10 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
+/**
+ A view that manages two label subviews: a larger label showing a single number
+ and a smaller label showing lettering as well.
+ */
 @interface TOPasscodeButtonLabel : UIView
 
 // Draws the lettering label to the side

TOPasscodeViewController/Views/Shared/TOPasscodeCircleView.h

@@ -24,6 +24,11 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
+/**
+ A view containing two circle image views that can animate
+ between filled and hollow, whilst maintaining compatibility
+ with translucency views.
+ */
 @interface TOPasscodeCircleView : UIView
 
 /* The circle patterns used for neutral and highlighted states. */

TOPasscodeViewController/Views/Shared/TOPasscodeFixedInputView.h

@@ -24,6 +24,10 @@
 
 @class TOPasscodeCircleView;
 
+/**
+ A basic content view showing a row of circles that can be used to represent
+ a fixed size passcode.
+ */
 @interface TOPasscodeFixedInputView : UIView
 
 /* The size of each circle in this view (Default is 16) */

TOPasscodeViewController/Views/Shared/TOPasscodeInputField.h

@@ -33,6 +33,11 @@ typedef NS_ENUM(NSInteger, TOPasscodeInputFieldStyle) {
     TOPasscodeInputFieldStyleVariable  // The passcode can be any arbitrary number of characters (Shows an empty rectangle)
 };
 
+/**
+ An abstract input view capable of receiving different types of passcodes.
+ When a fixed character passcode is specified, the view shows a row of circles.
+ When a variable passcode is specified, a rounded rectangle is shown.
+ */
 @interface TOPasscodeInputField : UIView <UIKeyInput>
 
 /* The visual effects view used to control the vibrancy of the input field */
@@ -86,7 +91,7 @@ typedef NS_ENUM(NSInteger, TOPasscodeInputFieldStyle) {
 /* Init with the target length needed for this passcode */
 - (instancetype)initWithStyle:(TOPasscodeInputFieldStyle)style;
 
-/* Replace the passcode with this one, and animate the transition */
+/* Replace the passcode with this one, and animate the transition. */
 - (void)setPasscode:(nullable NSString *)passcode animated:(BOOL)animated;
 
 /* Add additional characters to the end of the passcode, and animate if desired. */
@@ -98,7 +103,7 @@ typedef NS_ENUM(NSInteger, TOPasscodeInputFieldStyle) {
 /* Plays a shaking animation and resets the passcode back to empty */
 - (void)resetPasscodeAnimated:(BOOL)animated playImpact:(BOOL)impact;
 
-/* Animates the OK button changing location */
+/* Animates the OK button changing location. */
 - (void)setHorizontalLayout:(BOOL)horizontalLayout animated:(BOOL)animated duration:(CGFloat)duration;
 
 @end

TOPasscodeViewController/Views/Shared/TOPasscodeVariableInputView.h

@@ -22,6 +22,10 @@
 
 #import <UIKit/UIKit.h>
 
+/**
+ A basic content view showing a rounded rectangle containing circles that can be used to represent
+ a variable size passcode.
+ */
 @interface TOPasscodeVariableInputView : UIImageView
 
 /* The thickness of the stroke around the view (Default is 1.5) */