[Chapel Merge] feat(dyno-chpldoc): process used and included modu

Notifications Commits
1

Branch: refs/heads/main
Revision: 38d5c0d
Author: arezaii
Link: feat(dyno-chpldoc): process used and included modules by arezaii · Pull Request #20457 · chapel-lang/chapel · GitHub
Log Message:

Merge pull request #20457 from arezaii/dyno-chpldoc-process-used-mods

feat(dyno-chpldoc): process used and included modules

This PR adds fixes to allow dyno-chpldoc to handle used/imported modules
when the --process-used-modules flag is provided from the command line.
It also provides the ability to process modules from include statements as
if they were submodules.

Some other notable fixes:

  • Print the filename and line number information when a comment with a bad
    close is encountered.

  • Add the relative path of a file as the submodule search path when parsing
    a file from the command line.

  • Use context's built in report method to print errors.

TESTING:

  • diff doc directory w/make docs output using chpldoc
  • test/chpldoc has 5 remaining failures, all relating to multi-decls
    printing where they didn't before
  • paratest

reviewed by @mppf - thanks!

Signed-off-by: arezaii ahmad.rezaii@hpe.com

Modified Files:
A test/chpldoc/include/NoDocInclude.chpl

A test/chpldoc/include/NoDocInclude.notest
A test/chpldoc/include/NoDocInclude/NoDocSubModule.chpl
A test/chpldoc/include/test-NoDocInclude.doc.catfiles
A test/chpldoc/include/test-NoDocInclude.doc.chpl
A test/chpldoc/include/test-NoDocInclude.doc.good
A test/chpldoc/module/IOTestModule.chpl
A test/chpldoc/module/IOTestModule.notest
A test/chpldoc/module/publicUseIOTest.doc.catfiles
A test/chpldoc/module/publicUseIOTest.doc.chpl
A test/chpldoc/module/publicUseIOTest.doc.chpldocopts
A test/chpldoc/module/publicUseIOTest.doc.good
A test/chpldoc/module/recursiveModuleTest.doc.catfiles
A test/chpldoc/module/recursiveModuleTest.doc.chpl
A test/chpldoc/module/recursiveModuleTest.doc.chpldocopts
A test/chpldoc/module/recursiveModuleTest.doc.good
M compiler/dyno/include/chpl/resolution/scope-queries.h
M compiler/dyno/lib/resolution/scope-queries.cpp
M compiler/dyno/tools/chpldoc/chpldoc.cpp

Compare: https://github.com/chapel-lang/chapel/compare/b131550ff3b7...38d5c0d12c84