Imported From: https://issues.scala-lang.org/browse/SI-8124?orig=1
Reporter: Jeffrey Schwab (jeff)
Affected Versions: 2.10.3, 2.11.8, 2.12.1

@som-snytt said:
One idea:
scala/scala#3353

Andrzej Giniewicz (giniu) said:
Any news on that one? To generate documentation for macros packages I had to change package object into object to make it appear at all, but it isn't ideal solution.

Still broken in Scala 2.12's new Scaladoc. See for example the doc at https://www.scala-js.org/api/scalajs-library/1.0.0-M1/scala/scalajs/js/index.html, where the subpackage js.special is completely absent from the documentation.

FTR, its source is here: https://github.com/scala-js/scala-js/blob/master/library/src/main/scala/scala/scalajs/js/special/package.scala

After some debugging, it seems that scaladoc is ignoring package objects here when it shouldn't. However, (naively) removing the aSym.isPackageObject condition makes scaladoc exit with a stack overflow.

@VladUreche, can you point me out to where in the code should I be looking? Should I try to make a special case here for a package object with no "class/object" contents here? I don't know at all the scaladoc architecture, but I may be able to find a fix if you help me :)

@ruippeixotog I don't remember my approach, but I intervened earlier, it seems. Since I submitted a PR, it must have been close but no cigar.

Any plane to get this bug fixed? This situation is quite common when we create a DSL on top of Java library. Thanks