Kotlin / dokka

API documentation engine for Kotlin
https://kotl.in/dokka
Apache License 2.0
3.37k stars 397 forks source link

Trying to generate entire Android SDK doc: stackoverflow #3645

Open jderijke opened 1 month ago

jderijke commented 1 month ago

Describe the bug Google does not provide the doc for the android sdk anymore. So I put the SDK source code (in %userprofile%\AppData\Local\Android\Sdk) for SDK 34 (Android 14) in an IntelliJ kotlin project and tried generating the doc using Dokka. Originally I always got an outofmemory error on my gradle damon. I have raised memory in gradle.properties

org.gradle.jvmargs=-Xmx10g "-XX:MaxMetaspaceSize=5g"

But now I get a stackoverflow error when executing the dokkaHtml gradle task: Cause: java.lang.StackOverflowError

at com.intellij.openapi.util.UserDataHolderBase.getUserData(UserDataHolderBase.java:48)
    at com.intellij.psi.impl.source.resolve.FileContextUtil.getFileContext(FileContextUtil.java:19)
    at com.intellij.psi.impl.source.PsiFileImpl.getContext(PsiFileImpl.java:567)
    at com.intellij.psi.impl.source.PsiFileImpl.getModificationStamp(PsiFileImpl.java:344)
    at com.intellij.psi.impl.source.PsiModifierListImpl$ModifierCache.getModCount(PsiModifierListImpl.java:350)
    at com.intellij.psi.impl.source.PsiModifierListImpl$ModifierCache.isUpToDate(PsiModifierListImpl.java:354)
    at com.intellij.psi.impl.source.PsiModifierListImpl.hasModifierProperty(PsiModifierListImpl.java:72)
    at com.intellij.psi.util.PsiUtil.getAccessLevel(PsiUtil.java:391)
    at com.intellij.psi.impl.source.resolve.JavaResolveUtil.isAccessible(JavaResolveUtil.java:99)
    at com.intellij.psi.impl.source.resolve.JavaResolveUtil.isAccessible(JavaResolveUtil.java:60)
    at com.intellij.psi.impl.source.resolve.PsiResolveHelperImpl.isAccessible(PsiResolveHelperImpl.java:129)
    at com.intellij.psi.impl.source.resolve.PsiResolveHelperImpl.isAccessible(PsiResolveHelperImpl.java:119)
    at com.intellij.psi.impl.search.MethodSuperSearcher.isAcceptable(MethodSuperSearcher.java:73)
    at com.intellij.psi.impl.search.MethodSuperSearcher.addSuperMethods(MethodSuperSearcher.java:52)
    at com.intellij.psi.impl.search.MethodSuperSearcher.processQuery(MethodSuperSearcher.java:38)
    at com.intellij.psi.impl.search.MethodSuperSearcher.processQuery(MethodSuperSearcher.java:19)
    at com.intellij.openapi.application.QueryExecutorBase.execute(QueryExecutorBase.java:77)
    at com.intellij.util.ExecutorsQuery.processResults(ExecutorsQuery.java:28)
    at com.intellij.util.AbstractQuery.doProcessResults(AbstractQuery.java:91)
    at com.intellij.util.AbstractQuery.delegateProcessResults(AbstractQuery.java:108)
    at com.intellij.util.UniqueResultsQuery.processResults(UniqueResultsQuery.java:37)
    at com.intellij.util.AbstractQuery.doProcessResults(AbstractQuery.java:91)
    at com.intellij.util.AbstractQuery.forEach(AbstractQuery.java:83)
    at com.intellij.util.AbstractQuery.findAll(AbstractQuery.java:28)
    at com.intellij.psi.impl.PsiSuperMethodImplUtil.findSuperMethodSignatures(PsiSuperMethodImplUtil.java:71)
    at com.intellij.psi.impl.PsiSuperMethodImplUtil.findSuperMethodsInternal(PsiSuperMethodImplUtil.java:55)
    at com.intellij.psi.impl.PsiSuperMethodImplUtil.findSuperMethods(PsiSuperMethodImplUtil.java:50)
    at com.intellij.psi.impl.PsiSuperMethodImplUtil.findSuperMethods(PsiSuperMethodImplUtil.java:40)
    at com.intellij.psi.impl.source.PsiMethodImpl.findSuperMethods(PsiMethodImpl.java:91)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.InheritDocTagResolver.lowestMethodsWithTag(InheritDocTagResolver.kt:124)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.InheritDocTagResolver.resolveThrowsTag(InheritDocTagResolver.kt:66)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.InheritDocTagResolver.resolveContent$analysis_java_psi(InheritDocTagResolver.kt:32)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toHtml(PsiElementToHtmlConverter.kt:120)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtmlOfSimpleElement(PsiElementToHtmlConverter.kt:85)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtml(PsiElementToHtmlConverter.kt:74)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toInheritDocHtml(PsiElementToHtmlConverter.kt:136)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toHtml(PsiElementToHtmlConverter.kt:122)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtmlOfSimpleElement(PsiElementToHtmlConverter.kt:85)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtml(PsiElementToHtmlConverter.kt:74)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toInheritDocHtml(PsiElementToHtmlConverter.kt:136)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toHtml(PsiElementToHtmlConverter.kt:122)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtmlOfSimpleElement(PsiElementToHtmlConverter.kt:85)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtml(PsiElementToHtmlConverter.kt:74)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toInheritDocHtml(PsiElementToHtmlConverter.kt:136)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.toHtml(PsiElementToHtmlConverter.kt:122)
    at org.jetbrains.dokka.analysis.java.parsers.doctag.PsiElementToHtmlConverter$WithContext.parseHtmlOfSimpleElement(PsiElementToHtmlConverter.kt:85)
....

Dokka configuration build.gradle.kts plugins { kotlin("jvm") version "1.9.23" id("org.jetbrains.dokka") version "1.9.20" }

Installation

vmishenev commented 1 month ago

Was your project compiled successfully? Otherwise, it looks like https://github.com/Kotlin/dokka/issues/2171#issuecomment-928967963