Markdown CommandOptions (#2860)

* WIP CommandOptions

* Fix some output issues.

* Simplify word wrapping.

* Add file extensions.

* Change how lookup takes place.
Add appendSplit functions to StringUtil.
Make Categories hold the index range of their options.

* Small improvement.

* Lookup with partial option names.

* Associate user values.

* Encoding flags in the name.

* Refactor setting up of command options.

* Use CommandOptions in slang-options.

* Remove old help text.

* Cache the CommandOptions on the Session.

* Range checking.
Fix bug in the Options handling.

* Extra checks for validity.

* Get categories directly.

* Slight improvements over output.

* Added NameValue types.

* Fix typo.
Remove some now unused diagnostics.
Fix diagnostic in testing, as output has changed.

* Add minimal usage message.

* Remove platform executable extension from diagnostics output.

* Some improvements around getting names from NameValue types.

* Improve some option descriptions.

* Small fixes.

* WIP improvements around CommandOptions.

* Split out CommandOptionsWriter.

* Add links to options.

* Add command line options reference.

* Link to the reference command line information.

* Add quick links.

* Improvements around lookup.
Add categories to linking.

* Small additional fixes.

* Add LinkFlags control.

* Small text fixes.

* Fix typo.

* Fix typo.

* Fix typo.

* Add support for -g and -O using CommandOptions.

* Improve generated doc output/descriptions.
Remove options listed directly in documentation.

4 files changed, 16 insertions, 0 deletions

diff --git a/build/visual-studio/core/core.vcxproj b/build/visual-studio/core/core.vcxproj
index 90fcfe8ef..559dde3b4 100644
--- a/build/visual-studio/core/core.vcxproj
+++ b/build/visual-studio/core/core.vcxproj
@@ -278,6 +278,7 @@
     <ClInclude Include="..\..\..\source\core\slang-chunked-list.h" />

     <ClInclude Include="..\..\..\source\core\slang-com-object.h" />

     <ClInclude Include="..\..\..\source\core\slang-command-line.h" />

+    <ClInclude Include="..\..\..\source\core\slang-command-options-writer.h" />

     <ClInclude Include="..\..\..\source\core\slang-command-options.h" />

     <ClInclude Include="..\..\..\source\core\slang-common.h" />

     <ClInclude Include="..\..\..\source\core\slang-compression-system.h" />

@@ -344,6 +345,7 @@
     <ClCompile Include="..\..\..\source\core\slang-char-encode.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-char-util.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp" />

+    <ClCompile Include="..\..\..\source\core\slang-command-options-writer.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-command-options.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-crypto.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-deflate-compression-system.cpp" />

diff --git a/build/visual-studio/core/core.vcxproj.filters b/build/visual-studio/core/core.vcxproj.filters
index 41d0fafe1..11c689121 100644
--- a/build/visual-studio/core/core.vcxproj.filters
+++ b/build/visual-studio/core/core.vcxproj.filters
@@ -48,6 +48,9 @@
     <ClInclude Include="..\..\..\source\core\slang-command-line.h">

       <Filter>Header Files</Filter>

     </ClInclude>

+    <ClInclude Include="..\..\..\source\core\slang-command-options-writer.h">

+      <Filter>Header Files</Filter>

+    </ClInclude>

     <ClInclude Include="..\..\..\source\core\slang-command-options.h">

       <Filter>Header Files</Filter>

     </ClInclude>

@@ -242,6 +245,9 @@
     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

+    <ClCompile Include="..\..\..\source\core\slang-command-options-writer.cpp">

+      <Filter>Source Files</Filter>

+    </ClCompile>

     <ClCompile Include="..\..\..\source\core\slang-command-options.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

diff --git a/build/visual-studio/slang-rt/slang-rt.vcxproj b/build/visual-studio/slang-rt/slang-rt.vcxproj
index 41c44a051..ad3136e66 100644
--- a/build/visual-studio/slang-rt/slang-rt.vcxproj
+++ b/build/visual-studio/slang-rt/slang-rt.vcxproj
@@ -290,6 +290,7 @@
     <ClInclude Include="..\..\..\source\core\slang-chunked-list.h" />

     <ClInclude Include="..\..\..\source\core\slang-com-object.h" />

     <ClInclude Include="..\..\..\source\core\slang-command-line.h" />

+    <ClInclude Include="..\..\..\source\core\slang-command-options-writer.h" />

     <ClInclude Include="..\..\..\source\core\slang-command-options.h" />

     <ClInclude Include="..\..\..\source\core\slang-common.h" />

     <ClInclude Include="..\..\..\source\core\slang-compression-system.h" />

@@ -357,6 +358,7 @@
     <ClCompile Include="..\..\..\source\core\slang-char-encode.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-char-util.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp" />

+    <ClCompile Include="..\..\..\source\core\slang-command-options-writer.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-command-options.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-crypto.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-deflate-compression-system.cpp" />

diff --git a/build/visual-studio/slang-rt/slang-rt.vcxproj.filters b/build/visual-studio/slang-rt/slang-rt.vcxproj.filters
index 4fa4373ff..a33803e0e 100644
--- a/build/visual-studio/slang-rt/slang-rt.vcxproj.filters
+++ b/build/visual-studio/slang-rt/slang-rt.vcxproj.filters
@@ -48,6 +48,9 @@
     <ClInclude Include="..\..\..\source\core\slang-command-line.h">

       <Filter>Header Files</Filter>

     </ClInclude>

+    <ClInclude Include="..\..\..\source\core\slang-command-options-writer.h">

+      <Filter>Header Files</Filter>

+    </ClInclude>

     <ClInclude Include="..\..\..\source\core\slang-command-options.h">

       <Filter>Header Files</Filter>

     </ClInclude>

@@ -245,6 +248,9 @@
     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

+    <ClCompile Include="..\..\..\source\core\slang-command-options-writer.cpp">

+      <Filter>Source Files</Filter>

+    </ClCompile>

     <ClCompile Include="..\..\..\source\core\slang-command-options.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>