Updated TextInput documentation for clarity. Cleaned up spacing in some of the other docs as well.

Author: msfterictraut

docs/docs/apis/app.md

@@ -22,7 +22,8 @@ enum AppActivationState {
     // App is inactive (not actively running)
     Inactive = 3,
 
-    // iOS specific activation state for extensions implemented with react-native
+    // iOS specific activation state for extensions implemented 
+    // with react-native
     Extension = 4
 }
 ```

docs/docs/apis/popup.md

@@ -30,13 +30,15 @@ interface PopupOptions {
     renderPopup: (anchorPosition: PopupPosition, anchorOffset: number,
         popupWidth: number, popupHeight: number) => ReactNode;
 
-    // Returns a mounted component instance that controls the triggering of the popup.
-    // In the majority of cases, "anchor" of popup has handlers to control when the popup
-    // will be seen and this function is not required. In a few cases, where anchor is
-    // not the same as the whole component that triggers when the popup wil be seen,
-    // this can be used. For instance, a button combined with a chevron icon, which on
-    // click triggers a popup below the chevron icon. In this example,
-    // getElementTriggeringPopup() can return the container with button and chevron icon.
+    // Returns a mounted component instance that controls the triggering
+    // of the popup. In the majority of cases, "anchor" of popup has
+    // handlers to control when the popup will be seen and this function
+    // is not required. In a few cases, where anchor is not the same as
+    // the whole component that triggers when the popup wil be seen,
+    // this can be used. For instance, a button combined with a chevron
+    // icon, which on click triggers a popup below the chevron icon. In
+    // this example, getElementTriggeringPopup() can return the container
+    // with button and chevron icon.
     getElementTriggeringPopup?: () => React.Component<any, any>;
 
     // Called when the popup is dismissed.
@@ -51,8 +53,8 @@ interface PopupOptions {
     // In this mode only the first position priority will be used.
     useInnerPositioning?: boolean;
 
-    // On pressed handler to notify whoever wanted to create the popup that its
-    // anchor has been pressed.
+    // On pressed handler to notify whoever wanted to create the popup
+    // that its anchor has been pressed.
     // IMPORTANT NOTE: This handler may be called when the component is
     // already unmounted as it uses a time delay accommodate 
     // fade-out animations.
@@ -74,7 +76,8 @@ interface PopupOptions {
 ## Methods
 
 ``` javascript
-// Dismisses an already-displayed popup after a specified number of milliseconds
+// Dismisses an already-displayed popup after a specified number
+// of milliseconds
 autoDismiss(popupId: string, dismissDelay: number = 0): void;
 
 // Dismisses an already-displayed popup immediately

docs/docs/components/button.md

@@ -26,7 +26,8 @@ accessibilityHidden: boolean = false;
 accessibilityTraits: AccessibilityTrait | AccessibilityTrait[] = undefined;
 
 // Region for accessibility mechanisms
-accessibilityLiveRegion: AccessibilityLiveRegion = undefined; // Android and web only
+accessibilityLiveRegion: AccessibilityLiveRegion =
+    undefined; // Android and web only
 
 // Expose the element and/or its children as accessible to Screen readers
 importantForAccessibility?: ImportantForAccessibility = ImportantForAccessibility.yes;
@@ -37,7 +38,8 @@ delayLongPress: number = 1000;
 // If disabled, touch and mouse input events are ignored
 disabled: boolean = false;
 
-// Called when VoiceOver is on and the user double tapped to activate a control
+// Called when VoiceOver is on and the user double tapped to
+// activate a control
 onAccessibilityTapIOS: (e: SyntheticEvent) => void; // iOS Only
 
 // Called when the user has pressed and held for a specified duration
@@ -47,13 +49,15 @@ onLongPress: (e: SyntheticEvent) => void;
 onHoverStart: (e: SyntheticEvent) => void;
 onHoverEnd: (e: SyntheticEvent) => void;
 
-// Called when the touch or mouse button is released within the bounds of the view and the press has not been canceled
+// Called when the touch or mouse button is released within the
+// bounds of the view and the press has not been canceled
 onPress: (e: SyntheticEvent) => void;
 
 // Called when touch is initiated or mouse button is pressed
 onPressIn: (e: SyntheticEvent) => void;
 
-// Called when touch or the mouse button is released or the user's finger or mouse cursor is no longer over the view
+// Called when touch or the mouse button is released or the
+// user's finger or mouse cursor is no longer over the view
 onPressOut: (e: SyntheticEvent) => void;
 
 // Rasterize contents using offscreen bitmap (perf optimization)

docs/docs/components/gestureview.md

@@ -35,8 +35,8 @@ preferredPan: PreferredPanGesture = undefined; // Horizontal or vertical
 // pan is recognized? Default is 10. Can be any value > 0.
 panPixelThreshold: number = undefined;
 
-// Something else wants to become responder. Should this view release the responder?
-// Setting true allows release
+// Something else wants to become responder. Should this view
+// release the responder? Setting true allows release.
 releaseOnRequest: boolean = false;
 
 // Alternate text for screen readers.

docs/docs/components/scrollview.md

@@ -9,7 +9,7 @@ next: components/text
 
 Like a View, this component is a container for other components. However, it supports scrolling (panning) and zooming so it is possible to view larger contents. 
 
-ScrollViews must have a bounded height (or width, if it scrolls horizontally) since its children are of unbounded height (or width). To bound the dimensions of a ScrollView, either set the height/width directly or make sure that its parent's height/width is bounded.
+ScrollViews must have a bounded height (or width, if it scrolls horizontally) since its children are of unbounded height (or width). To bound the dimensions of a ScrollView, either set the height/width directly or make sure that its parent's height/width is bounded.
 
 ## Props
 ``` javascript
@@ -27,7 +27,8 @@ justifyEnd: boolean = false;
 // When the user scrolls the view, how should the on-screen keyboard react?
 keyboardDismissMode: 'none' | 'interactive' | 'on-drag'; // Native only
 
-// Should the on-screen keyboard remain visible when the user taps the scroll view?
+// Should the on-screen keyboard remain visible when the user taps
+// the scroll view?
 keyboardShouldPersistTaps: boolean = false; // Native only
 
 // Maximum scale factor

docs/docs/components/text.md

@@ -27,7 +27,8 @@ accessibilityHidden: boolean = false;
 accessibilityTraits: AccessibilityTrait | AccessibilityTrait[] = undefined;
 
 // Region for accessibility mechanisms
-accessibilityLiveRegion: AccessibilityLiveRegion = undefined; // Android and web only
+accessibilityLiveRegion: AccessibilityLiveRegion =
+    undefined; // Android and web only
 
 // Should fonts be scaled according to system setting?
 allowFontScaling: boolean = true; // Android and iOS only

docs/docs/components/textinput.md

@@ -9,6 +9,8 @@ next: components/view
 
 This component provides basic text input capabilities.
 
+It can be used in one of two modes. In the first mode, the contents of the text input are static and are specified by the `value` prop. Any attempt to modify the value will result in `onChangeText`, which allows the owning component to re-render with an updated `value`. In the second mode, `value` is unspecified, and the text input value is allowed to be modified as long as it remains mounted. In this mode, the caller can specify an optional `defaultValue` prop to specify the initial value.
+
 ## Props
 In addition to the [common accessibility props](/reactxp/docs/accessibility.html), the following props are supported.
 
@@ -43,8 +45,8 @@ keyboardAppearance: 'default' | 'light' | 'dark';
 // On-screen keyboard type to display
 keyboardType: 'default' | 'numeric' | 'email-address' | 'number-pad';
 
-// Should the scale multiplier be capped when allowFontScaling is set to true?
-// Possible values include the following:
+// Should the scale multiplier be capped when allowFontScaling is
+// set to true? Possible values include the following:
 // null/undefined (default) - inheret from parent/global default
 // 0 - no max
 // >= 1 - sets the maxContentSizeMultiplier of this node to this value
@@ -78,7 +80,8 @@ onScroll: (newScrollTop: number, newScrollLeft: number) => void = undefined;
 // Called when the selection range or insertion point location changes
 onSelectionChange: (start: number, end: number) => void = undefined;
 
-// Called when the text input submit button is pressed; invalid if multiline is true
+// Called when the text input submit button is pressed; invalid if 
+// multiline is true
 onSubmitEditing: () => void = undefined;
 
 // Placeholder text to dislpay when input is empty
@@ -103,7 +106,8 @@ style: TextInputStyleRuleSet | TextInputStyleRuleSet[] = [];
 textAlign: 'auto' | 'left' | 'right' | 'center' | 'justify';
 
 
-// If defined, the control value is forced to match this value; if undefined, control value can be modified by the user
+// If defined, the control value is forced to match this value;
+// if undefined, control value can be modified by the user
 value: string = undefined;
 ```
 
@@ -121,11 +125,13 @@ value: string = undefined;
 // Forces the control to give up focus
 blur(): void;
 
-// Gives the control focus. For mobile, use setAccessibilityFocus() for setting screen reader focus
+// Gives the control focus. For mobile, use setAccessibilityFocus()
+// for setting screen reader focus
 focus(): void;
 
 // Gives the control accessibility-only focus
-// E.g. screen reader focus is needed, but popping up of native keyboard is undesirable 
+// E.g. screen reader focus is needed, but popping up of native
+// keyboard is undesirable 
 setAccessibilityFocus(): void;
 
 // Does control currently have focus?

docs/docs/components/view.md

@@ -24,7 +24,8 @@ accessibilityHidden: boolean = false;
 accessibilityTraits: AccessibilityTrait | AccessibilityTrait[] = undefined;
 
 // Region for accessibility mechanisms
-accessibilityLiveRegion: AccessibilityLiveRegion = undefined; // Android and web only
+accessibilityLiveRegion: AccessibilityLiveRegion =
+    undefined; // Android and web only
 
 // Expose the element and/or its children as accessible to Screen readers
 importantForAccessibility?: ImportantForAccessibility = Auto;
@@ -90,18 +91,23 @@ onPress: (e: SyntheticEvent) => void = undefined;
 
 // Touch-specific Events
 onLongPress: (e: SyntheticEvent) => void = undefined;
-onMoveShouldSetResponder: (e: React.SyntheticEvent) => boolean = undefined;
-onMoveShouldSetResponderCapture: (e: React.SyntheticEvent) => boolean = undefined;
+onMoveShouldSetResponder: (e: React.SyntheticEvent) => boolean =
+    undefined;
+onMoveShouldSetResponderCapture: (e: React.SyntheticEvent) => boolean =
+    undefined;
 onResponderGrant: (e: React.SyntheticEvent) => void = undefined;
 onResponderReject: (e: React.SyntheticEvent) => void = undefined;
 onResponderRelease: (e: React.SyntheticEvent) => void = undefined;
 onResponderStart: (e: React.TouchEvent) => void = undefined;
 onResponderMove: (e: React.TouchEvent) => void = undefined;
 onResponderEnd: (e: React.TouchEvent) => void = undefined;
 onResponderTerminate: (e: React.SyntheticEvent) => void = undefined;
-onResponderTerminationRequest: (e: React.SyntheticEvent) => boolean = undefined;
-onStartShouldSetResponder: (e: React.SyntheticEvent) => boolean = undefined;
-onStartShouldSetResponderCapture: (e: React.SyntheticEvent) => boolean = undefined;
+onResponderTerminationRequest: (e: React.SyntheticEvent) => boolean =
+    undefined;
+onStartShouldSetResponder: (e: React.SyntheticEvent) => boolean =
+    undefined;
+onStartShouldSetResponderCapture: (e: React.SyntheticEvent) => boolean =
+    undefined;
 
 // Other Events
 onLayout: (e: ViewOnLayoutEvent) => void = undefined;

docs/docs/extensions/virtuallistview.md

@@ -32,7 +32,8 @@ It supports a special mode where items are re-rendered only if the corresponding
 
 ## Example
 ``` javascript
-import { VirtualListView, VirtualListViewItemInfo } from 'reactxp-virtuallistview';
+import { VirtualListView, VirtualListViewItemInfo }
+    from 'reactxp-virtuallistview';
 
 // Extend VirtualListViewItemInfo to include display text
 interface FruitListItemInfo extends VirtualListViewItemInfo {
@@ -86,7 +87,8 @@ class FruitListView extends RX.Component<null, FruitListState> {
     private _renderItem(item: FruitListItemInfo, hasFocus?: boolean) {
         const viewStyle = RX.Styles.createViewStyle({
             height: item.height,
-            backgroundColor: item.template === _headerItemTemplate ? '#ddd' : '#fff',
+            backgroundColor: item.template === _headerItemTemplate ?
+                '#ddd' : '#fff',
             alignItems: 'center'
         }, false);
 
@@ -145,25 +147,26 @@ interface VirtualListViewItemInfo {
     // Optional padding around the scrolling content within the list.
     padding?: number;
 
-    // If true, allows each item to overflow its visible cell boundaries; by default,
-    // item contents are clipped to cell boundaries.
+    // If true, allows each item to overflow its visible cell boundaries;
+    // by default, item contents are clipped to cell boundaries.
     showOverflow?: boolean;
 
     // Should the list animate additions, removals and moves within the list?
     animateChanges?: boolean;
 
-    // By default, VirtualListView re-renders every item during the render. Setting
-    // this flag to true allows the list view to re-render only items from itemList
-    // whose descriptor has changed, thus avoiding unnecessary rendering. It uses
-    // _.isEqual to perform this check. In this mode, renderItem should not depend
-    // on any external state, only on VirtualListViewItemInfo, to render item.
+    // By default, VirtualListView re-renders every item during the render.
+    // Setting this flag to true allows the list view to re-render only
+    // items from itemList whose descriptor has changed, thus avoiding
+    // unnecessary rendering. It uses _.isEqual to perform this check. In
+    // this mode, renderItem should not depend on any external state, only
+    // on VirtualListViewItemInfo, to render item.
     skipRenderIfItemUnchanged?: boolean;
 
     // Pass-through properties for scroll view.
     keyboardDismissMode?: 'none' | 'interactive' | 'on-drag';
     keyboardShouldPersistTaps?: boolean;
     disableScrolling?: boolean;
-    scrollsToTop?: boolean; // iOS only, scroll to top when user taps on status bar
+    scrollsToTop?: boolean; // iOS only, scroll to top on status bar tap
     disableBouncing?: boolean; // iOS only, bounce override
     scrollIndicatorInsets?: { top: number, left: number,
         bottom: number, right: number }; // iOS only