From 8e5c63d035ef44a269b8c43430f43f5c8eebfb63 Mon Sep 17 00:00:00 2001 From: Ignat Beresnev Date: Fri, 10 Nov 2023 11:46:54 +0100 Subject: Restructure the project to utilize included builds (#3174) * Refactor and simplify artifact publishing * Update Gradle to 8.4 * Refactor and simplify convention plugins and build scripts Fixes #3132 --------- Co-authored-by: Adam <897017+aSemy@users.noreply.github.com> Co-authored-by: Oleg Yukhnevich --- dokka-subprojects/plugin-base/README.md | 21 + dokka-subprojects/plugin-base/api/plugin-base.api | 1541 ++++++++++++++++++ dokka-subprojects/plugin-base/build.gradle.kts | 80 + .../kotlin/org/jetbrains/dokka/base/DokkaBase.kt | 299 ++++ .../jetbrains/dokka/base/DokkaBaseConfiguration.kt | 28 + .../base/deprecated/AnalysisApiDeprecatedError.kt | 16 + .../base/deprecated/KotlinAnalysisDeprecatedApi.kt | 77 + .../dokka/base/deprecated/ParsersDeprecatedAPI.kt | 42 + .../deprecated/ParsersFactoriesDeprecatedAPI.kt | 24 + .../TranslatorDescriptorsDeprecatedAPI.kt | 50 + .../base/deprecated/TranslatorPsiDeprecatedAPI.kt | 25 + .../base/generation/SingleModuleGeneration.kt | 131 ++ .../dokka/base/renderers/DefaultRenderer.kt | 257 +++ .../jetbrains/dokka/base/renderers/FileWriter.kt | 109 ++ .../jetbrains/dokka/base/renderers/OutputWriter.kt | 11 + .../dokka/base/renderers/PackageListService.kt | 80 + .../dokka/base/renderers/TabSortingStrategy.kt | 11 + .../dokka/base/renderers/contentTypeChecking.kt | 24 + .../dokka/base/renderers/html/HtmlContent.kt | 18 + .../dokka/base/renderers/html/HtmlRenderer.kt | 1013 ++++++++++++ .../base/renderers/html/NavigationDataProvider.kt | 134 ++ .../dokka/base/renderers/html/NavigationPage.kt | 129 ++ .../base/renderers/html/SearchbarDataInstaller.kt | 128 ++ .../jetbrains/dokka/base/renderers/html/Tags.kt | 82 + .../consumers/ImmediateResolutionTagConsumer.kt | 37 + .../html/command/consumers/PathToRootConsumer.kt | 26 + .../command/consumers/ReplaceVersionsConsumer.kt | 29 + .../html/command/consumers/ResolveLinkConsumer.kt | 34 + .../base/renderers/html/htmlFormatingUtils.kt | 67 + .../dokka/base/renderers/html/htmlPreprocessors.kt | 172 +++ .../innerTemplating/DefaultTemplateModelFactory.kt | 234 +++ .../innerTemplating/DefaultTemplateModelMerger.kt | 20 + .../html/innerTemplating/HtmlTemplater.kt | 82 + .../html/innerTemplating/TemplateModelFactory.kt | 19 + .../html/innerTemplating/TemplateModelMerger.kt | 9 + .../renderers/html/shouldRenderSourceSetBubbles.kt | 20 + .../org/jetbrains/dokka/base/renderers/pageId.kt | 31 + .../dokka/base/renderers/preprocessors.kt | 41 + .../dokka/base/resolvers/anchors/AnchorsHint.kt | 19 + .../external/DefaultExternalLocationProvider.kt | 46 + .../DefaultExternalLocationProviderFactory.kt | 28 + .../external/Dokka010ExternalLocationProvider.kt | 46 + .../resolvers/external/ExternalLocationProvider.kt | 18 + .../external/ExternalLocationProviderFactory.kt | 11 + .../ExternalLocationProviderFactoryWithCache.kt | 21 + .../javadoc/AndroidExternalLocationProvider.kt | 18 + .../javadoc/JavadocExternalLocationProvider.kt | 62 + .../JavadocExternalLocationProviderFactory.kt | 39 + .../resolvers/local/DefaultLocationProvider.kt | 82 + .../resolvers/local/DokkaBaseLocationProvider.kt | 27 + .../base/resolvers/local/DokkaLocationProvider.kt | 182 +++ .../local/DokkaLocationProviderFactory.kt | 26 + .../dokka/base/resolvers/local/LocationProvider.kt | 47 + .../resolvers/local/LocationProviderFactory.kt | 11 + .../base/resolvers/shared/ExternalDocumentation.kt | 9 + .../dokka/base/resolvers/shared/LinkFormat.kt | 10 + .../dokka/base/resolvers/shared/PackageList.kt | 83 + .../base/resolvers/shared/RecognizedLinkFormat.kt | 29 + .../jetbrains/dokka/base/resolvers/shared/utils.kt | 41 + .../dokka/base/signatures/JvmSignatureUtils.kt | 231 +++ .../base/signatures/KotlinSignatureProvider.kt | 503 ++++++ .../dokka/base/signatures/KotlinSignatureUtils.kt | 86 ++ .../dokka/base/signatures/SignatureProvider.kt | 12 + .../base/templating/AddToNavigationCommand.kt | 9 + .../jetbrains/dokka/base/templating/AddToSearch.kt | 12 + .../base/templating/AddToSourcesetDependencies.kt | 10 + .../org/jetbrains/dokka/base/templating/Command.kt | 15 + .../templating/ImmediateHtmlCommandConsumer.kt | 17 + .../dokka/base/templating/InsertTemplateExtra.kt | 16 + .../templating/PathToRootSubstitutionCommand.kt | 10 + .../templating/ProjectNameSubstitutionCommand.kt | 10 + .../base/templating/ReplaceVersionsCommand.kt | 7 + .../dokka/base/templating/ResolveLinkCommand.kt | 11 + .../dokka/base/templating/jsonMapperForPlugins.kt | 62 + .../documentables/ActualTypealiasAdder.kt | 127 ++ .../documentables/ClashingDriIdentifier.kt | 12 + .../documentables/DefaultDocumentableMerger.kt | 0 .../DeprecatedDocumentableFilterTransformer.kt | 62 + .../DocumentableReplacerTransformer.kt | 239 +++ .../DocumentableVisibilityFilterTransformer.kt | 388 +++++ .../documentables/EmptyModulesFilterTransformer.kt | 14 + .../EmptyPackagesFilterTransformer.kt | 30 + .../documentables/ExtensionExtractorTransformer.kt | 160 ++ ...nheritedEntriesDocumentableFilterTransformer.kt | 23 + .../InheritorsExtractorTransformer.kt | 91 ++ .../KotlinArrayDocumentableReplacerTransformer.kt | 68 + .../ModuleAndPackageDocumentationTransformer.kt | 47 + ...bviousFunctionsDocumentableFilterTransformer.kt | 17 + .../documentables/ReportUndocumentedTransformer.kt | 143 ++ .../documentables/SuppressTagDocumentableFilter.kt | 17 + ...ssedByConditionDocumentableFilterTransformer.kt | 146 ++ ...ByConfigurationDocumentableFilterTransformer.kt | 57 + .../dokka/base/transformers/documentables/utils.kt | 35 + .../pages/DefaultSamplesTransformer.kt | 117 ++ .../pages/annotations/SinceKotlinTransformer.kt | 186 +++ .../pages/comments/CommentsToContentConverter.kt | 22 + .../pages/comments/DocTagToContentConverter.kt | 270 ++++ .../pages/merger/FallbackPageMergerStrategy.kt | 22 + .../base/transformers/pages/merger/PageMerger.kt | 40 + .../pages/merger/PageMergerStrategy.kt | 13 + .../merger/SameMethodNamePageMergerStrategy.kt | 68 + .../merger/SourceSetMergingPageTransformer.kt | 43 + .../pages/sourcelinks/SourceLinksTransformer.kt | 140 ++ .../pages/tags/CustomTagContentProvider.kt | 63 + .../pages/tags/SinceKotlinTagContentProvider.kt | 38 + .../DefaultDocumentableToPageTranslator.kt | 34 + .../documentables/DefaultPageCreator.kt | 779 ++++++++++ .../documentables/DeprecationSectionCreator.kt | 194 +++ .../documentables/DescriptionSections.kt | 349 +++++ .../translators/documentables/DriClashAwareName.kt | 13 + .../documentables/PageContentBuilder.kt | 781 ++++++++++ .../documentables/briefFromContentNodes.kt | 62 + .../dokka/base/utils/CollectionExtensions.kt | 16 + .../dokka/base/utils/alphabeticalOrder.kt | 11 + .../org.jetbrains.dokka.plugability.DokkaPlugin | 5 + .../dokka/docs/javadoc/EnumValueOf.java.template | 12 + .../dokka/docs/javadoc/EnumValues.java.template | 8 + .../dokka/docs/kdoc/EnumEntries.kt.template | 3 + .../dokka/docs/kdoc/EnumValueOf.kt.template | 4 + .../dokka/docs/kdoc/EnumValues.kt.template | 3 + .../src/main/resources/dokka/format/gfm.properties | 6 + .../resources/dokka/format/html-as-java.properties | 6 + .../main/resources/dokka/format/html.properties | 6 + .../dokka/format/java-layout-html.properties | 6 + .../main/resources/dokka/format/jekyll.properties | 6 + .../dokka/format/kotlin-website-html.properties | 6 + .../resources/dokka/format/markdown.properties | 6 + .../resources/dokka/images/anchor-copy-button.svg | 8 + .../src/main/resources/dokka/images/arrow_down.svg | 7 + .../src/main/resources/dokka/images/burger.svg | 9 + .../src/main/resources/dokka/images/copy-icon.svg | 7 + .../dokka/images/copy-successful-icon.svg | 7 + .../resources/dokka/images/footer-go-to-link.svg | 7 + .../main/resources/dokka/images/go-to-top-icon.svg | 8 + .../src/main/resources/dokka/images/homepage.svg | 5 + .../src/main/resources/dokka/images/logo-icon.svg | 14 + .../images/nav-icons/abstract-class-kotlin.svg | 26 + .../dokka/images/nav-icons/abstract-class.svg | 20 + .../dokka/images/nav-icons/annotation-kotlin.svg | 13 + .../dokka/images/nav-icons/annotation.svg | 7 + .../dokka/images/nav-icons/class-kotlin.svg | 13 + .../resources/dokka/images/nav-icons/class.svg | 7 + .../dokka/images/nav-icons/enum-kotlin.svg | 13 + .../main/resources/dokka/images/nav-icons/enum.svg | 7 + .../dokka/images/nav-icons/exception-class.svg | 7 + .../dokka/images/nav-icons/field-value.svg | 10 + .../dokka/images/nav-icons/field-variable.svg | 10 + .../resources/dokka/images/nav-icons/function.svg | 7 + .../dokka/images/nav-icons/interface-kotlin.svg | 13 + .../resources/dokka/images/nav-icons/interface.svg | 7 + .../resources/dokka/images/nav-icons/object.svg | 13 + .../dokka/images/nav-icons/typealias-kotlin.svg | 13 + .../main/resources/dokka/images/theme-toggle.svg | 7 + .../inbound-link-resolver/dokka-default.properties | 6 + .../java-layout-html.properties | 6 + .../dokka/inbound-link-resolver/javadoc.properties | 6 + .../src/main/resources/dokka/scripts/clipboard.js | 56 + .../resources/dokka/scripts/navigation-loader.js | 95 ++ .../dokka/scripts/platform-content-handler.js | 400 +++++ .../src/main/resources/dokka/scripts/prism.js | 22 + .../scripts/symbol-parameters-wrapper_deferred.js | 64 + .../resources/dokka/styles/font-jb-sans-auto.css | 36 + .../main/resources/dokka/styles/logo-styles.css | 9 + .../src/main/resources/dokka/styles/prism.css | 217 +++ .../src/main/resources/dokka/styles/style.css | 1513 ++++++++++++++++++ .../src/main/resources/dokka/templates/base.ftl | 44 + .../resources/dokka/templates/includes/footer.ftl | 7 + .../resources/dokka/templates/includes/header.ftl | 31 + .../dokka/templates/includes/page_metadata.ftl | 6 + .../templates/includes/source_set_selector.ftl | 9 + .../AbortGracefullyOnMissingDocumentablesTest.kt | 22 + .../plugin-base/src/test/kotlin/basic/DRITest.kt | 351 +++++ .../src/test/kotlin/basic/DokkaBasicTests.kt | 46 + .../src/test/kotlin/basic/FailOnWarningTest.kt | 128 ++ .../src/test/kotlin/basic/LoggerTest.kt | 48 + .../kotlin/content/ContentInDescriptionTest.kt | 142 ++ .../src/test/kotlin/content/HighlightingTest.kt | 83 + .../annotations/ContentForAnnotationsTest.kt | 351 +++++ .../content/annotations/FileLevelJvmNameTest.kt | 115 ++ .../content/annotations/JavaDeprecatedTest.kt | 144 ++ .../content/annotations/KotlinDeprecatedTest.kt | 401 +++++ .../kotlin/content/annotations/SinceKotlinTest.kt | 350 +++++ .../content/exceptions/ContentForExceptions.kt | 439 ++++++ .../content/functions/ContentForBriefTest.kt | 388 +++++ .../content/functions/ContentForConstructors.kt | 53 + .../content/inheritors/ContentForInheritorsTest.kt | 499 ++++++ .../kotlin/content/params/ContentForParamsTest.kt | 1529 ++++++++++++++++++ .../ContentForClassWithParamsAndPropertiesTest.kt | 272 ++++ .../content/receiver/ContentForReceiverTest.kt | 61 + .../content/samples/ContentForSamplesTest.kt | 207 +++ .../content/seealso/ContentForSeeAlsoTest.kt | 866 +++++++++++ .../signatures/ConstructorsSignaturesTest.kt | 469 ++++++ .../content/signatures/ContentForSignaturesTest.kt | 515 ++++++ .../kotlin/content/typealiases/TypealiasTest.kt | 83 + .../src/test/kotlin/enums/JavaEnumsTest.kt | 75 + .../src/test/kotlin/enums/KotlinEnumsTest.kt | 471 ++++++ .../src/test/kotlin/expect/AbstractExpectTest.kt | 109 ++ .../src/test/kotlin/expect/ExpectGenerator.kt | 17 + .../src/test/kotlin/expect/ExpectTest.kt | 28 + .../src/test/kotlin/expect/ExpectUtils.kt | 32 + .../test/kotlin/expectActuals/ExpectActualsTest.kt | 179 +++ .../test/kotlin/filter/DeprecationFilterTest.kt | 264 ++++ .../test/kotlin/filter/EmptyPackagesFilterTest.kt | 70 + .../src/test/kotlin/filter/JavaFileFilterTest.kt | 40 + .../test/kotlin/filter/JavaVisibilityFilterTest.kt | 308 ++++ .../filter/KotlinArrayDocumentableReplacerTest.kt | 211 +++ .../src/test/kotlin/filter/VisibilityFilterTest.kt | 755 +++++++++ .../src/test/kotlin/issues/IssuesTest.kt | 59 + .../kotlin/linkableContent/LinkableContentTest.kt | 418 +++++ .../test/kotlin/linking/EnumValuesLinkingTest.kt | 142 ++ .../AndroidExternalLocationProviderTest.kt | 109 ++ .../DefaultExternalLocationProviderTest.kt | 78 + .../Dokka010ExternalLocationProviderTest.kt | 123 ++ .../locationProvider/DokkaLocationProviderTest.kt | 126 ++ .../JavadocExternalLocationProviderTest.kt | 85 + .../locationProvider/MultiModuleLinkingTest.kt | 74 + .../src/test/kotlin/markdown/KDocTest.kt | 51 + .../src/test/kotlin/markdown/LinkTest.kt | 240 +++ .../src/test/kotlin/markdown/ParserTest.kt | 1633 ++++++++++++++++++++ .../src/test/kotlin/model/ClassesTest.kt | 594 +++++++ .../src/test/kotlin/model/CommentTest.kt | 338 ++++ .../src/test/kotlin/model/ExtensionsTest.kt | 159 ++ .../src/test/kotlin/model/FunctionsTest.kt | 403 +++++ .../src/test/kotlin/model/InheritorsTest.kt | 428 +++++ .../plugin-base/src/test/kotlin/model/JavaTest.kt | 491 ++++++ .../kotlin/model/MultiLanguageInheritanceTest.kt | 365 +++++ .../src/test/kotlin/model/ObjectTest.kt | 43 + .../src/test/kotlin/model/PackagesTest.kt | 123 ++ .../src/test/kotlin/model/PropertyTest.kt | 277 ++++ .../JavaAnnotationsForParametersTest.kt | 181 +++ .../model/annotations/JavaAnnotationsTest.kt | 195 +++ .../KotlinAnnotationsForParametersTest.kt | 105 ++ .../kotlin/multiplatform/BasicMultiplatformTest.kt | 58 + .../src/test/kotlin/packageList/PackageListTest.kt | 69 + .../test/kotlin/pageMerger/PageNodeMergerTest.kt | 465 ++++++ .../src/test/kotlin/parsers/JavadocParserTest.kt | 618 ++++++++ .../src/test/kotlin/renderers/html/BasicTest.kt | 24 + .../test/kotlin/renderers/html/BreadcrumbsTest.kt | 88 ++ .../test/kotlin/renderers/html/CoverPageTest.kt | 51 + .../test/kotlin/renderers/html/CustomFooterTest.kt | 48 + .../test/kotlin/renderers/html/DivergentTest.kt | 316 ++++ .../kotlin/renderers/html/FooterMessageTest.kt | 31 + .../kotlin/renderers/html/FormattingUtilsTest.kt | 86 ++ .../kotlin/renderers/html/GroupWrappingTest.kt | 82 + .../src/test/kotlin/renderers/html/HeaderTest.kt | 102 ++ .../renderers/html/HtmlRenderingOnlyTestBase.kt | 68 + .../test/kotlin/renderers/html/ListStylesTest.kt | 45 + .../kotlin/renderers/html/NavigationIconTest.kt | 292 ++++ .../test/kotlin/renderers/html/NavigationTest.kt | 414 +++++ .../renderers/html/SearchbarDataInstallerTest.kt | 50 + .../renderers/html/SourceSetDependentHintTest.kt | 139 ++ .../kotlin/renderers/html/SourceSetFilterTest.kt | 68 + .../kotlin/renderers/html/TabbedContentTest.kt | 188 +++ .../test/kotlin/renderers/html/TextStylesTest.kt | 113 ++ .../test/kotlin/resourceLinks/ResourceLinksTest.kt | 301 ++++ .../kotlin/signatures/AbstractRenderingTest.kt | 65 + .../kotlin/signatures/DivergentSignatureTest.kt | 73 + .../FunctionalTypeConstructorsSignatureTest.kt | 312 ++++ .../signatures/InheritedAccessorsSignatureTest.kt | 461 ++++++ .../kotlin/signatures/ObviousTypeSkippingTest.kt | 206 +++ .../test/kotlin/signatures/RawHtmlRenderingTest.kt | 70 + .../src/test/kotlin/signatures/SignatureTest.kt | 1035 +++++++++++++ .../kotlin/signatures/VarianceSignatureTest.kt | 108 ++ .../superFields/DescriptorSuperPropertiesTest.kt | 366 +++++ .../test/kotlin/superFields/PsiSuperFieldsTest.kt | 177 +++ .../PageTransformerBuilderTest.kt | 195 +++ ...ntextModuleAndPackageDocumentationReaderTest.kt | 27 + .../transformers/CommentsToContentConverterTest.kt | 484 ++++++ ...textModuleAndPackageDocumentationReaderTest1.kt | 187 +++ ...textModuleAndPackageDocumentationReaderTest3.kt | 61 + .../test/kotlin/transformers/DivisionSwitchTest.kt | 126 ++ ...itedEntriesDocumentableFilterTransfromerTest.kt | 162 ++ ...ntentModuleAndPackageDocumentationReaderTest.kt | 100 ++ .../MergeImplicitExpectActualDeclarationsTest.kt | 386 +++++ ...ackageDocumentationTransformerFunctionalTest.kt | 137 ++ ...leAndPackageDocumentationTransformerUnitTest.kt | 260 ++++ ...sAndInheritedFunctionsDocumentableFilterTest.kt | 229 +++ .../ReportUndocumentedTransformerTest.kt | 927 +++++++++++ .../transformers/SourceLinkTransformerTest.kt | 131 ++ .../kotlin/transformers/SuppressTagFilterTest.kt | 211 +++ ...nfigurationDocumentableFilterTransformerTest.kt | 193 +++ .../test/kotlin/transformers/isExceptionTest.kt | 147 ++ .../kotlin/translators/AccessorMethodNamingTest.kt | 123 ++ .../src/test/kotlin/translators/Bug1341.kt | 48 + ...efaultDescriptorToDocumentableTranslatorTest.kt | 1107 +++++++++++++ .../DefaultPsiToDocumentableTranslatorTest.kt | 1027 ++++++++++++ .../translators/ExternalDocumentablesTest.kt | 144 ++ .../kotlin/translators/JavadocInheritDocsTest.kt | 312 ++++ .../translators/JavadocInheritedDocTagsTest.kt | 252 +++ .../test/kotlin/translators/JavadocParserTest.kt | 208 +++ .../src/test/kotlin/translators/utils.kt | 43 + .../plugin-base/src/test/kotlin/utils/HtmlUtils.kt | 20 + .../src/test/kotlin/utils/ModelUtils.kt | 43 + .../src/test/kotlin/utils/TagsAnnotations.kt | 42 + .../plugin-base/src/test/kotlin/utils/TestUtils.kt | 94 ++ .../src/test/kotlin/utils/contentUtils.kt | 355 +++++ .../src/test/resources/content/samples/samples.kt | 9 + .../test/resources/linkable/includes/include1.md | 14 + .../test/resources/linkable/includes/include11.md | 3 + .../test/resources/linkable/includes/include2.md | 7 + .../linkable/samples/jsMain/kotlin/JsClass.kt | 13 + .../linkable/samples/jsMain/resources/Samples.kt | 14 + .../linkable/samples/jvmMain/kotlin/JvmClass.kt | 13 + .../linkable/samples/jvmMain/resources/Samples.kt | 14 + .../linkable/sources/jsMain/kotlin/JsClass.kt | 7 + .../linkable/sources/jvmMain/kotlin/JvmClass.kt | 7 + .../jvmMain/kotlin/linking/source/JavaEnum.java | 5 + .../jvmMain/kotlin/linking/source/JavaLinker.java | 8 + .../jvmMain/kotlin/linking/source/KotlinEnum.kt | 9 + .../jvmMain/kotlin/linking/source/KotlinLinker.kt | 12 + .../resources/locationProvider/jdk8-package-list | 217 +++ .../locationProvider/multi-module-package-list | 8 + .../resources/locationProvider/old-package-list | 9 + .../resources/locationProvider/stdlib-package-list | 67 + .../commonMain/kotlin/Clock.kt | 19 + .../commonMain/kotlin/House.kt | 28 + .../basicMultiplatformTest/jsMain/kotlin/Clock.kt | 32 + .../jvmAndJsSecondCommonMain/kotlin/Greeter.kt | 14 + .../jvmMain/kotlin/example/Clock.kt | 43 + .../jvmMain/kotlin/example/ClockDays.kt | 19 + .../jvmMain/kotlin/example/HtmlTest.kt | 24 + .../jvmMain/kotlin/example/ParticularClock.kt | 36 + 322 files changed, 46805 insertions(+) create mode 100644 dokka-subprojects/plugin-base/README.md create mode 100644 dokka-subprojects/plugin-base/api/plugin-base.api create mode 100644 dokka-subprojects/plugin-base/build.gradle.kts create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/DokkaBase.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/DokkaBaseConfiguration.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/deprecated/AnalysisApiDeprecatedError.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/deprecated/KotlinAnalysisDeprecatedApi.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/deprecated/ParsersDeprecatedAPI.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/deprecated/ParsersFactoriesDeprecatedAPI.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/deprecated/TranslatorDescriptorsDeprecatedAPI.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/deprecated/TranslatorPsiDeprecatedAPI.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/generation/SingleModuleGeneration.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/DefaultRenderer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/FileWriter.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/OutputWriter.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/PackageListService.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/TabSortingStrategy.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/contentTypeChecking.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/HtmlContent.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/HtmlRenderer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/NavigationDataProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/NavigationPage.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/SearchbarDataInstaller.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/Tags.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/command/consumers/ImmediateResolutionTagConsumer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/command/consumers/PathToRootConsumer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/command/consumers/ReplaceVersionsConsumer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/command/consumers/ResolveLinkConsumer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/htmlFormatingUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/htmlPreprocessors.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/innerTemplating/DefaultTemplateModelFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/innerTemplating/DefaultTemplateModelMerger.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/innerTemplating/HtmlTemplater.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/innerTemplating/TemplateModelFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/innerTemplating/TemplateModelMerger.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/html/shouldRenderSourceSetBubbles.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/pageId.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/renderers/preprocessors.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/anchors/AnchorsHint.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/DefaultExternalLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/DefaultExternalLocationProviderFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/Dokka010ExternalLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/ExternalLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/ExternalLocationProviderFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/ExternalLocationProviderFactoryWithCache.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/javadoc/AndroidExternalLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/javadoc/JavadocExternalLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/external/javadoc/JavadocExternalLocationProviderFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/local/DefaultLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/local/DokkaBaseLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/local/DokkaLocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/local/DokkaLocationProviderFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/local/LocationProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/local/LocationProviderFactory.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/shared/ExternalDocumentation.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/shared/LinkFormat.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/shared/PackageList.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/shared/RecognizedLinkFormat.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/shared/utils.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/signatures/JvmSignatureUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/signatures/KotlinSignatureProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/signatures/KotlinSignatureUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/signatures/SignatureProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/AddToNavigationCommand.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/AddToSearch.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/AddToSourcesetDependencies.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/Command.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/ImmediateHtmlCommandConsumer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/InsertTemplateExtra.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/PathToRootSubstitutionCommand.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/ProjectNameSubstitutionCommand.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/ReplaceVersionsCommand.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/ResolveLinkCommand.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/templating/jsonMapperForPlugins.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/ActualTypealiasAdder.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/ClashingDriIdentifier.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/DefaultDocumentableMerger.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/DeprecatedDocumentableFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/DocumentableReplacerTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/DocumentableVisibilityFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/EmptyModulesFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/EmptyPackagesFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/ExtensionExtractorTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/InheritedEntriesDocumentableFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/InheritorsExtractorTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/KotlinArrayDocumentableReplacerTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/ModuleAndPackageDocumentationTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/ObviousFunctionsDocumentableFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/ReportUndocumentedTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/SuppressTagDocumentableFilter.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/SuppressedByConditionDocumentableFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/SuppressedByConfigurationDocumentableFilterTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/documentables/utils.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/DefaultSamplesTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/annotations/SinceKotlinTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/comments/CommentsToContentConverter.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/comments/DocTagToContentConverter.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/merger/FallbackPageMergerStrategy.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/merger/PageMerger.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/merger/PageMergerStrategy.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/merger/SameMethodNamePageMergerStrategy.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/merger/SourceSetMergingPageTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/sourcelinks/SourceLinksTransformer.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/tags/CustomTagContentProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/transformers/pages/tags/SinceKotlinTagContentProvider.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/DefaultDocumentableToPageTranslator.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/DefaultPageCreator.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/DeprecationSectionCreator.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/DescriptionSections.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/DriClashAwareName.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/PageContentBuilder.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/translators/documentables/briefFromContentNodes.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/utils/CollectionExtensions.kt create mode 100644 dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/utils/alphabeticalOrder.kt create mode 100644 dokka-subprojects/plugin-base/src/main/resources/META-INF/services/org.jetbrains.dokka.plugability.DokkaPlugin create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/docs/javadoc/EnumValueOf.java.template create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/docs/javadoc/EnumValues.java.template create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/docs/kdoc/EnumEntries.kt.template create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/docs/kdoc/EnumValueOf.kt.template create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/docs/kdoc/EnumValues.kt.template create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/gfm.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/html-as-java.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/html.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/java-layout-html.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/jekyll.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/kotlin-website-html.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/format/markdown.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/anchor-copy-button.svg create mode 100755 dokka-subprojects/plugin-base/src/main/resources/dokka/images/arrow_down.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/burger.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/copy-icon.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/copy-successful-icon.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/footer-go-to-link.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/go-to-top-icon.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/homepage.svg create mode 100755 dokka-subprojects/plugin-base/src/main/resources/dokka/images/logo-icon.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/abstract-class-kotlin.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/abstract-class.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/annotation-kotlin.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/annotation.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/class-kotlin.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/class.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/enum-kotlin.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/enum.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/exception-class.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/field-value.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/field-variable.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/function.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/interface-kotlin.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/interface.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/object.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/nav-icons/typealias-kotlin.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/images/theme-toggle.svg create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/inbound-link-resolver/dokka-default.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/inbound-link-resolver/java-layout-html.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/inbound-link-resolver/javadoc.properties create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/scripts/clipboard.js create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/scripts/navigation-loader.js create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/scripts/platform-content-handler.js create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/scripts/prism.js create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/scripts/symbol-parameters-wrapper_deferred.js create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/styles/font-jb-sans-auto.css create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/styles/logo-styles.css create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/styles/prism.css create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/styles/style.css create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/templates/base.ftl create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/templates/includes/footer.ftl create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/templates/includes/header.ftl create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/templates/includes/page_metadata.ftl create mode 100644 dokka-subprojects/plugin-base/src/main/resources/dokka/templates/includes/source_set_selector.ftl create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/basic/AbortGracefullyOnMissingDocumentablesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/basic/DRITest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/basic/DokkaBasicTests.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/basic/FailOnWarningTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/basic/LoggerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/ContentInDescriptionTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/HighlightingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/annotations/ContentForAnnotationsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/annotations/FileLevelJvmNameTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/annotations/JavaDeprecatedTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/annotations/KotlinDeprecatedTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/annotations/SinceKotlinTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/exceptions/ContentForExceptions.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/functions/ContentForBriefTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/functions/ContentForConstructors.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/inheritors/ContentForInheritorsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/params/ContentForParamsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/properties/ContentForClassWithParamsAndPropertiesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/receiver/ContentForReceiverTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/samples/ContentForSamplesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/seealso/ContentForSeeAlsoTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/signatures/ConstructorsSignaturesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/signatures/ContentForSignaturesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/content/typealiases/TypealiasTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/enums/JavaEnumsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/enums/KotlinEnumsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/expect/AbstractExpectTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/expect/ExpectGenerator.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/expect/ExpectTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/expect/ExpectUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/expectActuals/ExpectActualsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/filter/DeprecationFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/filter/EmptyPackagesFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/filter/JavaFileFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/filter/JavaVisibilityFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/filter/KotlinArrayDocumentableReplacerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/filter/VisibilityFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/issues/IssuesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/linkableContent/LinkableContentTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/linking/EnumValuesLinkingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/locationProvider/AndroidExternalLocationProviderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/locationProvider/DefaultExternalLocationProviderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/locationProvider/Dokka010ExternalLocationProviderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/locationProvider/DokkaLocationProviderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/locationProvider/JavadocExternalLocationProviderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/locationProvider/MultiModuleLinkingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/markdown/KDocTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/markdown/LinkTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/markdown/ParserTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/ClassesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/CommentTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/ExtensionsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/FunctionsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/InheritorsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/JavaTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/MultiLanguageInheritanceTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/ObjectTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/PackagesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/PropertyTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/annotations/JavaAnnotationsForParametersTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/annotations/JavaAnnotationsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/model/annotations/KotlinAnnotationsForParametersTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/multiplatform/BasicMultiplatformTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/packageList/PackageListTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/pageMerger/PageNodeMergerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/parsers/JavadocParserTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/BasicTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/BreadcrumbsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/CoverPageTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/CustomFooterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/DivergentTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/FooterMessageTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/FormattingUtilsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/GroupWrappingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/HeaderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/HtmlRenderingOnlyTestBase.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/ListStylesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/NavigationIconTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/NavigationTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/SearchbarDataInstallerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/SourceSetDependentHintTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/SourceSetFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/TabbedContentTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/renderers/html/TextStylesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/resourceLinks/ResourceLinksTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/AbstractRenderingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/DivergentSignatureTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/FunctionalTypeConstructorsSignatureTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/InheritedAccessorsSignatureTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/ObviousTypeSkippingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/RawHtmlRenderingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/SignatureTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/signatures/VarianceSignatureTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/superFields/DescriptorSuperPropertiesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/superFields/PsiSuperFieldsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformerBuilders/PageTransformerBuilderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/AbstractContextModuleAndPackageDocumentationReaderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/CommentsToContentConverterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/ContextModuleAndPackageDocumentationReaderTest1.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/ContextModuleAndPackageDocumentationReaderTest3.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/DivisionSwitchTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/InheritedEntriesDocumentableFilterTransfromerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/InvalidContentModuleAndPackageDocumentationReaderTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/MergeImplicitExpectActualDeclarationsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/ModuleAndPackageDocumentationTransformerFunctionalTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/ModuleAndPackageDocumentationTransformerUnitTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/ObviousAndInheritedFunctionsDocumentableFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/ReportUndocumentedTransformerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/SourceLinkTransformerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/SuppressTagFilterTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/SuppressedByConfigurationDocumentableFilterTransformerTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/transformers/isExceptionTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/AccessorMethodNamingTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/Bug1341.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/DefaultDescriptorToDocumentableTranslatorTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/DefaultPsiToDocumentableTranslatorTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/ExternalDocumentablesTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/JavadocInheritDocsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/JavadocInheritedDocTagsTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/JavadocParserTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/translators/utils.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/utils/HtmlUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/utils/ModelUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/utils/TagsAnnotations.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/utils/TestUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/test/kotlin/utils/contentUtils.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/content/samples/samples.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/includes/include1.md create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/includes/include11.md create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/includes/include2.md create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/samples/jsMain/kotlin/JsClass.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/samples/jsMain/resources/Samples.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/samples/jvmMain/kotlin/JvmClass.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/samples/jvmMain/resources/Samples.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/sources/jsMain/kotlin/JsClass.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linkable/sources/jvmMain/kotlin/JvmClass.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linking/jvmMain/kotlin/linking/source/JavaEnum.java create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linking/jvmMain/kotlin/linking/source/JavaLinker.java create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linking/jvmMain/kotlin/linking/source/KotlinEnum.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/linking/jvmMain/kotlin/linking/source/KotlinLinker.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/locationProvider/jdk8-package-list create mode 100644 dokka-subprojects/plugin-base/src/test/resources/locationProvider/multi-module-package-list create mode 100644 dokka-subprojects/plugin-base/src/test/resources/locationProvider/old-package-list create mode 100644 dokka-subprojects/plugin-base/src/test/resources/locationProvider/stdlib-package-list create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/Clock.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/commonMain/kotlin/House.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jsMain/kotlin/Clock.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmAndJsSecondCommonMain/kotlin/Greeter.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/Clock.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ClockDays.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/HtmlTest.kt create mode 100644 dokka-subprojects/plugin-base/src/test/resources/multiplatform/basicMultiplatformTest/jvmMain/kotlin/example/ParticularClock.kt (limited to 'dokka-subprojects/plugin-base') diff --git a/dokka-subprojects/plugin-base/README.md b/dokka-subprojects/plugin-base/README.md new file mode 100644 index 00000000..e4cba717 --- /dev/null +++ b/dokka-subprojects/plugin-base/README.md @@ -0,0 +1,21 @@ +# Base plugin + +The Base plugin comes with a number of basic extensions and features that are likely to be needed by any output format and +some plugins in general. + +Including, but not limited to: + +* Markdown and KDoc parsing. +* Kotlin signature generation. +* Transformers that suppress empty modules/packages, unwanted visibility modifiers, obvious functions + (hashCode/equals/etc), and so on. +* Declaration link resolution (i.e linking to a class in a KDoc). +* Support for external documentation links (i.e links to Java's Javadocs website or Kotlin's stdlib). +* Declaration source link generation for navigation to source code (a.k.a `source` button). +* Multiplatform support. +* Output file writers. + +The Base plugin is not intended to be used directly by those who want to generate documentation - it is a building block +for other plugins and formats. + +It is in the heart of all documentation formats that come with Dokka. diff --git a/dokka-subprojects/plugin-base/api/plugin-base.api b/dokka-subprojects/plugin-base/api/plugin-base.api new file mode 100644 index 00000000..13f877e3 --- /dev/null +++ b/dokka-subprojects/plugin-base/api/plugin-base.api @@ -0,0 +1,1541 @@ +public final class org/jetbrains/dokka/analysis/AnalysisContext : java/io/Closeable { + public fun (Ljava/lang/Object;Ljava/lang/Object;Ljava/lang/Object;)V + public fun close ()V + public final fun component1 ()Ljava/lang/Object; + public final fun component2 ()Ljava/lang/Object; + public final fun getEnvironment ()Ljava/lang/Object; + public final fun getFacade ()Ljava/lang/Object; +} + +public final class org/jetbrains/dokka/analysis/DokkaAnalysisConfiguration { + public fun ()V + public fun (Z)V + public synthetic fun (ZILkotlin/jvm/internal/DefaultConstructorMarker;)V + public final fun getIgnoreCommonBuiltIns ()Z +} + +public abstract class org/jetbrains/dokka/analysis/KotlinAnalysis : java/io/Closeable { + public fun ()V + public fun (Lorg/jetbrains/dokka/analysis/KotlinAnalysis;)V + public synthetic fun (Lorg/jetbrains/dokka/analysis/KotlinAnalysis;ILkotlin/jvm/internal/DefaultConstructorMarker;)V + protected abstract fun find (Lorg/jetbrains/dokka/DokkaSourceSetID;)Lorg/jetbrains/dokka/analysis/AnalysisContext; + public final fun get (Lorg/jetbrains/dokka/DokkaConfiguration$DokkaSourceSet;)Lorg/jetbrains/dokka/analysis/AnalysisContext; + public final fun get (Lorg/jetbrains/dokka/DokkaSourceSetID;)Lorg/jetbrains/dokka/analysis/AnalysisContext; +} + +public final class org/jetbrains/dokka/analysis/KotlinAnalysisDeprecatedApiKt { + public static final fun KotlinAnalysis (Ljava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/analysis/DokkaAnalysisConfiguration;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; + public static final fun KotlinAnalysis (Lorg/jetbrains/dokka/plugability/DokkaContext;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; + public static synthetic fun KotlinAnalysis$default (Ljava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/analysis/DokkaAnalysisConfiguration;ILjava/lang/Object;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; + public static final fun ProjectKotlinAnalysis (Ljava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/analysis/DokkaAnalysisConfiguration;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; + public static synthetic fun ProjectKotlinAnalysis$default (Ljava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/analysis/DokkaAnalysisConfiguration;ILjava/lang/Object;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; + public static final fun SamplesKotlinAnalysis (Ljava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/analysis/KotlinAnalysis;Lorg/jetbrains/dokka/analysis/DokkaAnalysisConfiguration;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; + public static synthetic fun SamplesKotlinAnalysis$default (Ljava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/analysis/KotlinAnalysis;Lorg/jetbrains/dokka/analysis/DokkaAnalysisConfiguration;ILjava/lang/Object;)Lorg/jetbrains/dokka/analysis/KotlinAnalysis; +} + +public final class org/jetbrains/dokka/base/DokkaBase : org/jetbrains/dokka/plugability/DokkaPlugin { + public fun ()V + public final fun getActualTypealiasAdder ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getAssetsInstaller ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getBaseSearchbarDataInstaller ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getCommentsToContentConverter ()Lorg/jetbrains/dokka/plugability/ExtensionPoint; + public final fun getCustomResourceInstaller ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getCustomTagContentProvider ()Lorg/jetbrains/dokka/plugability/ExtensionPoint; + public final fun getDefaultExternalClasslikesTranslator ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDefaultExternalDocumentablesProvider ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDefaultKotlinAnalysis ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDefaultSamplesTransformer ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDeprecatedDocumentableFilter ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDescriptorToDocumentableTranslator ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDocTagToContentConverter ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDocumentableMerger ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDocumentableToPageTranslator ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDocumentableVisibilityFilter ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getDokkaLocationProvider ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getEmptyModulesFilter ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getEmptyPackagesFilter ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getExtensionsExtractor ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getExternalClasslikesTranslator ()Lorg/jetbrains/dokka/plugability/ExtensionPoint; + public final fun getExternalDocumentablesProvider ()Lorg/jetbrains/dokka/plugability/ExtensionPoint; + public final fun getExternalLocationProviderFactory ()Lorg/jetbrains/dokka/plugability/ExtensionPoint; + public final fun getFallbackMerger ()Lorg/jetbrains/dokka/plugability/Extension; + public final fun getFileWriter ()Lor