Update docs

Core.cs

@@ -112,13 +112,45 @@ namespace Terminal {
 		}
 	}
 
+	/// <summary>
+	/// View is the base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.
+	/// </summary>
+	/// <remarks>
+	/// <para>
+	///    The View defines the base functionality for user interface elements in Terminal/gui.cs.  Views
+	///    can contain one or more subviews, can respond to user input and render themselves on the screen.
+	/// </para>
+	/// <para>
+	///    Views are created with a specified rectangle region (the frame) that is relative to the container
+	///    that they are added into.   
+	/// </para>
+	/// <para>
+	///    Subviews can be added to a View by calling the Add method.   The container of a view is the 
+	///    Superview.
+	/// </para>
+	/// <para>
+	///    Developers can call the SetNeedsDisplay method on the view to flag a region or the entire view
+	///    as requiring to be redrawn.
+	/// </para>
+	/// </remarks>
 	public class View : Responder, IEnumerable {
 		string id = "";
 		View container = null;
 		View focused = null;
+
+		/// <summary>
+		/// Points to the current driver in use by the view, it is a convenience property
+		/// for simplifying the development of new views.
+		/// </summary>
 		public static ConsoleDriver Driver = Application.Driver;
-		public static IList<View> empty = new List<View> (0).AsReadOnly ();
+
+		static IList<View> empty = new List<View> (0).AsReadOnly ();
 		List<View> subviews;
+
+		/// <summary>
+		/// This returns a list of the subviews contained by this view.
+		/// </summary>
+		/// <value>The subviews.</value>
 		public IList<View> Subviews => subviews == null ? empty : subviews.AsReadOnly ();
 		internal Rect NeedDisplay { get; private set; } = Rect.Empty;
 
@@ -138,7 +170,14 @@ namespace Terminal {
 		/// <value><c>true</c> if want mouse position reports; otherwise, <c>false</c>.</value>
 		public virtual bool WantMousePositionReports { get; set; } = false;
 
-		// The frame for this view
+		/// <summary>
+		/// Gets or sets the frame for the view.
+		/// </summary>
+		/// <value>The frame.</value>
+		/// <remarks>
+		///    Altering the Frame of a view will trigger the redrawing of the 
+		///    view as well as the redrawing of the affected regions in the superview.
+		/// </remarks>
 		public Rect Frame {
 			get => frame;
 			set {
@@ -152,12 +191,20 @@ namespace Terminal {
 			}
 		}
 
+		/// <summary>
+		/// Gets an enumerator that enumerates the subviews in this view.
+		/// </summary>
+		/// <returns>The enumerator.</returns>
 		public IEnumerator GetEnumerator ()
 		{
 			foreach (var v in subviews)
 				yield return v;
 		}
 
+		/// <summary>
+		/// The bounds represent the View-relative rectangle used for this view.   Updates to the Bounds update the Frame, and has the same side effects as updating the frame.
+		/// </summary>
+		/// <value>The bounds.</value>
 		public Rect Bounds {
 			get => new Rect (Point.Empty, Frame.Size);
 			set {
@@ -165,8 +212,16 @@ namespace Terminal {
 			}
 		}
 
+		/// <summary>
+		/// Returns the container for this view, or null if this view has not been added to a container.
+		/// </summary>
+		/// <value>The super view.</value>
 		public View SuperView => container;
 
+		/// <summary>
+		/// Initializes a new instance of the <see cref="T:Terminal.View"/> class with the specified frame.   This is the default constructor.
+		/// </summary>
+		/// <param name="frame">The region covered by this view.</param>
 		public View (Rect frame)
 		{
 			this.Frame = frame;
@@ -182,6 +237,10 @@ namespace Terminal {
 			SetNeedsDisplay (Frame);
 		}
 
+		/// <summary>
+		/// Flags the specified rectangle region on this view as needing to be repainted.
+		/// </summary>
+		/// <param name="region">The region that must be flagged for repaint.</param>
 		public void SetNeedsDisplay (Rect region)
 		{
 			if (NeedDisplay.IsEmpty)
@@ -205,6 +264,9 @@ namespace Terminal {
 
 		internal bool childNeedsDisplay;
 
+		/// <summary>
+		/// Flags this view for requiring the children views to be repainted.
+		/// </summary>
 		public void ChildNeedsDisplay ()
 		{
 			childNeedsDisplay = true;
@@ -230,6 +292,10 @@ namespace Terminal {
 			SetNeedsDisplay ();
 		}
 
+		/// <summary>
+		/// Adds the specified views to the view.
+		/// </summary>
+		/// <param name="views">Array of one or more views (can be optional parameter).</param>
 		public void Add (params View [] views)
 		{
 			if (views == null)
@@ -305,6 +371,7 @@ namespace Terminal {
 		/// <param name="row">View-based row.</param>
 		/// <param name="rcol">Absolute column, display relative.</param>
 		/// <param name="rrow">Absolute row, display relative.</param>
+		/// <param name="clipped">Whether to clip the result of the ViewToScreen method, if set to true, the rcol, rrow values are clamped to the screen dimensions.</param>
 		internal void ViewToScreen (int col, int row, out int rcol, out int rrow, bool clipped = true)
 		{
 			// Computes the real row, col relative to the screen.
@@ -428,6 +495,10 @@ namespace Terminal {
 				Move (frame.X, frame.Y);
 		}
 
+		/// <summary>
+		/// Gets or sets a value indicating whether this <see cref="T:Terminal.View"/> has focus.
+		/// </summary>
+		/// <value><c>true</c> if has focus; otherwise, <c>false</c>.</value>
 		public override bool HasFocus {
 			get {
 				return base.HasFocus;
@@ -444,6 +515,10 @@ namespace Terminal {
 		/// <value>The focused.</value>
 		public View Focused => focused;
 
+		/// <summary>
+		/// Returns the most focused view in the chain of subviews (the leaf view that has the focus).
+		/// </summary>
+		/// <value>The most focused.</value>
 		public View MostFocused {
 			get {
 				if (Focused == null)
@@ -471,6 +546,9 @@ namespace Terminal {
 			Driver.AddCh (ch);
 		}
 
+		/// <summary>
+		/// Removes the SetNeedsDisplay and the ChildNeedsDisplay setting on this view.
+		/// </summary>
 		protected void ClearNeedsDisplay ()
 		{
 			NeedDisplay = Rect.Empty;
@@ -693,10 +771,19 @@ namespace Terminal {
 			return false;
 		}
 
+		/// <summary>
+		/// This virtual method is invoked when a view starts executing or 
+		/// when the dimensions of the view have changed, for example in 
+		/// response to the container view or terminal resizing.
+		/// </summary>
 		public virtual void LayoutSubviews ()
 		{
 		}
 
+		/// <summary>
+		/// Returns a <see cref="T:System.String"/> that represents the current <see cref="T:Terminal.View"/>.
+		/// </summary>
+		/// <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:Terminal.View"/>.</returns>
 		public override string ToString ()
 		{
 			return $"{GetType ().Name}({id})({Frame})";
@@ -715,10 +802,18 @@ namespace Terminal {
 	public class Toplevel : View {
 		public bool Running;
 
+		/// <summary>
+		/// Initializes a new instance of the <see cref="T:Terminal.Toplevel"/> class.
+		/// </summary>
+		/// <param name="frame">Frame.</param>
 		public Toplevel (Rect frame) : base (frame)
 		{
 		}
 
+		/// <summary>
+		/// Convenience factory method that creates a new toplevel with the current terminal dimensions.
+		/// </summary>
+		/// <returns>The create.</returns>
 		public static Toplevel Create ()
 		{
 			return new Toplevel (new Rect (0, 0, Driver.Cols, Driver.Rows));
@@ -780,6 +875,10 @@ namespace Terminal {
 		View contentView;
 		string title;
 
+		/// <summary>
+		/// The title to be displayed for this window.
+		/// </summary>
+		/// <value>The title.</value>
 		public string Title {
 			get => title;
 			set {
@@ -921,9 +1020,27 @@ namespace Terminal {
 	///   </para>
 	/// </remarks>
 	public class Application {
+		/// <summary>
+		/// The current Console Driver in use.
+		/// </summary>
 		public static ConsoleDriver Driver = new CursesDriver ();
+
+		/// <summary>
+		/// The Toplevel object used for the application on startup.
+		/// </summary>
+		/// <value>The top.</value>
 		public static Toplevel Top { get; private set; }
+
+		/// <summary>
+		/// The current toplevel object.   This is updated when Application.Run enters and leaves and points to the current toplevel.
+		/// </summary>
+		/// <value>The current.</value>
 		public static Toplevel Current { get; private set; }
+
+		/// <summary>
+		/// The mainloop driver for the applicaiton
+		/// </summary>
+		/// <value>The main loop.</value>
 		public static Mono.Terminal.MainLoop MainLoop { get; private set; }
 
 		static Stack<Toplevel> toplevels = new Stack<Toplevel> ();

Driver.cs

@@ -72,6 +72,9 @@ namespace Terminal {
 		HLine,
 	}
 
+	/// <summary>
+	/// ConsoleDriver is an abstract class that defines the requirements for a console driver.   One implementation if the CursesDriver, and another one uses the .NET Console one.
+	/// </summary>
 	public abstract class ConsoleDriver {
 		public abstract int Cols { get; }
 		public abstract int Rows { get; }
@@ -107,6 +110,9 @@ namespace Terminal {
 		public abstract void StopReportingMouseMoves ();
 	}
 
+	/// <summary>
+	/// This is the Curses driver for the gui.cs/Terminal framework.
+	/// </summary>
 	public class CursesDriver : ConsoleDriver {
 		Action terminalResized;
 

Event.cs

@@ -162,6 +162,11 @@ namespace Terminal {
 		/// </summary>
 		public MouseFlags Flags;
 
+
+		/// <summary>
+		/// Returns a <see cref="T:System.String"/> that represents the current <see cref="T:Terminal.MouseEvent"/>.
+		/// </summary>
+		/// <returns>A <see cref="T:System.String"/> that represents the current <see cref="T:Terminal.MouseEvent"/>.</returns>
 		public override string ToString()
 		{
 			return $"({X},{Y}:{Flags}";

README.md

@@ -6,6 +6,10 @@ It is an updated version of
 [gui.cs](https://github.com/mono/mono-curses/blob/master/gui.cs) that
 I wrote for [mono-curses](https://github.com/mono/mono-curses)
 
+# API Documentation
+
+Go to the [API documentation](https://migueldeicaza.github.io/gui.cs/api/Terminal.html) for details.
+
 # Running and Building
 
 To run this, you will need a peer checkout of mono-ncurses to this

Views/Label.cs

@@ -180,6 +180,10 @@ namespace Terminal {
 			}
 		}
 
+		/// <summary>
+		/// Controls the text-alignemtn property of the label, changing it will redisplay the label.
+		/// </summary>
+		/// <value>The text alignment.</value>
 		public TextAlignment TextAlignment {
 			get => textAlignment;
 			set {
@@ -188,10 +192,10 @@ namespace Terminal {
 			}
 		}
 
+		Attribute textColor = -1;
 		/// <summary>
 		///   The color used for the label
 		/// </summary>        
-		Attribute textColor = -1;
 		public Attribute TextColor {
 			get => textColor;
 			set {

Views/Menu.cs

@@ -16,6 +16,13 @@ namespace Terminal {
 	/// A menu item has a title, an associated help text, and an action to execute on activation.
 	/// </summary>
 	public class MenuItem {
+
+		/// <summary>
+		/// Initializes a new <see cref="T:Terminal.MenuItem"/>.
+		/// </summary>
+		/// <param name="title">Title for the menu item.</param>
+		/// <param name="help">Help text to display.</param>
+		/// <param name="action">Action to invoke when the menu item is activated.</param>
 		public MenuItem (string title, string help, Action action)
 		{
 			Title = title ?? "";
@@ -35,15 +42,37 @@ namespace Terminal {
 			}
 		}
 
-		// The hotkey is used when the menu is active, the shortcut can be triggered
-		// when the menu is not active.
-		// For example HotKey would be "N" when the File Menu is open (assuming there is a "_New" entry
-		// if the ShortCut is set to "Control-N", this would be a global hotkey that would trigger as well
+		// 
+		// 
+
+		/// <summary>
+		/// The hotkey is used when the menu is active, the shortcut can be triggered when the menu is not active.   
+		/// For example HotKey would be "N" when the File Menu is open (assuming there is a "_New" entry
+		/// if the ShortCut is set to "Control-N", this would be a global hotkey that would trigger as well
+		/// </summary>
 		public char HotKey;
+
+		/// <summary>
+		/// This is the global setting that can be used as a global shortcut to invoke the action on the menu.
+		/// </summary>
 		public Key ShortCut;
 
+		/// <summary>
+		/// Gets or sets the title.
+		/// </summary>
+		/// <value>The title.</value>
 		public string Title { get; set; }
+
+		/// <summary>
+		/// Gets or sets the help text for the menu item.
+		/// </summary>
+		/// <value>The help text.</value>
 		public string Help { get; set; }
+
+		/// <summary>
+		/// Gets or sets the action to be invoked when the menu is triggered
+		/// </summary>
+		/// <value>Method to invoke.</value>
 		public Action Action { get; set; }
 		internal int Width => Title.Length + Help.Length + 1 + 2;
 	}
@@ -222,10 +251,19 @@ namespace Terminal {
 	/// A menu bar for your application.
 	/// </summary>
 	public class MenuBar : View {
+		/// <summary>
+		/// The menus that were defined when the menubar was created.   This can be updated if the menu is not currently visible.
+		/// </summary>
+		/// <value>The menu array.</value>
 		public MenuBarItem [] Menus { get; set; }
 		int selected;
 		Action action;
 
+
+		/// <summary>
+		/// Initializes a new instance of the <see cref="T:Terminal.MenuBar"/> class with the specified set of toplevel menu items.
+		/// </summary>
+		/// <param name="menus">Menus.</param>
 		public MenuBar (MenuBarItem [] menus) : base (new Rect (0, 0, Application.Driver.Cols, 1))
 		{
 			Menus = menus;

Views/RadioGroup.cs

@@ -36,7 +36,8 @@ namespace Terminal {
 		/// <param name="x">The x coordinate.</param>
 		/// <param name="y">The y coordinate.</param>
 		/// <param name="radioLabels">Radio labels, the strings can contain hotkeys using an undermine before the letter.</param>
-		/// <param name="selected">The item to be selected, the value is clamped to the number of items.</param>		/// <summary>
+		/// <param name="selected">The item to be selected, the value is clamped to the number of items.</param>		
+		/// <summary>
 		public RadioGroup (int x, int y, string [] radioLabels, int selected = 0) : this (MakeRect (x, y, radioLabels), radioLabels, selected)
 		{
 		}

docfx/api/Terminal/Terminal.Application.yml

@@ -91,11 +91,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The current toplevel object.   This is updated when Application.Run enters and leaves and points to the current toplevel.
   syntax:
     content: public static Terminal.Toplevel Current { get; }
     return:
       type: Terminal.Toplevel
-      description: To be added.
+      description: The current.
   overload: Terminal.Application.Current*
   exceptions: []
 - uid: Terminal.Application.DebugDrawBounds
@@ -128,6 +129,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The current Console Driver in use.
   syntax:
     content: public static Terminal.ConsoleDriver Driver;
     return:
@@ -227,11 +229,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The mainloop driver for the applicaiton
   syntax:
     content: public static Mono.Terminal.MainLoop MainLoop { get; }
     return:
       type: Mono.Terminal.MainLoop
-      description: To be added.
+      description: The main loop.
   overload: Terminal.Application.MainLoop*
   exceptions: []
 - uid: Terminal.Application.MakeCenteredRect(Terminal.Size)
@@ -401,11 +404,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The Toplevel object used for the application on startup.
   syntax:
     content: public static Terminal.Toplevel Top { get; }
     return:
       type: Terminal.Toplevel
-      description: To be added.
+      description: The top.
   overload: Terminal.Application.Top*
   exceptions: []
 - uid: Terminal.Application.UngrabMouse

docfx/api/Terminal/Terminal.Button.yml

@@ -50,7 +50,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -649,12 +648,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.CheckBox.yml

@@ -41,7 +41,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -515,12 +514,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.ConsoleDriver.yml

@@ -32,6 +32,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: ConsoleDriver is an abstract class that defines the requirements for a console driver.   One implementation if the CursesDriver, and another one uses the .NET Console one.
   syntax:
     content: public abstract class ConsoleDriver
   inheritance:

docfx/api/Terminal/Terminal.CursesDriver.yml

@@ -32,6 +32,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: This is the Curses driver for the gui.cs/Terminal framework.
   syntax:
     content: 'public class CursesDriver : Terminal.ConsoleDriver'
   inheritance:

docfx/api/Terminal/Terminal.Dialog.yml

@@ -41,7 +41,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -354,12 +353,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.Label.yml

@@ -41,7 +41,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -206,11 +205,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Controls the text-alignemtn property of the label, changing it will redisplay the label.
   syntax:
     content: public Terminal.TextAlignment TextAlignment { get; set; }
     return:
       type: Terminal.TextAlignment
-      description: To be added.
+      description: The text alignment.
   overload: Terminal.Label.TextAlignment*
   exceptions: []
 - uid: Terminal.Label.TextColor
@@ -225,6 +225,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The color used for the label
   syntax:
     content: public Terminal.Attribute TextColor { get; set; }
     return:
@@ -449,12 +450,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.MenuBar.yml

@@ -40,7 +40,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -77,12 +76,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Initializes a new instance of the <xref href="Terminal.MenuBar"></xref> class with the specified set of toplevel menu items.
   syntax:
     content: public MenuBar (Terminal.MenuBarItem[] menus);
     parameters:
     - id: menus
       type: Terminal.MenuBarItem[]
-      description: To be added.
+      description: Menus.
   overload: Terminal.MenuBar.#ctor*
   exceptions: []
 - uid: Terminal.MenuBar.Menus
@@ -97,11 +97,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The menus that were defined when the menubar was created.   This can be updated if the menu is not currently visible.
   syntax:
     content: public Terminal.MenuBarItem[] Menus { get; set; }
     return:
       type: Terminal.MenuBarItem[]
-      description: To be added.
+      description: The menu array.
   overload: Terminal.MenuBar.Menus*
   exceptions: []
 - uid: Terminal.MenuBar.MouseEvent(Terminal.MouseEvent)
@@ -427,12 +428,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.MenuItem.yml

@@ -37,18 +37,19 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Initializes a new <xref href="Terminal.MenuItem"></xref>.
   syntax:
     content: public MenuItem (string title, string help, Action action);
     parameters:
     - id: title
       type: System.String
-      description: To be added.
+      description: Title for the menu item.
     - id: help
       type: System.String
-      description: To be added.
+      description: Help text to display.
     - id: action
       type: System.Action
-      description: To be added.
+      description: Action to invoke when the menu item is activated.
   overload: Terminal.MenuItem.#ctor*
   exceptions: []
 - uid: Terminal.MenuItem.Action
@@ -63,11 +64,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Gets or sets the action to be invoked when the menu is triggered
   syntax:
     content: public Action Action { get; set; }
     return:
       type: System.Action
-      description: To be added.
+      description: Method to invoke.
   overload: Terminal.MenuItem.Action*
   exceptions: []
 - uid: Terminal.MenuItem.Help
@@ -82,11 +84,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Gets or sets the help text for the menu item.
   syntax:
     content: public string Help { get; set; }
     return:
       type: System.String
-      description: To be added.
+      description: The help text.
   overload: Terminal.MenuItem.Help*
   exceptions: []
 - uid: Terminal.MenuItem.HotKey
@@ -101,6 +104,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: "The hotkey is used when the menu is active, the shortcut can be triggered when the menu is not active.   \n            For example HotKey would be \"N\" when the File Menu is open (assuming there is a \"_New\" entry\n            if the ShortCut is set to \"Control-N\", this would be a global hotkey that would trigger as well"
   syntax:
     content: public char HotKey;
     return:
@@ -119,6 +123,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: This is the global setting that can be used as a global shortcut to invoke the action on the menu.
   syntax:
     content: public Terminal.Key ShortCut;
     return:
@@ -137,11 +142,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Gets or sets the title.
   syntax:
     content: public string Title { get; set; }
     return:
       type: System.String
-      description: To be added.
+      description: The title.
   overload: Terminal.MenuItem.Title*
   exceptions: []
 references:

docfx/api/Terminal/Terminal.MouseEvent.yml

@@ -53,12 +53,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Returns a <xref href="System.String"></xref> that represents the current <xref href="Terminal.MouseEvent"></xref>.
   syntax:
     content: public override string ToString ();
     parameters: []
     return:
       type: System.String
-      description: To be added.
+      description: A <xref href="System.String"></xref> that represents the current <xref href="Terminal.MouseEvent"></xref>.
   overload: Terminal.MouseEvent.ToString*
   exceptions: []
 - uid: Terminal.MouseEvent.X

docfx/api/Terminal/Terminal.RadioGroup.yml

@@ -43,7 +43,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -562,12 +561,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.ScrollView.yml

@@ -34,7 +34,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -210,12 +209,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.TextField.yml

@@ -46,7 +46,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -573,12 +572,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.Toplevel.yml

@@ -45,7 +45,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -85,12 +84,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Initializes a new instance of the <xref href="Terminal.Toplevel"></xref> class.
   syntax:
     content: public Toplevel (Terminal.Rect frame);
     parameters:
     - id: frame
       type: Terminal.Rect
-      description: To be added.
+      description: Frame.
   overload: Terminal.Toplevel.#ctor*
   exceptions: []
 - uid: Terminal.Toplevel.CanFocus
@@ -124,12 +124,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Convenience factory method that creates a new toplevel with the current terminal dimensions.
   syntax:
     content: public static Terminal.Toplevel Create ();
     parameters: []
     return:
       type: Terminal.Toplevel
-      description: To be added.
+      description: The create.
   overload: Terminal.Toplevel.Create*
   exceptions: []
 - uid: Terminal.Toplevel.ProcessKey(Terminal.KeyEvent)
@@ -348,12 +349,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.View.yml

@@ -15,7 +15,6 @@ items:
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -53,6 +52,8 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: View is the base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.
+  remarks: "<p>\n               The View defines the base functionality for user interface elements in Terminal/gui.cs.  Views\n               can contain one or more subviews, can respond to user input and render themselves on the screen.\n            </p>\n    <p>\n               Views are created with a specified rectangle region (the frame) that is relative to the container\n               that they are added into.   \n            </p>\n    <p>\n               Subviews can be added to a View by calling the Add method.   The container of a view is the \n               Superview.\n            </p>\n    <p>\n               Developers can call the SetNeedsDisplay method on the view to flag a region or the entire view\n               as requiring to be redrawn.\n            </p>"
   syntax:
     content: 'public class View : Terminal.Responder, System.Collections.IEnumerable'
   inheritance:
@@ -84,12 +85,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Initializes a new instance of the <xref href="Terminal.View"></xref> class with the specified frame.   This is the default constructor.
   syntax:
     content: public View (Terminal.Rect frame);
     parameters:
     - id: frame
       type: Terminal.Rect
-      description: To be added.
+      description: The region covered by this view.
   overload: Terminal.View.#ctor*
   exceptions: []
 - uid: Terminal.View.Add(Terminal.View)
@@ -125,12 +127,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Adds the specified views to the view.
   syntax:
     content: public void Add (Terminal.View[] views);
     parameters:
     - id: views
       type: Terminal.View[]
-      description: To be added.
+      description: Array of one or more views (can be optional parameter).
   overload: Terminal.View.Add*
   exceptions: []
 - uid: Terminal.View.AddCh(System.Int32,System.Int32,System.Int32)
@@ -172,11 +175,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The bounds represent the View-relative rectangle used for this view.   Updates to the Bounds update the Frame, and has the same side effects as updating the frame.
   syntax:
     content: public Terminal.Rect Bounds { get; set; }
     return:
       type: Terminal.Rect
-      description: To be added.
+      description: The bounds.
   overload: Terminal.View.Bounds*
   exceptions: []
 - uid: Terminal.View.ChildNeedsDisplay
@@ -191,6 +195,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Flags this view for requiring the children views to be repainted.
   syntax:
     content: public void ChildNeedsDisplay ();
     parameters: []
@@ -230,6 +235,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Removes the SetNeedsDisplay and the ChildNeedsDisplay setting on this view.
   syntax:
     content: protected void ClearNeedsDisplay ();
     parameters: []
@@ -325,30 +331,15 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: >-
+    Points to the current driver in use by the view, it is a convenience property
+                for simplifying the development of new views.
   syntax:
     content: public static Terminal.ConsoleDriver Driver;
     return:
       type: Terminal.ConsoleDriver
       description: To be added.
   exceptions: []
-- uid: Terminal.View.empty
-  id: empty
-  parent: Terminal.View
-  langs:
-  - csharp
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
-  type: Field
-  assemblies:
-  - Terminal
-  namespace: Terminal
-  syntax:
-    content: public static System.Collections.Generic.IList<Terminal.View> empty;
-    return:
-      type: System.Collections.Generic.IList{Terminal.View}
-      description: To be added.
-  exceptions: []
 - uid: Terminal.View.EnsureFocus
   id: EnsureFocus
   parent: Terminal.View
@@ -477,11 +468,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Gets or sets the frame for the view.
+  remarks: "Altering the Frame of a view will trigger the redrawing of the \n               view as well as the redrawing of the affected regions in the superview."
   syntax:
     content: public Terminal.Rect Frame { get; set; }
     return:
       type: Terminal.Rect
-      description: To be added.
+      description: The frame.
   overload: Terminal.View.Frame*
   exceptions: []
 - uid: Terminal.View.GetEnumerator
@@ -496,6 +489,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Gets an enumerator that enumerates the subviews in this view.
   syntax:
     content: >-
       [System.Runtime.CompilerServices.IteratorStateMachine(typeof(Terminal.View/<GetEnumerator>d__23))]
@@ -504,7 +498,7 @@ items:
     parameters: []
     return:
       type: System.Collections.IEnumerator
-      description: To be added.
+      description: The enumerator.
   overload: Terminal.View.GetEnumerator*
   exceptions: []
   attributes:
@@ -521,11 +515,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Gets or sets a value indicating whether this <xref href="Terminal.View"></xref> has focus.
   syntax:
     content: public override bool HasFocus { get; }
     return:
       type: System.Boolean
-      description: To be added.
+      description: <code>true</code> if has focus; otherwise, <code>false</code>.
   overload: Terminal.View.HasFocus*
   exceptions: []
 - uid: Terminal.View.Id
@@ -559,6 +554,7 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: "This virtual method is invoked when a view starts executing or \n            when the dimensions of the view have changed, for example in \n            response to the container view or terminal resizing."
   syntax:
     content: public virtual void LayoutSubviews ();
     parameters: []
@@ -576,11 +572,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Returns the most focused view in the chain of subviews (the leaf view that has the focus).
   syntax:
     content: public Terminal.View MostFocused { get; }
     return:
       type: Terminal.View
-      description: To be added.
+      description: The most focused.
   overload: Terminal.View.MostFocused*
   exceptions: []
 - uid: Terminal.View.Move(System.Int32,System.Int32)
@@ -835,12 +832,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Flags the specified rectangle region on this view as needing to be repainted.
   syntax:
     content: public void SetNeedsDisplay (Terminal.Rect region);
     parameters:
     - id: region
       type: Terminal.Rect
-      description: To be added.
+      description: The region that must be flagged for repaint.
   overload: Terminal.View.SetNeedsDisplay*
   exceptions: []
 - uid: Terminal.View.Subviews
@@ -855,11 +853,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: This returns a list of the subviews contained by this view.
   syntax:
     content: public System.Collections.Generic.IList<Terminal.View> Subviews { get; }
     return:
       type: System.Collections.Generic.IList{Terminal.View}
-      description: To be added.
+      description: The subviews.
   overload: Terminal.View.Subviews*
   exceptions: []
 - uid: Terminal.View.SuperView
@@ -874,11 +873,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Returns the container for this view, or null if this view has not been added to a container.
   syntax:
     content: public Terminal.View SuperView { get; }
     return:
       type: Terminal.View
-      description: To be added.
+      description: The super view.
   overload: Terminal.View.SuperView*
   exceptions: []
 - uid: Terminal.View.ToString
@@ -893,12 +893,13 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: Returns a <xref href="System.String"></xref> that represents the current <xref href="Terminal.View"></xref>.
   syntax:
     content: public override string ToString ();
     parameters: []
     return:
       type: System.String
-      description: To be added.
+      description: A <xref href="System.String"></xref> that represents the current <xref href="Terminal.View"></xref>.
   overload: Terminal.View.ToString*
   exceptions: []
 - uid: Terminal.View.WantMousePositionReports
@@ -1062,37 +1063,6 @@ references:
   name: ConsoleDriver
   nameWithType: ConsoleDriver
   fullName: Terminal.ConsoleDriver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
-- uid: System.Collections.Generic.IList`1
-  name: IList
-  nameWithType: IList
-  fullName: System.Collections.Generic.IList
-- uid: System.Collections.Generic.IList{Terminal.View}
-  parent: System.Collections.Generic
-  isExternal: true
-  name: IList<View>
-  nameWithType: IList<View>
-  fullName: System.Collections.Generic.IList<Terminal.View>
-  spec.csharp:
-  - uid: System.Collections.Generic.IList`1
-    name: IList
-    nameWithType: IList
-    fullName: System.Collections.Generic.IList
-  - name: <
-    nameWithType: <
-    fullName: <
-  - uid: Terminal.View
-    name: View
-    nameWithType: View
-    fullName: Terminal.View
-  - name: '>'
-    nameWithType: '>'
-    fullName: '>'
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false
@@ -1261,6 +1231,31 @@ references:
   name: Subviews
   nameWithType: View.Subviews
   fullName: View.Subviews
+- uid: System.Collections.Generic.IList`1
+  name: IList
+  nameWithType: IList
+  fullName: System.Collections.Generic.IList
+- uid: System.Collections.Generic.IList{Terminal.View}
+  parent: System.Collections.Generic
+  isExternal: true
+  name: IList<View>
+  nameWithType: IList<View>
+  fullName: System.Collections.Generic.IList<Terminal.View>
+  spec.csharp:
+  - uid: System.Collections.Generic.IList`1
+    name: IList
+    nameWithType: IList
+    fullName: System.Collections.Generic.IList
+  - name: <
+    nameWithType: <
+    fullName: <
+  - uid: Terminal.View
+    name: View
+    nameWithType: View
+    fullName: Terminal.View
+  - name: '>'
+    nameWithType: '>'
+    fullName: '>'
 - uid: Terminal.View.SuperView
   parent: Terminal.View
   isExternal: false

docfx/api/Terminal/Terminal.Window.yml

@@ -45,7 +45,6 @@ items:
   - Terminal.View.DrawHotString(System.String,System.Boolean,Terminal.ColorScheme)
   - Terminal.View.DrawHotString(System.String,Terminal.Attribute,Terminal.Attribute)
   - Terminal.View.Driver
-  - Terminal.View.empty
   - Terminal.View.EnsureFocus
   - Terminal.View.Focused
   - Terminal.View.FocusFirst
@@ -169,11 +168,12 @@ items:
   assemblies:
   - Terminal
   namespace: Terminal
+  summary: The title to be displayed for this window.
   syntax:
     content: public string Title { get; set; }
     return:
       type: System.String
-      description: To be added.
+      description: The title.
   overload: Terminal.Window.Title*
   exceptions: []
 references:
@@ -363,12 +363,6 @@ references:
   name: Driver
   nameWithType: View.Driver
   fullName: View.Driver
-- uid: Terminal.View.empty
-  parent: Terminal.View
-  isExternal: false
-  name: empty
-  nameWithType: View.empty
-  fullName: View.empty
 - uid: Terminal.View.EnsureFocus
   parent: Terminal.View
   isExternal: false

docs/api/Terminal.html

@@ -92,9 +92,11 @@
       <section><p>Color scheme definitions</p>
 </section>
       <h4><a class="xref" href="Terminal/Terminal.ConsoleDriver.html">ConsoleDriver</a></h4>
-      <section></section>
+      <section><p>ConsoleDriver is an abstract class that defines the requirements for a console driver.   One implementation if the CursesDriver, and another one uses the .NET Console one.</p>
+</section>
       <h4><a class="xref" href="Terminal/Terminal.CursesDriver.html">CursesDriver</a></h4>
-      <section></section>
+      <section><p>This is the Curses driver for the gui.cs/Terminal framework.</p>
+</section>
       <h4><a class="xref" href="Terminal/Terminal.Dialog.html">Dialog</a></h4>
       <section><p>The dialog box is a window that by default is centered and contains one 
             or more buttons.</p>
@@ -128,7 +130,8 @@
       <section><p>Toplevel views can be modally executed.</p>
 </section>
       <h4><a class="xref" href="Terminal/Terminal.View.html">View</a></h4>
-      <section></section>
+      <section><p>View is the base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.</p>
+</section>
       <h4><a class="xref" href="Terminal/Terminal.Window.html">Window</a></h4>
       <section><p>A toplevel view that draws a frame around its region and has a &quot;ContentView&quot; subview where the contents are added.</p>
 </section>

docs/api/Terminal/Terminal.Application.html

@@ -141,7 +141,8 @@
   
   
   <h4 id="Terminal_Application_Driver" data-uid="Terminal.Application.Driver">Driver</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The current Console Driver in use.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -195,7 +196,8 @@
   
   <a id="Terminal_Application_Current_" data-uid="Terminal.Application.Current*"></a>
   <h4 id="Terminal_Application_Current" data-uid="Terminal.Application.Current">Current</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The current toplevel object.   This is updated when Application.Run enters and leaves and points to the current toplevel.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -212,7 +214,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.Toplevel.html">Toplevel</a></td>
-        <td><p>To be added.</p>
+        <td><p>The current.</p>
 </td>
       </tr>
     </tbody>
@@ -221,7 +223,8 @@
   
   <a id="Terminal_Application_MainLoop_" data-uid="Terminal.Application.MainLoop*"></a>
   <h4 id="Terminal_Application_MainLoop" data-uid="Terminal.Application.MainLoop">MainLoop</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The mainloop driver for the applicaiton</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -238,7 +241,7 @@
     <tbody>
       <tr>
         <td><span class="xref">Mono.Terminal.MainLoop</span></td>
-        <td><p>To be added.</p>
+        <td><p>The main loop.</p>
 </td>
       </tr>
     </tbody>
@@ -247,7 +250,8 @@
   
   <a id="Terminal_Application_Top_" data-uid="Terminal.Application.Top*"></a>
   <h4 id="Terminal_Application_Top" data-uid="Terminal.Application.Top">Top</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The Toplevel object used for the application on startup.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -264,7 +268,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.Toplevel.html">Toplevel</a></td>
-        <td><p>To be added.</p>
+        <td><p>The top.</p>
 </td>
       </tr>
     </tbody>

docs/api/Terminal/Terminal.Button.html

@@ -120,9 +120,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>

docs/api/Terminal/Terminal.CheckBox.html

@@ -119,9 +119,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>

docs/api/Terminal/Terminal.ConsoleDriver.html

@@ -72,7 +72,8 @@
   
   <h1 id="Terminal_ConsoleDriver" data-uid="Terminal.ConsoleDriver">Class ConsoleDriver
   </h1>
-  <div class="markdown level0 summary"></div>
+  <div class="markdown level0 summary"><p>ConsoleDriver is an abstract class that defines the requirements for a console driver.   One implementation if the CursesDriver, and another one uses the .NET Console one.</p>
+</div>
   <div class="markdown level0 conceptual"></div>
   <div class="inheritance">
     <h5>Inheritance</h5>

docs/api/Terminal/Terminal.CursesDriver.html

@@ -72,7 +72,8 @@
   
   <h1 id="Terminal_CursesDriver" data-uid="Terminal.CursesDriver">Class CursesDriver
   </h1>
-  <div class="markdown level0 summary"></div>
+  <div class="markdown level0 summary"><p>This is the Curses driver for the gui.cs/Terminal framework.</p>
+</div>
   <div class="markdown level0 conceptual"></div>
   <div class="inheritance">
     <h5>Inheritance</h5>

docs/api/Terminal/Terminal.Dialog.html

@@ -129,9 +129,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>

docs/api/Terminal/Terminal.Label.html

@@ -123,9 +123,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>
@@ -330,7 +327,8 @@
   
   <a id="Terminal_Label_TextAlignment_" data-uid="Terminal.Label.TextAlignment*"></a>
   <h4 id="Terminal_Label_TextAlignment" data-uid="Terminal.Label.TextAlignment">TextAlignment</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Controls the text-alignemtn property of the label, changing it will redisplay the label.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -347,7 +345,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.TextAlignment.html">TextAlignment</a></td>
-        <td><p>To be added.</p>
+        <td><p>The text alignment.</p>
 </td>
       </tr>
     </tbody>
@@ -356,7 +354,8 @@
   
   <a id="Terminal_Label_TextColor_" data-uid="Terminal.Label.TextColor*"></a>
   <h4 id="Terminal_Label_TextColor" data-uid="Terminal.Label.TextColor">TextColor</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The color used for the label</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">

docs/api/Terminal/Terminal.MenuBar.html

@@ -120,9 +120,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>
@@ -208,7 +205,8 @@
   
   <a id="Terminal_MenuBar__ctor_" data-uid="Terminal.MenuBar.#ctor*"></a>
   <h4 id="Terminal_MenuBar__ctor_Terminal_MenuBarItem___" data-uid="Terminal.MenuBar.#ctor(Terminal.MenuBarItem[])">MenuBar(MenuBarItem[])</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="Terminal.MenuBar.html">MenuBar</a> class with the specified set of toplevel menu items.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -227,7 +225,7 @@
       <tr>
         <td><a class="xref" href="Terminal.MenuBarItem.html">MenuBarItem</a>[]</td>
         <td><span class="parametername">menus</span></td>
-        <td><p>To be added.</p>
+        <td><p>Menus.</p>
 </td>
       </tr>
     </tbody>
@@ -238,7 +236,8 @@
   
   <a id="Terminal_MenuBar_Menus_" data-uid="Terminal.MenuBar.Menus*"></a>
   <h4 id="Terminal_MenuBar_Menus" data-uid="Terminal.MenuBar.Menus">Menus</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The menus that were defined when the menubar was created.   This can be updated if the menu is not currently visible.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -255,7 +254,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.MenuBarItem.html">MenuBarItem</a>[]</td>
-        <td><p>To be added.</p>
+        <td><p>The menu array.</p>
 </td>
       </tr>
     </tbody>

docs/api/Terminal/Terminal.MenuItem.html

@@ -92,7 +92,8 @@
   
   <a id="Terminal_MenuItem__ctor_" data-uid="Terminal.MenuItem.#ctor*"></a>
   <h4 id="Terminal_MenuItem__ctor_System_String_System_String_System_Action_" data-uid="Terminal.MenuItem.#ctor(System.String,System.String,System.Action)">MenuItem(String, String, Action)</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Initializes a new <a class="xref" href="Terminal.MenuItem.html">MenuItem</a>.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -111,19 +112,19 @@
       <tr>
         <td><span class="xref">System.String</span></td>
         <td><span class="parametername">title</span></td>
-        <td><p>To be added.</p>
+        <td><p>Title for the menu item.</p>
 </td>
       </tr>
       <tr>
         <td><span class="xref">System.String</span></td>
         <td><span class="parametername">help</span></td>
-        <td><p>To be added.</p>
+        <td><p>Help text to display.</p>
 </td>
       </tr>
       <tr>
         <td><span class="xref">System.Action</span></td>
         <td><span class="parametername">action</span></td>
-        <td><p>To be added.</p>
+        <td><p>Action to invoke when the menu item is activated.</p>
 </td>
       </tr>
     </tbody>
@@ -133,7 +134,9 @@
   
   
   <h4 id="Terminal_MenuItem_HotKey" data-uid="Terminal.MenuItem.HotKey">HotKey</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The hotkey is used when the menu is active, the shortcut can be triggered when the menu is not active.<br>            For example HotKey would be &quot;N&quot; when the File Menu is open (assuming there is a &quot;_New&quot; entry
+            if the ShortCut is set to &quot;Control-N&quot;, this would be a global hotkey that would trigger as well</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -158,7 +161,8 @@
   
   
   <h4 id="Terminal_MenuItem_ShortCut" data-uid="Terminal.MenuItem.ShortCut">ShortCut</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>This is the global setting that can be used as a global shortcut to invoke the action on the menu.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -186,7 +190,8 @@
   
   <a id="Terminal_MenuItem_Action_" data-uid="Terminal.MenuItem.Action*"></a>
   <h4 id="Terminal_MenuItem_Action" data-uid="Terminal.MenuItem.Action">Action</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets or sets the action to be invoked when the menu is triggered</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -203,7 +208,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.Action</span></td>
-        <td><p>To be added.</p>
+        <td><p>Method to invoke.</p>
 </td>
       </tr>
     </tbody>
@@ -212,7 +217,8 @@
   
   <a id="Terminal_MenuItem_Help_" data-uid="Terminal.MenuItem.Help*"></a>
   <h4 id="Terminal_MenuItem_Help" data-uid="Terminal.MenuItem.Help">Help</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets or sets the help text for the menu item.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -229,7 +235,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.String</span></td>
-        <td><p>To be added.</p>
+        <td><p>The help text.</p>
 </td>
       </tr>
     </tbody>
@@ -238,7 +244,8 @@
   
   <a id="Terminal_MenuItem_Title_" data-uid="Terminal.MenuItem.Title*"></a>
   <h4 id="Terminal_MenuItem_Title" data-uid="Terminal.MenuItem.Title">Title</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets or sets the title.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -255,7 +262,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.String</span></td>
-        <td><p>To be added.</p>
+        <td><p>The title.</p>
 </td>
       </tr>
     </tbody>

docs/api/Terminal/Terminal.MouseEvent.html

@@ -167,7 +167,8 @@
   
   <a id="Terminal_MouseEvent_ToString_" data-uid="Terminal.MouseEvent.ToString*"></a>
   <h4 id="Terminal_MouseEvent_ToString" data-uid="Terminal.MouseEvent.ToString">ToString()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Returns a <span class="xref">System.String</span> that represents the current <a class="xref" href="Terminal.MouseEvent.html">MouseEvent</a>.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -184,7 +185,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.String</span></td>
-        <td><p>To be added.</p>
+        <td><p>A <span class="xref">System.String</span> that represents the current <a class="xref" href="Terminal.MouseEvent.html">MouseEvent</a>.</p>
 </td>
       </tr>
     </tbody>

docs/api/Terminal/Terminal.RadioGroup.html

@@ -120,9 +120,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>

docs/api/Terminal/Terminal.ScrollView.html

@@ -122,9 +122,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>

docs/api/Terminal/Terminal.TextField.html

@@ -117,9 +117,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>

docs/api/Terminal/Terminal.Toplevel.html

@@ -121,9 +121,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>
@@ -223,7 +220,8 @@
   
   <a id="Terminal_Toplevel__ctor_" data-uid="Terminal.Toplevel.#ctor*"></a>
   <h4 id="Terminal_Toplevel__ctor_Terminal_Rect_" data-uid="Terminal.Toplevel.#ctor(Terminal.Rect)">Toplevel(Rect)</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="Terminal.Toplevel.html">Toplevel</a> class.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -242,7 +240,7 @@
       <tr>
         <td><a class="xref" href="Terminal.Rect.html">Rect</a></td>
         <td><span class="parametername">frame</span></td>
-        <td><p>To be added.</p>
+        <td><p>Frame.</p>
 </td>
       </tr>
     </tbody>
@@ -308,7 +306,8 @@
   
   <a id="Terminal_Toplevel_Create_" data-uid="Terminal.Toplevel.Create*"></a>
   <h4 id="Terminal_Toplevel_Create" data-uid="Terminal.Toplevel.Create">Create()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Convenience factory method that creates a new toplevel with the current terminal dimensions.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -325,7 +324,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.Toplevel.html">Toplevel</a></td>
-        <td><p>To be added.</p>
+        <td><p>The create.</p>
 </td>
       </tr>
     </tbody>

docs/api/Terminal/Terminal.View.html

@@ -72,7 +72,8 @@
   
   <h1 id="Terminal_View" data-uid="Terminal.View">Class View
   </h1>
-  <div class="markdown level0 summary"></div>
+  <div class="markdown level0 summary"><p>View is the base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.</p>
+</div>
   <div class="markdown level0 conceptual"></div>
   <div class="inheritance">
     <h5>Inheritance</h5>
@@ -103,13 +104,30 @@
   <div class="codewrapper">
     <pre><code class="lang-csharp hljs">public class View : Terminal.Responder, System.Collections.IEnumerable</code></pre>
   </div>
+  <h5 id="Terminal_View_remarks"><strong>Remarks</strong></h5>
+  <div class="markdown level0 remarks"><p>
+               The View defines the base functionality for user interface elements in Terminal/gui.cs.  Views
+               can contain one or more subviews, can respond to user input and render themselves on the screen.
+            </p>
+    <p>
+               Views are created with a specified rectangle region (the frame) that is relative to the container
+               that they are added into.<br>            </p>
+    <p>
+               Subviews can be added to a View by calling the Add method.   The container of a view is the 
+               Superview.
+            </p>
+    <p>
+               Developers can call the SetNeedsDisplay method on the view to flag a region or the entire view
+               as requiring to be redrawn.
+            </p></div>
   <h3 id="constructors">Constructors
   </h3>
   
   
   <a id="Terminal_View__ctor_" data-uid="Terminal.View.#ctor*"></a>
   <h4 id="Terminal_View__ctor_Terminal_Rect_" data-uid="Terminal.View.#ctor(Terminal.Rect)">View(Rect)</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="Terminal.View.html">View</a> class with the specified frame.   This is the default constructor.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -128,7 +146,7 @@
       <tr>
         <td><a class="xref" href="Terminal.Rect.html">Rect</a></td>
         <td><span class="parametername">frame</span></td>
-        <td><p>To be added.</p>
+        <td><p>The region covered by this view.</p>
 </td>
       </tr>
     </tbody>
@@ -138,7 +156,9 @@
   
   
   <h4 id="Terminal_View_Driver" data-uid="Terminal.View.Driver">Driver</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Points to the current driver in use by the view, it is a convenience property
+            for simplifying the development of new views.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -160,38 +180,14 @@
       </tr>
     </tbody>
   </table>
-  
-  
-  <h4 id="Terminal_View_empty" data-uid="Terminal.View.empty">empty</h4>
-  <div class="markdown level1 summary"></div>
-  <div class="markdown level1 conceptual"></div>
-  <h5 class="decalaration">Declaration</h5>
-  <div class="codewrapper">
-    <pre><code class="lang-csharp hljs">public static System.Collections.Generic.IList&lt;Terminal.View&gt; empty;</code></pre>
-  </div>
-  <h5 class="fieldValue">Field Value</h5>
-  <table class="table table-bordered table-striped table-condensed">
-    <thead>
-      <tr>
-        <th>Type</th>
-        <th>Description</th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td><span class="xref">System.Collections.Generic.IList</span>&lt;<a class="xref" href="Terminal.View.html">View</a>&gt;</td>
-        <td><p>To be added.</p>
-</td>
-      </tr>
-    </tbody>
-  </table>
   <h3 id="properties">Properties
   </h3>
   
   
   <a id="Terminal_View_Bounds_" data-uid="Terminal.View.Bounds*"></a>
   <h4 id="Terminal_View_Bounds" data-uid="Terminal.View.Bounds">Bounds</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The bounds represent the View-relative rectangle used for this view.   Updates to the Bounds update the Frame, and has the same side effects as updating the frame.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -208,7 +204,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.Rect.html">Rect</a></td>
-        <td><p>To be added.</p>
+        <td><p>The bounds.</p>
 </td>
       </tr>
     </tbody>
@@ -244,7 +240,8 @@
   
   <a id="Terminal_View_Frame_" data-uid="Terminal.View.Frame*"></a>
   <h4 id="Terminal_View_Frame" data-uid="Terminal.View.Frame">Frame</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets or sets the frame for the view.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -261,16 +258,21 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.Rect.html">Rect</a></td>
-        <td><p>To be added.</p>
+        <td><p>The frame.</p>
 </td>
       </tr>
     </tbody>
   </table>
+  <h5 id="Terminal_View_Frame_remarks">Remarks</h5>
+  <div class="markdown level1 remarks"><p>Altering the Frame of a view will trigger the redrawing of the 
+               view as well as the redrawing of the affected regions in the superview.</p>
+</div>
   
   
   <a id="Terminal_View_HasFocus_" data-uid="Terminal.View.HasFocus*"></a>
   <h4 id="Terminal_View_HasFocus" data-uid="Terminal.View.HasFocus">HasFocus</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets or sets a value indicating whether this <a class="xref" href="Terminal.View.html">View</a> has focus.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -287,7 +289,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.Boolean</span></td>
-        <td><p>To be added.</p>
+        <td><p><code>true</code> if has focus; otherwise, <code>false</code>.</p>
 </td>
       </tr>
     </tbody>
@@ -322,7 +324,8 @@
   
   <a id="Terminal_View_MostFocused_" data-uid="Terminal.View.MostFocused*"></a>
   <h4 id="Terminal_View_MostFocused" data-uid="Terminal.View.MostFocused">MostFocused</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Returns the most focused view in the chain of subviews (the leaf view that has the focus).</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -339,7 +342,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.View.html">View</a></td>
-        <td><p>To be added.</p>
+        <td><p>The most focused.</p>
 </td>
       </tr>
     </tbody>
@@ -348,7 +351,8 @@
   
   <a id="Terminal_View_Subviews_" data-uid="Terminal.View.Subviews*"></a>
   <h4 id="Terminal_View_Subviews" data-uid="Terminal.View.Subviews">Subviews</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>This returns a list of the subviews contained by this view.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -365,7 +369,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.Collections.Generic.IList</span>&lt;<a class="xref" href="Terminal.View.html">View</a>&gt;</td>
-        <td><p>To be added.</p>
+        <td><p>The subviews.</p>
 </td>
       </tr>
     </tbody>
@@ -374,7 +378,8 @@
   
   <a id="Terminal_View_SuperView_" data-uid="Terminal.View.SuperView*"></a>
   <h4 id="Terminal_View_SuperView" data-uid="Terminal.View.SuperView">SuperView</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Returns the container for this view, or null if this view has not been added to a container.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -391,7 +396,7 @@
     <tbody>
       <tr>
         <td><a class="xref" href="Terminal.View.html">View</a></td>
-        <td><p>To be added.</p>
+        <td><p>The super view.</p>
 </td>
       </tr>
     </tbody>
@@ -458,7 +463,8 @@
   
   <a id="Terminal_View_Add_" data-uid="Terminal.View.Add*"></a>
   <h4 id="Terminal_View_Add_Terminal_View___" data-uid="Terminal.View.Add(Terminal.View[])">Add(View[])</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Adds the specified views to the view.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -477,7 +483,7 @@
       <tr>
         <td><a class="xref" href="Terminal.View.html">View</a>[]</td>
         <td><span class="parametername">views</span></td>
-        <td><p>To be added.</p>
+        <td><p>Array of one or more views (can be optional parameter).</p>
 </td>
       </tr>
     </tbody>
@@ -527,7 +533,8 @@
   
   <a id="Terminal_View_ChildNeedsDisplay_" data-uid="Terminal.View.ChildNeedsDisplay*"></a>
   <h4 id="Terminal_View_ChildNeedsDisplay" data-uid="Terminal.View.ChildNeedsDisplay">ChildNeedsDisplay()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Flags this view for requiring the children views to be repainted.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -552,7 +559,8 @@
   
   <a id="Terminal_View_ClearNeedsDisplay_" data-uid="Terminal.View.ClearNeedsDisplay*"></a>
   <h4 id="Terminal_View_ClearNeedsDisplay" data-uid="Terminal.View.ClearNeedsDisplay">ClearNeedsDisplay()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Removes the SetNeedsDisplay and the ChildNeedsDisplay setting on this view.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -766,7 +774,8 @@
   
   <a id="Terminal_View_GetEnumerator_" data-uid="Terminal.View.GetEnumerator*"></a>
   <h4 id="Terminal_View_GetEnumerator" data-uid="Terminal.View.GetEnumerator">GetEnumerator()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Gets an enumerator that enumerates the subviews in this view.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -784,7 +793,7 @@ public System.Collections.IEnumerator GetEnumerator ();</code></pre>
     <tbody>
       <tr>
         <td><span class="xref">System.Collections.IEnumerator</span></td>
-        <td><p>To be added.</p>
+        <td><p>The enumerator.</p>
 </td>
       </tr>
     </tbody>
@@ -793,7 +802,10 @@ public System.Collections.IEnumerator GetEnumerator ();</code></pre>
   
   <a id="Terminal_View_LayoutSubviews_" data-uid="Terminal.View.LayoutSubviews*"></a>
   <h4 id="Terminal_View_LayoutSubviews" data-uid="Terminal.View.LayoutSubviews">LayoutSubviews()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>This virtual method is invoked when a view starts executing or 
+            when the dimensions of the view have changed, for example in 
+            response to the container view or terminal resizing.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -1145,7 +1157,8 @@ public System.Collections.IEnumerator GetEnumerator ();</code></pre>
   
   <a id="Terminal_View_SetNeedsDisplay_" data-uid="Terminal.View.SetNeedsDisplay*"></a>
   <h4 id="Terminal_View_SetNeedsDisplay_Terminal_Rect_" data-uid="Terminal.View.SetNeedsDisplay(Terminal.Rect)">SetNeedsDisplay(Rect)</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Flags the specified rectangle region on this view as needing to be repainted.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -1164,7 +1177,7 @@ public System.Collections.IEnumerator GetEnumerator ();</code></pre>
       <tr>
         <td><a class="xref" href="Terminal.Rect.html">Rect</a></td>
         <td><span class="parametername">region</span></td>
-        <td><p>To be added.</p>
+        <td><p>The region that must be flagged for repaint.</p>
 </td>
       </tr>
     </tbody>
@@ -1173,7 +1186,8 @@ public System.Collections.IEnumerator GetEnumerator ();</code></pre>
   
   <a id="Terminal_View_ToString_" data-uid="Terminal.View.ToString*"></a>
   <h4 id="Terminal_View_ToString" data-uid="Terminal.View.ToString">ToString()</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>Returns a <span class="xref">System.String</span> that represents the current <a class="xref" href="Terminal.View.html">View</a>.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -1190,7 +1204,7 @@ public System.Collections.IEnumerator GetEnumerator ();</code></pre>
     <tbody>
       <tr>
         <td><span class="xref">System.String</span></td>
-        <td><p>To be added.</p>
+        <td><p>A <span class="xref">System.String</span> that represents the current <a class="xref" href="Terminal.View.html">View</a>.</p>
 </td>
       </tr>
     </tbody>

docs/api/Terminal/Terminal.Window.html

@@ -131,9 +131,6 @@
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_Driver">View.Driver</a>
     </div>
-    <div>
-      <a class="xref" href="Terminal.View.html#Terminal_View_empty">View.empty</a>
-    </div>
     <div>
       <a class="xref" href="Terminal.View.html#Terminal_View_EnsureFocus">View.EnsureFocus()</a>
     </div>
@@ -259,7 +256,8 @@
   
   <a id="Terminal_Window_Title_" data-uid="Terminal.Window.Title*"></a>
   <h4 id="Terminal_Window_Title" data-uid="Terminal.Window.Title">Title</h4>
-  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 summary"><p>The title to be displayed for this window.</p>
+</div>
   <div class="markdown level1 conceptual"></div>
   <h5 class="decalaration">Declaration</h5>
   <div class="codewrapper">
@@ -276,7 +274,7 @@
     <tbody>
       <tr>
         <td><span class="xref">System.String</span></td>
-        <td><p>To be added.</p>
+        <td><p>The title.</p>
 </td>
       </tr>
     </tbody>

docs/xrefmap.yml

@@ -2841,11 +2841,6 @@ references:
   href: api/Terminal/Terminal.View.html#Terminal_View_Driver
   fullName: View.Driver
   nameWithType: View.Driver
-- uid: Terminal.View.empty
-  name: empty
-  href: api/Terminal/Terminal.View.html#Terminal_View_empty
-  fullName: View.empty
-  nameWithType: View.empty
 - uid: Terminal.View.EnsureFocus
   name: EnsureFocus()
   href: api/Terminal/Terminal.View.html#Terminal_View_EnsureFocus

ecmadocs/en/Terminal/Application.xml

@@ -73,8 +73,10 @@
         <ReturnType>Terminal.Toplevel</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            The current toplevel object.   This is updated when Application.Run enters and leaves and points to the current toplevel.
+            </summary>
+        <value>The current.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -104,7 +106,9 @@
         <ReturnType>Terminal.ConsoleDriver</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            The current Console Driver in use.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -197,8 +201,10 @@
         <ReturnType>Mono.Terminal.MainLoop</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            The mainloop driver for the applicaiton
+            </summary>
+        <value>The main loop.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -363,8 +369,10 @@
         <ReturnType>Terminal.Toplevel</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            The Toplevel object used for the application on startup.
+            </summary>
+        <value>The top.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

ecmadocs/en/Terminal/ConsoleDriver.xml

@@ -10,7 +10,9 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+            ConsoleDriver is an abstract class that defines the requirements for a console driver.   One implementation if the CursesDriver, and another one uses the .NET Console one.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

ecmadocs/en/Terminal/CursesDriver.xml

@@ -10,7 +10,9 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+            This is the Curses driver for the gui.cs/Terminal framework.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

ecmadocs/en/Terminal/Label.xml

@@ -135,8 +135,10 @@
         <ReturnType>Terminal.TextAlignment</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Controls the text-alignemtn property of the label, changing it will redisplay the label.
+            </summary>
+        <value>The text alignment.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -151,7 +153,9 @@
         <ReturnType>Terminal.Attribute</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+              The color used for the label
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

ecmadocs/en/Terminal/MenuBar.xml

@@ -27,8 +27,10 @@
         <Parameter Name="menus" Type="Terminal.MenuBarItem[]" />
       </Parameters>
       <Docs>
-        <param name="menus">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="menus">Menus.</param>
+        <summary>
+            Initializes a new instance of the <see cref="T:Terminal.MenuBar" /> class with the specified set of toplevel menu items.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -43,8 +45,10 @@
         <ReturnType>Terminal.MenuBarItem[]</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            The menus that were defined when the menubar was created.   This can be updated if the menu is not currently visible.
+            </summary>
+        <value>The menu array.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

ecmadocs/en/Terminal/MenuItem.xml

@@ -29,10 +29,12 @@
         <Parameter Name="action" Type="System.Action" />
       </Parameters>
       <Docs>
-        <param name="title">To be added.</param>
-        <param name="help">To be added.</param>
-        <param name="action">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="title">Title for the menu item.</param>
+        <param name="help">Help text to display.</param>
+        <param name="action">Action to invoke when the menu item is activated.</param>
+        <summary>
+            Initializes a new <see cref="T:Terminal.MenuItem" />.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -47,8 +49,10 @@
         <ReturnType>System.Action</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Gets or sets the action to be invoked when the menu is triggered
+            </summary>
+        <value>Method to invoke.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -63,8 +67,10 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Gets or sets the help text for the menu item.
+            </summary>
+        <value>The help text.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -79,7 +85,11 @@
         <ReturnType>System.Char</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            The hotkey is used when the menu is active, the shortcut can be triggered when the menu is not active.   
+            For example HotKey would be "N" when the File Menu is open (assuming there is a "_New" entry
+            if the ShortCut is set to "Control-N", this would be a global hotkey that would trigger as well
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -94,7 +104,9 @@
         <ReturnType>Terminal.Key</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            This is the global setting that can be used as a global shortcut to invoke the action on the menu.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -109,8 +121,10 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Gets or sets the title.
+            </summary>
+        <value>The title.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

ecmadocs/en/Terminal/MouseEvent.xml

@@ -45,8 +45,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>
+            Returns a <see cref="T:System.String" /> that represents the current <see cref="T:Terminal.MouseEvent" />.
+            </summary>
+        <returns>A <see cref="T:System.String" /> that represents the current <see cref="T:Terminal.MouseEvent" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

ecmadocs/en/Terminal/Toplevel.xml

@@ -32,8 +32,10 @@
         <Parameter Name="frame" Type="Terminal.Rect" />
       </Parameters>
       <Docs>
-        <param name="frame">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="frame">Frame.</param>
+        <summary>
+            Initializes a new instance of the <see cref="T:Terminal.Toplevel" /> class.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -65,8 +67,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>
+            Convenience factory method that creates a new toplevel with the current terminal dimensions.
+            </summary>
+        <returns>The create.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

ecmadocs/en/Terminal/View.xml

@@ -14,8 +14,27 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>
+            View is the base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.
+            </summary>
+    <remarks>
+      <para>
+               The View defines the base functionality for user interface elements in Terminal/gui.cs.  Views
+               can contain one or more subviews, can respond to user input and render themselves on the screen.
+            </para>
+      <para>
+               Views are created with a specified rectangle region (the frame) that is relative to the container
+               that they are added into.   
+            </para>
+      <para>
+               Subviews can be added to a View by calling the Add method.   The container of a view is the 
+               Superview.
+            </para>
+      <para>
+               Developers can call the SetNeedsDisplay method on the view to flag a region or the entire view
+               as requiring to be redrawn.
+            </para>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -29,8 +48,10 @@
         <Parameter Name="frame" Type="Terminal.Rect" />
       </Parameters>
       <Docs>
-        <param name="frame">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="frame">The region covered by this view.</param>
+        <summary>
+            Initializes a new instance of the <see cref="T:Terminal.View" /> class with the specified frame.   This is the default constructor.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -75,8 +96,10 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="views">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="views">Array of one or more views (can be optional parameter).</param>
+        <summary>
+            Adds the specified views to the view.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -116,8 +139,10 @@
         <ReturnType>Terminal.Rect</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            The bounds represent the View-relative rectangle used for this view.   Updates to the Bounds update the Frame, and has the same side effects as updating the frame.
+            </summary>
+        <value>The bounds.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -133,7 +158,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Flags this view for requiring the children views to be repainted.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -171,7 +198,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Removes the SetNeedsDisplay and the ChildNeedsDisplay setting on this view.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -259,22 +288,10 @@
         <ReturnType>Terminal.ConsoleDriver</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
-      </Docs>
-    </Member>
-    <Member MemberName="empty">
-      <MemberSignature Language="C#" Value="public static System.Collections.Generic.IList&lt;Terminal.View&gt; empty;" />
-      <MemberSignature Language="ILAsm" Value=".field public static class System.Collections.Generic.IList`1&lt;class Terminal.View&gt; empty" />
-      <MemberType>Field</MemberType>
-      <AssemblyInfo>
-        <AssemblyVersion>0.0.0.0</AssemblyVersion>
-      </AssemblyInfo>
-      <ReturnValue>
-        <ReturnType>System.Collections.Generic.IList&lt;Terminal.View&gt;</ReturnType>
-      </ReturnValue>
-      <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Points to the current driver in use by the view, it is a convenience property
+            for simplifying the development of new views.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -401,9 +418,14 @@
         <ReturnType>Terminal.Rect</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>
+            Gets or sets the frame for the view.
+            </summary>
+        <value>The frame.</value>
+        <remarks>
+               Altering the Frame of a view will trigger the redrawing of the 
+               view as well as the redrawing of the affected regions in the superview.
+            </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetEnumerator">
@@ -423,8 +445,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>
+            Gets an enumerator that enumerates the subviews in this view.
+            </summary>
+        <returns>The enumerator.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -439,8 +463,11 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Gets or sets a value indicating whether this <see cref="T:Terminal.View" /> has focus.
+            </summary>
+        <value>
+          <c>true</c> if has focus; otherwise, <c>false</c>.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -472,7 +499,11 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            This virtual method is invoked when a view starts executing or 
+            when the dimensions of the view have changed, for example in 
+            response to the container view or terminal resizing.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -487,8 +518,10 @@
         <ReturnType>Terminal.View</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Returns the most focused view in the chain of subviews (the leaf view that has the focus).
+            </summary>
+        <value>The most focused.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -734,8 +767,10 @@
         <Parameter Name="region" Type="Terminal.Rect" />
       </Parameters>
       <Docs>
-        <param name="region">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="region">The region that must be flagged for repaint.</param>
+        <summary>
+            Flags the specified rectangle region on this view as needing to be repainted.
+            </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -750,8 +785,10 @@
         <ReturnType>System.Collections.Generic.IList&lt;Terminal.View&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            This returns a list of the subviews contained by this view.
+            </summary>
+        <value>The subviews.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -766,8 +803,10 @@
         <ReturnType>Terminal.View</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            Returns the container for this view, or null if this view has not been added to a container.
+            </summary>
+        <value>The super view.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -783,8 +822,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>
+            Returns a <see cref="T:System.String" /> that represents the current <see cref="T:Terminal.View" />.
+            </summary>
+        <returns>A <see cref="T:System.String" /> that represents the current <see cref="T:Terminal.View" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

ecmadocs/en/Terminal/Window.xml

@@ -110,8 +110,10 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>
+            The title to be displayed for this window.
+            </summary>
+        <value>The title.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>