C++ extractor parsing slang.h (#2162)

* #include an absolute path didn't work - because paths were taken to always be relative.

* Split doc extractor such that can be used in C++ extractor.

* Compiles. Update the stdlib docs.

* Fix issue on release builds.

* Add support for extracting documentation to C++ extractor.

* Dump out markup.
Make enum value backing type take tokens.

* Node::Type -> Node::Kind

* More improvements around Node::Type -> Node::Kind

* Support for parsing callable types.

* Fix issue params for callable, and default value for variable.

* Add support for static.

* Improve handling parsing of contained types.

* Small improvements around template consumption.

* Improve dumping with markup/static.

* Small improvements around reflection.

* Add more flexible handling of markers.
Allow reflection without markers.

* Handling external "C"
unsigned/signed

1 files changed, 15 insertions, 0 deletions

diff --git a/tools/slang-cpp-extractor/cpp-extractor-main.cpp b/tools/slang-cpp-extractor/cpp-extractor-main.cpp
index 371392851..6fbba20c3 100644
--- a/tools/slang-cpp-extractor/cpp-extractor-main.cpp
+++ b/tools/slang-cpp-extractor/cpp-extractor-main.cpp
@@ -314,6 +314,21 @@ SlangResult App::executeWithArgs(int argc, const char*const* argv)
 
 } // namespace CppExtract
 
+
+/*
+The typical command line for producing generated slang files. Can be determined by setting `dumpCommandLine` belong and compiling.
+
+```
+-d E:\git\slang-jsmall-nvidia\source\slang\ slang-ast-support-types.h slang-ast-base.h slang-ast-decl.h slang-ast-expr.h slang-ast-modifier.h slang-ast-stmt.h slang-ast-type.h slang-ast-val.h -strip-prefix slang- -o slang-generated -output-fields -mark-suffix _CLASS
+```
+
+A command line to try and parse the slang.h
+
+```
+-d E:\git\slang-jsmall-nvidia slang.h -mark-suffix _CLASS -dump  -unmarked -unit-test
+```
+*/
+
 int main(int argc, const char*const* argv)
 {
     using namespace CppExtract;