diff --git a/docfx/README.md b/docfx/README.md
index 42477bcd9..c12d87a75 100644
--- a/docfx/README.md
+++ b/docfx/README.md
@@ -4,9 +4,9 @@ The API documentation is generated using the [DocFX tool](https://github.com/dot
## To Generate the Docs
-1. Do a `Release` build on `master`. This will cause all `/// ` references to be updated.
-2. Change in to the `docfx/` directory.
-3. Type `docfx --metadata` to generate metadata
-4. Type `docfx --serve` to generate the docs and start a local webserver for testing.
+0. Install DotFX https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
+1. Change to the `./docfx` folder and run `./build.ps1`
+2. Browse to http://localhost:8080 and verify everything looks good.
+3. Hit ctrl-c to stop the script.
If `docfx` fails with a `Stackoverflow` error. Just run it again. And again. Sometimes it takes a few times. If that doesn't work, create a fresh clone or delete the `docfx/api`, `docfx/obj`, and `docs/` folders and run the steps above again.
diff --git a/docfx/build.ps1 b/docfx/build.ps1
new file mode 100644
index 000000000..568687fe6
--- /dev/null
+++ b/docfx/build.ps1
@@ -0,0 +1,9 @@
+# Builds the Terminal.gui API documentation using docfx
+
+dotnet build --configuration Release ../Terminal.sln
+
+rm ../docs -Recurse -Force
+
+docfx --metadata
+
+docfx --serve
\ No newline at end of file
diff --git a/docs/README.html b/docs/README.html
index 08a3e8b58..b732397af 100644
--- a/docs/README.html
+++ b/docs/README.html
@@ -71,13 +71,15 @@
-This folder generates the API docs for Terminal.Gui
+This folder generates the API docs for Terminal.Gui.
+The API documentation is generated using the DocFX tool. The output of docfx gets put into the ./docs folder which is then checked in. The ./docs folder is then picked up by Github Pages and published to Miguel's Github Pages (https://migueldeicaza.github.io/gui.cs/).
To Generate the Docs
-- Do a
Release build on master. This will cause all /// <inheritdoc/> references to be updated.
-- Change in to the
docfx/ directory.
-- Type
docfx --metadata to generate metadata
-- Type
docfx --serve to generate the docs and start a local webserver for testing.
+- Install DotFX https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
+- From the solution root type
../docfx/build.ps1
+- Browse to http://localhost:8080 and verify everything looks good.
+- Hit ctrl-c to stop the script.
+- Commit to git.
If docfx fails with a Stackoverflow error. Just run it again. And again. Sometimes it takes a few times. If that doesn't work, create a fresh clone or delete the docfx/api, docfx/obj, and docs/ folders and run the steps above again.
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.Button.html b/docs/api/Terminal.Gui/Terminal.Gui.Button.html
index 5d1cb2a73..ca4c4e386 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.Button.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.Button.html
@@ -97,7 +97,6 @@ Button is a
View that provides
Implements
System.IDisposable
-
System.Collections.IEnumerable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
@@ -130,6 +129,9 @@ Button is a
View that provides
+
@@ -163,9 +165,6 @@ Button is a
View that provides
-
@@ -349,6 +348,9 @@ Button is a
View that provides
+
@@ -387,7 +389,7 @@ Button is a
View that provides
Assembly: Terminal.Gui.dll
-
public class Button : View, IDisposable, IEnumerable, ISupportInitializeNotification, ISupportInitialize
+
public class Button : View, IDisposable, ISupportInitializeNotification, ISupportInitialize
+
Events
+
+
+
+
+
+Clicked
System.Action, raised when the user clicks the primary mouse button within the Bounds of this
View
+or if the user presses the action key while this view is focused. (TODO: IsDefault)
+
+
+
Declaration
+
+
public event Action Clicked
+
+
Event Type
+
+
+
+ | Type |
+ Description |
+
+
+
+
+ | System.Action |
+ |
+
+
+
+
+
Implements
System.IDisposable
-
- System.Collections.IEnumerable
-
System.ComponentModel.ISupportInitializeNotification
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.CheckBox.html b/docs/api/Terminal.Gui/Terminal.Gui.CheckBox.html
index 5f6734a6d..441f62f3c 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.CheckBox.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.CheckBox.html
@@ -97,7 +97,6 @@ The
CheckBox
Implements
System.IDisposable
- System.Collections.IEnumerable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
@@ -130,6 +129,9 @@ The CheckBox View.HotKeySpecifier
+
@@ -163,9 +165,6 @@ The CheckBox View.Frame
-
@@ -352,6 +351,9 @@ The CheckBox View.OnMouseEvent(MouseEvent)
+
@@ -390,7 +392,7 @@ The CheckBox Syntax
-
public class CheckBox : View, IDisposable, IEnumerable, ISupportInitializeNotification, ISupportInitialize
+
public class CheckBox : View, IDisposable, ISupportInitializeNotification, ISupportInitialize
Constructors
@@ -532,40 +534,6 @@ Initializes a new instance of
- Fields
-
-
-
- Toggled
-
-Toggled event, raised when the
CheckBox is toggled.
-
-
- Declaration
-
-
public Action<bool> Toggled
-
- Field Value
-
-
-
- | Type |
- Description |
-
-
-
-
- | System.Action<System.Boolean> |
- |
-
-
-
-
-
Properties
@@ -824,14 +792,45 @@ Redraws this view and its subviews; only redraws the views that have been flagge
Overrides of Redraw(Rect) must ensure they do not set Driver.Clip to a clip region
larger than the region parameter.
+
+ Events
+
+
+
+ Toggled
+
+Toggled event, raised when the
CheckBox is toggled.
+
+
+ Declaration
+
+
public event Action<bool> Toggled
+
+ Event Type
+
+
+
+ | Type |
+ Description |
+
+
+
+
+ | System.Action<System.Boolean> |
+ |
+
+
+
+
+
Implements
System.IDisposable
-
- System.Collections.IEnumerable
-
System.ComponentModel.ISupportInitializeNotification
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.ComboBox.html b/docs/api/Terminal.Gui/Terminal.Gui.ComboBox.html
index 9582c5851..770cdd654 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.ComboBox.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.ComboBox.html
@@ -97,7 +97,6 @@ ComboBox control
Implements
System.IDisposable
-
System.Collections.IEnumerable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
@@ -130,6 +129,9 @@ ComboBox control
+
@@ -163,9 +165,6 @@ ComboBox control
-
@@ -346,6 +345,9 @@ ComboBox control
+
@@ -384,7 +386,7 @@ ComboBox control
Assembly: Terminal.Gui.dll
Syntax
-
public class ComboBox : View, IDisposable, IEnumerable, ISupportInitializeNotification, ISupportInitialize
+
public class ComboBox : View, IDisposable, ISupportInitializeNotification, ISupportInitialize
Constructors
@@ -463,60 +465,6 @@ Public constructor
- Fields
-
-
-
- OpenSelectedItem
-
-This event is raised when the user Double Clicks on an item or presses ENTER to open the selected item.
-
-
- Declaration
-
-
public Action<ListViewItemEventArgs> OpenSelectedItem
-
- Field Value
-
-
-
- SelectedItemChanged
-
-This event is raised when the selected item in the
ComboBox has changed.
-
-
- Declaration
-
-
public Action<ListViewItemEventArgs> SelectedItemChanged
-
- Field Value
-
Properties
@@ -967,13 +915,64 @@ Sets the source of the ComboBo
+ Events
+
+
+
+ OpenSelectedItem
+
+This event is raised when the user Double Clicks on an item or presses ENTER to open the selected item.
+
+
+ Declaration
+
+
public event Action<ListViewItemEventArgs> OpenSelectedItem
+
+ Event Type
+
+
+
+ SelectedItemChanged
+
+This event is raised when the selected item in the
ComboBox has changed.
+
+
+ Declaration
+
+
public event Action<ListViewItemEventArgs> SelectedItemChanged
+
+ Event Type
+
Implements
System.IDisposable
-
- System.Collections.IEnumerable
-
System.ComponentModel.ISupportInitializeNotification
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.DateField.html b/docs/api/Terminal.Gui/Terminal.Gui.DateField.html
index d6d85e155..1b389d41e 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.DateField.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.DateField.html
@@ -98,7 +98,6 @@ Simple Date editing View
Implements
System.IDisposable
-
System.Collections.IEnumerable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
@@ -185,6 +184,9 @@ Simple Date editing View
+
@@ -212,9 +214,6 @@ Simple Date editing View
-
@@ -398,6 +397,9 @@ Simple Date editing View
+
@@ -436,7 +438,7 @@ Simple Date editing View
Assembly: Terminal.Gui.dll
Syntax
-
public class DateField : TextField, IDisposable, IEnumerable, ISupportInitializeNotification, ISupportInitialize
+
public class DateField : TextField, IDisposable, ISupportInitializeNotification, ISupportInitialize
+ Events
+
+
+
+ DateChanged
+
+DateChanged event, raised when the
Date property has changed.
+
+
+ Declaration
+
+
public event Action<DateTimeEventArgs<DateTime>> DateChanged
+
+ Event Type
+
+
+
+ | Type |
+ Description |
+
+
+
+
+ | System.Action<DateTimeEventArgs<System.DateTime>> |
+ |
+
+
+
+
+
Implements
System.IDisposable
-
- System.Collections.IEnumerable
-
System.ComponentModel.ISupportInitializeNotification
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.Dialog.html b/docs/api/Terminal.Gui/Terminal.Gui.Dialog.html
index f46767b3f..e397f0e36 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.Dialog.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.Dialog.html
@@ -103,16 +103,12 @@ or more Buttons. It defaults
System.IDisposable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
- System.Collections.IEnumerable
Inherited Members
-
@@ -191,6 +187,9 @@ or more
Buttons. It defaults
+
@@ -392,6 +391,9 @@ or more
Buttons. It defaults
+
@@ -430,7 +432,7 @@ or more
Buttons. It defaults
Assembly: Terminal.Gui.dll
Syntax
-
public class Dialog : Window, IDisposable, ISupportInitializeNotification, ISupportInitialize, IEnumerable
+
public class Dialog : Window, IDisposable, ISupportInitializeNotification, ISupportInitialize
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.FileDialog.html b/docs/api/Terminal.Gui/Terminal.Gui.FileDialog.html
index 59dae4fbe..17e71694c 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.FileDialog.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.FileDialog.html
@@ -104,7 +104,6 @@ Base class for the
OpenDialo
System.IDisposable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
- System.Collections.IEnumerable
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.FrameView.html b/docs/api/Terminal.Gui/Terminal.Gui.FrameView.html
index e1abf2432..bb1af6400 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.FrameView.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.FrameView.html
@@ -98,7 +98,6 @@ a GroupBox in Windows.
Implements
System.IDisposable
-
System.Collections.IEnumerable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
@@ -131,6 +130,9 @@ a GroupBox in Windows.
+
@@ -164,9 +166,6 @@ a GroupBox in Windows.
-
@@ -347,6 +346,9 @@ a GroupBox in Windows.
+
@@ -388,7 +390,7 @@ a GroupBox in Windows.
Assembly: Terminal.Gui.dll
Syntax
-
public class FrameView : View, IDisposable, IEnumerable, ISupportInitializeNotification, ISupportInitialize
+
public class FrameView : View, IDisposable, ISupportInitializeNotification, ISupportInitialize
Constructors
@@ -726,9 +728,6 @@ Removes all Views from this co
System.IDisposable
-
- System.Collections.IEnumerable
-
System.ComponentModel.ISupportInitializeNotification
diff --git a/docs/api/Terminal.Gui/Terminal.Gui.HexView.html b/docs/api/Terminal.Gui/Terminal.Gui.HexView.html
index 560d3e7d1..e8a021e8f 100644
--- a/docs/api/Terminal.Gui/Terminal.Gui.HexView.html
+++ b/docs/api/Terminal.Gui/Terminal.Gui.HexView.html
@@ -97,7 +97,6 @@ An hex viewer and editor View
Implements
System.IDisposable
-
System.Collections.IEnumerable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
@@ -130,6 +129,9 @@ An hex viewer and editor View
+
@@ -160,9 +162,6 @@ An hex viewer and editor View
-
@@ -352,6 +351,9 @@ An hex viewer and editor View
+
@@ -393,7 +395,7 @@ An hex viewer and editor View
Assembly: Terminal.Gui.dll
Syntax
-
public class HexView : View, IDisposable, IEnumerable, ISupportInitializeNotification, ISupportInitialize
+
public class HexView : View, IDisposable, ISupportInitializeNotification, ISupportInitialize