[Chapel Merge] next: Get the compiler/next docs to build again

Branch: refs/heads/main
Revision: 21b94a7
Author: dlongnecke-cray
Log Message:

Merge pull request #18376 from dlongnecke-cray/next-build-docs

next: Get the compiler/next docs to build again

This is for compiler/next.

Add Doxygen directives to compiler/next header files and add types
to $CHPL_HOME/doc/util/nitpick_ignore as necessary to get the
docs for the new compiler to build.

Add a text document to $CHPL_HOME/compiler/next/doc that describes
some ways in which the docs can break. This may prove useful as
more developers begin to work on the new compiler.

Reviewed by @mppf. Thanks!


  • [x] Can build chpl
  • [x] Can build docs with compiler-internals enabled

Signed-off-by: David Longnecker dlongnecke-cray@users.noreply.github.com

Modified Files:
A compiler/next/doc/doxygen-pitfalls.txt

M compiler/next/include/chpl/queries/update-functions.h
M compiler/next/include/chpl/resolution/resolution-types.h
M compiler/next/include/chpl/resolution/scope-types.h
M doc/util/nitpick_ignore

Compare: https://github.com/chapel-lang/chapel/compare/25da47dc7ba9...21b94a7f0d50