[Chapel Merge] Updates to dyno-chpldoc to pass more chpldoc tests

Notifications Commits
1

Branch: refs/heads/main
Revision: 8d48597
Author: arezaii
Link: Updates to dyno-chpldoc to pass more chpldoc tests by arezaii · Pull Request #19994 · chapel-lang/chapel · GitHub
Log Message:

Merge pull request #19994 from arezaii/chpldoc-cont

Updates to dyno-chpldoc to pass more chpldoc tests

This PR contains work to get dyno-chpldoc able to pass more
of our chpldoc test suite. At the end of the previous sprint,
dyno-chpldoc could pass ~29/150 tests. With these changes we
can now pass ~46/150 tests.

Changes included in this PR:

  • print out parent when child class inherits

  • add override keyword for procs

  • address pathing for submodules in use and import stmts

  • add handling for custom comment indicators

  • ignore comments that start with //

  • special handling to write empty line after enum docs
    before a deprecation message

  • write a generic deprecation message for marked items with
    no message of their own

  • skip generic deprecation message if deprecat found in docs

  • ignore things marked no doc

  • ignore some things marked private

reviewed by @benharsh and @mppf - thanks!

TESTING: