New Issue: [Bug]: 'chpldoc' errors out for 'use'ed enums with '--process-used-modules'

25620, "ShreyasKhandekar", "[Bug]: 'chpldoc' errors out for 'use'ed enums with '--process-used-modules'", "2024-07-23T23:51:08Z"

Summary of Problem

Given a simple enum that is used in a subsequent statement and running chpldoc --process-used-modules I get:

Warning, treated as error:
/tmp/chpldoc-khandeka.deleteme-BC1zKm/source/modules/demo/bar.rst:1:Unknown directive type "enum".

.. enum:: enum bar { baz }

   .. enumconstant:: enum constant baz
error: building html output from chpldoc sphinx project

It looks like useing the enum makes chpldoc treat it like a module? It tries to give the enum it's own rst file too.

Is this issue currently blocking your progress?
Currently holding up Add initial implementation for Sparse Matrix Mult by ShreyasKhandekar · Pull Request #3516 · Bears-R-Us/arkouda · GitHub

Steps to Reproduce

Source Code:

enum bar {
  baz
};
use bar;

Execution command:
chpldoc --process-used-modules demo.chpl

Configuration Information
  • Output of chpl --version:
chpl --versionchpl version 2.2.0 pre-release (06ed102581)
  built with LLVM version 15.0.4
  available LLVM targets: nvptx64, nvptx, x86-64, x86, amdgcn, r600
Copyright 2020-2024 Hewlett Packard Enterprise Development LP
Copyright 2004-2019 Cray Inc.
(See LICENSE file for more details)
  • Output of $CHPL_HOME/util/printchplenv --anonymize:
CHPL_TARGET_PLATFORM: linux64
CHPL_TARGET_COMPILER: llvm
CHPL_TARGET_ARCH: x86_64
CHPL_TARGET_CPU: none *
CHPL_LOCALE_MODEL: flat
CHPL_COMM: gasnet *
  CHPL_COMM_SUBSTRATE: udp
  CHPL_GASNET_SEGMENT: everything
CHPL_TASKS: qthreads
CHPL_LAUNCHER: amudprun
CHPL_TIMERS: generic
CHPL_UNWIND: none
CHPL_MEM: jemalloc
CHPL_ATOMICS: cstdlib
  CHPL_NETWORK_ATOMICS: none
CHPL_GMP: bundled
CHPL_HWLOC: bundled
CHPL_RE2: bundled
CHPL_LLVM: system
CHPL_AUX_FILESYS: none