From 29cb65585782f71a9c6fa1062eaa0b8de8359604 Mon Sep 17 00:00:00 2001
From: jsmall-nvidia <jsmall@nvidia.com>
Date: Tue, 2 May 2023 11:10:58 -0400
Subject: 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.
---
 build/visual-studio/core/core.vcxproj                 | 2 ++
 build/visual-studio/core/core.vcxproj.filters         | 6 ++++++
 build/visual-studio/slang-rt/slang-rt.vcxproj         | 2 ++
 build/visual-studio/slang-rt/slang-rt.vcxproj.filters | 6 ++++++
 4 files changed, 16 insertions(+)

(limited to 'build')

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>
-- 
cgit v1.2.3