Scaladoc ignores package objects of otherwise empty packages

[scabug]

Scaladoc does not appear to produce any documentation for doc-commented package objects whose packages contain no other top-level entities. For example, a package of top-level functions, all defined in the package object, is not shown at all in the Scaladoc output.

[scabug]

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

[scabug]

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

[scabug]

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.

[sjrd]

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

[ruippeixotog]

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 :)

[som-snytt]

@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.