aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.idea/libraries/Gradle__aopalliance_aopalliance_1_0.xml9
-rw-r--r--.idea/libraries/Gradle__com_google_guava_guava_16_0_1.xml9
-rw-r--r--.idea/libraries/Gradle__com_google_inject_guice_4_0.xml9
-rw-r--r--.idea/libraries/Gradle__javax_inject_javax_inject_1.xml9
-rw-r--r--.idea/libraries/Gradle__org_fusesource_jansi_jansi_1_11.xml9
-rw-r--r--.idea/libraries/Gradle__org_hamcrest_hamcrest_core_1_3.xml6
-rw-r--r--core/src/main/kotlin/Analysis/AnalysisEnvironment.kt18
-rw-r--r--core/src/main/kotlin/Formats/FormatDescriptor.kt2
-rw-r--r--core/src/main/kotlin/Formats/FormatService.kt2
-rw-r--r--core/src/main/kotlin/Formats/HtmlFormatService.kt8
-rw-r--r--core/src/main/kotlin/Formats/HtmlTemplateService.kt4
-rw-r--r--core/src/main/kotlin/Formats/KotlinWebsiteFormatService.kt8
-rw-r--r--core/src/main/kotlin/Formats/MarkdownFormatService.kt22
-rw-r--r--core/src/main/kotlin/Formats/OutlineService.kt8
-rw-r--r--core/src/main/kotlin/Formats/StructuredFormatService.kt496
-rw-r--r--core/src/main/kotlin/Generation/ConsoleGenerator.kt12
-rw-r--r--core/src/main/kotlin/Generation/FileGenerator.kt2
-rw-r--r--core/src/main/kotlin/Generation/Generator.kt2
-rw-r--r--core/src/main/kotlin/Java/JavaPsiDocumentationBuilder.kt83
-rw-r--r--core/src/main/kotlin/Kotlin/ContentBuilder.kt6
-rw-r--r--core/src/main/kotlin/Kotlin/DeclarationLinkResolver.kt32
-rw-r--r--core/src/main/kotlin/Kotlin/DescriptorDocumentationParser.kt4
-rw-r--r--core/src/main/kotlin/Kotlin/DocumentationBuilder.kt295
-rw-r--r--core/src/main/kotlin/Kotlin/KotlinAsJavaDocumentationBuilder.kt3
-rw-r--r--core/src/main/kotlin/Kotlin/KotlinLanguageService.kt140
-rw-r--r--core/src/main/kotlin/Languages/JavaLanguageService.kt71
-rw-r--r--core/src/main/kotlin/Locations/FoldersLocationService.kt5
-rw-r--r--core/src/main/kotlin/Locations/LocationService.kt10
-rw-r--r--core/src/main/kotlin/Locations/SingleFolderLocationService.kt5
-rw-r--r--core/src/main/kotlin/Markdown/MarkdownProcessor.kt2
-rw-r--r--core/src/main/kotlin/Model/Content.kt76
-rw-r--r--core/src/main/kotlin/Model/DocumentationNode.kt211
-rw-r--r--core/src/main/kotlin/Model/DocumentationReference.kt42
-rw-r--r--core/src/main/kotlin/Model/PackageDocs.kt6
-rw-r--r--core/src/main/kotlin/Model/SourceLinks.kt10
-rw-r--r--core/src/main/kotlin/Utilities/Html.kt2
-rw-r--r--core/src/main/kotlin/Utilities/ServiceLocator.kt6
-rw-r--r--core/src/main/kotlin/ant/dokka.kt40
-rw-r--r--core/src/main/kotlin/javadoc/docbase.kt170
-rw-r--r--core/src/main/kotlin/javadoc/source-position.kt3
-rw-r--r--core/src/main/kotlin/javadoc/tags.kt4
-rw-r--r--core/src/main/kotlin/main.kt20
-rw-r--r--core/src/test/kotlin/format/MarkdownFormatTest.kt58
-rw-r--r--core/src/test/kotlin/model/ClassTest.kt70
-rw-r--r--core/src/test/kotlin/model/FunctionTest.kt46
-rw-r--r--core/src/test/kotlin/model/JavaTest.kt92
-rw-r--r--core/src/test/kotlin/model/KotlinAsJavaTest.kt8
-rw-r--r--core/src/test/kotlin/model/LinkTest.kt8
-rw-r--r--core/src/test/kotlin/model/PackageTest.kt14
-rw-r--r--core/src/test/kotlin/model/PropertyTest.kt30
-rw-r--r--core/testdata/format/annotationClass.package.md11
-rw-r--r--core/testdata/format/arrayAverage.kt8
-rw-r--r--core/testdata/format/arrayAverage.md25
-rw-r--r--core/testdata/format/deprecated.class.html11
-rw-r--r--core/testdata/format/deprecated.package.html2
-rw-r--r--core/testdata/format/exceptionClass.kt1
-rw-r--r--core/testdata/format/exceptionClass.md14
-rw-r--r--core/testdata/format/exceptionClass.package.md11
-rw-r--r--core/testdata/format/inapplicableExtensionFunctions.kt11
-rw-r--r--core/testdata/format/inapplicableExtensionFunctions.md20
-rw-r--r--core/testdata/format/inheritedCompanionObjectProperties.kt18
-rw-r--r--core/testdata/format/inheritedCompanionObjectProperties.md38
-rw-r--r--core/testdata/format/jdkLinks.kt5
-rw-r--r--core/testdata/format/jdkLinks.md20
-rw-r--r--core/testdata/format/multipleTypeParameterConstraints.kt2
-rw-r--r--core/testdata/format/multipleTypeParameterConstraints.md8
-rw-r--r--core/testdata/format/overloads.html2
-rw-r--r--core/testdata/format/paramTag.md1
-rw-r--r--core/testdata/format/receiverParameterTypeBound.kt5
-rw-r--r--core/testdata/format/receiverParameterTypeBound.md20
-rw-r--r--core/testdata/format/shadowedExtensionFunctions.kt18
-rw-r--r--core/testdata/format/shadowedExtensionFunctions.md22
-rw-r--r--core/testdata/format/throwsTag.md1
-rw-r--r--dokka-gradle-plugin/src/main/kotlin/main.kt8
-rw-r--r--lib/kotlin-for-upsource.jarbin15659303 -> 15533326 bytes
-rw-r--r--maven-plugin/src/main/kotlin/DokkaMojo.kt4
-rw-r--r--maven-plugin/src/main/kotlin/MavenDokkaLogger.kt2
77 files changed, 1494 insertions, 1001 deletions
diff --git a/.idea/libraries/Gradle__aopalliance_aopalliance_1_0.xml b/.idea/libraries/Gradle__aopalliance_aopalliance_1_0.xml
index 366ab86e..4abfa0ea 100644
--- a/.idea/libraries/Gradle__aopalliance_aopalliance_1_0.xml
+++ b/.idea/libraries/Gradle__aopalliance_aopalliance_1_0.xml
@@ -1,7 +1,12 @@
<component name="libraryTable">
<library name="Gradle: aopalliance:aopalliance:1.0">
- <CLASSES />
+ <CLASSES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/aopalliance/aopalliance/1.0/235ba8b489512805ac13a8f9ea77a1ca5ebe3e8/aopalliance-1.0.jar!/" />
+ <root url="jar://$MAVEN_REPOSITORY$/aopalliance/aopalliance/1.0/aopalliance-1.0.jar!/" />
+ </CLASSES>
<JAVADOC />
- <SOURCES />
+ <SOURCES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/aopalliance/aopalliance/1.0/4a4b6d692e17846a9f3da036438a7ac491d3c814/aopalliance-1.0-sources.jar!/" />
+ </SOURCES>
</library>
</component> \ No newline at end of file
diff --git a/.idea/libraries/Gradle__com_google_guava_guava_16_0_1.xml b/.idea/libraries/Gradle__com_google_guava_guava_16_0_1.xml
index 4715a203..05aa1ed6 100644
--- a/.idea/libraries/Gradle__com_google_guava_guava_16_0_1.xml
+++ b/.idea/libraries/Gradle__com_google_guava_guava_16_0_1.xml
@@ -1,7 +1,12 @@
<component name="libraryTable">
<library name="Gradle: com.google.guava:guava:16.0.1">
- <CLASSES />
+ <CLASSES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.google.guava/guava/16.0.1/5fa98cd1a63c99a44dd8d3b77e4762b066a5d0c5/guava-16.0.1.jar!/" />
+ <root url="jar://$MAVEN_REPOSITORY$/com/google/guava/guava/16.0.1/guava-16.0.1.jar!/" />
+ </CLASSES>
<JAVADOC />
- <SOURCES />
+ <SOURCES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.google.guava/guava/16.0.1/2477d012cd5379f9696e0d9d3ccc62ad13a09ca4/guava-16.0.1-sources.jar!/" />
+ </SOURCES>
</library>
</component> \ No newline at end of file
diff --git a/.idea/libraries/Gradle__com_google_inject_guice_4_0.xml b/.idea/libraries/Gradle__com_google_inject_guice_4_0.xml
index 5e477a0f..d28cc3ab 100644
--- a/.idea/libraries/Gradle__com_google_inject_guice_4_0.xml
+++ b/.idea/libraries/Gradle__com_google_inject_guice_4_0.xml
@@ -1,7 +1,12 @@
<component name="libraryTable">
<library name="Gradle: com.google.inject:guice:4.0">
- <CLASSES />
+ <CLASSES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.google.inject/guice/4.0/f990a43d3725781b6db7cd0acf0a8b62dfd1649/guice-4.0.jar!/" />
+ <root url="jar://$MAVEN_REPOSITORY$/com/google/inject/guice/4.0/guice-4.0.jar!/" />
+ </CLASSES>
<JAVADOC />
- <SOURCES />
+ <SOURCES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/com.google.inject/guice/4.0/961359f8352b791c6443a207c847e25d6d3ca7cd/guice-4.0-sources.jar!/" />
+ </SOURCES>
</library>
</component> \ No newline at end of file
diff --git a/.idea/libraries/Gradle__javax_inject_javax_inject_1.xml b/.idea/libraries/Gradle__javax_inject_javax_inject_1.xml
index 567e87fe..e45b86eb 100644
--- a/.idea/libraries/Gradle__javax_inject_javax_inject_1.xml
+++ b/.idea/libraries/Gradle__javax_inject_javax_inject_1.xml
@@ -1,7 +1,12 @@
<component name="libraryTable">
<library name="Gradle: javax.inject:javax.inject:1">
- <CLASSES />
+ <CLASSES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/javax.inject/javax.inject/1/6975da39a7040257bd51d21a231b76c915872d38/javax.inject-1.jar!/" />
+ <root url="jar://$MAVEN_REPOSITORY$/javax/inject/javax.inject/1/javax.inject-1.jar!/" />
+ </CLASSES>
<JAVADOC />
- <SOURCES />
+ <SOURCES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/javax.inject/javax.inject/1/a00123f261762a7c5e0ec916a2c7c8298d29c400/javax.inject-1-sources.jar!/" />
+ </SOURCES>
</library>
</component> \ No newline at end of file
diff --git a/.idea/libraries/Gradle__org_fusesource_jansi_jansi_1_11.xml b/.idea/libraries/Gradle__org_fusesource_jansi_jansi_1_11.xml
index de07faa2..c84716ad 100644
--- a/.idea/libraries/Gradle__org_fusesource_jansi_jansi_1_11.xml
+++ b/.idea/libraries/Gradle__org_fusesource_jansi_jansi_1_11.xml
@@ -1,12 +1,7 @@
<component name="libraryTable">
<library name="Gradle: org.fusesource.jansi:jansi:1.11">
- <CLASSES>
- <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/org.fusesource.jansi/jansi/1.11/655c643309c2f45a56a747fda70e3fadf57e9f11/jansi-1.11.jar!/" />
- <root url="jar://$MAVEN_REPOSITORY$/org/fusesource/jansi/jansi/1.11/jansi-1.11.jar!/" />
- </CLASSES>
+ <CLASSES />
<JAVADOC />
- <SOURCES>
- <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/org.fusesource.jansi/jansi/1.11/2f0e4b53b6b0eec426dad7118bf54b3deb58000b/jansi-1.11-sources.jar!/" />
- </SOURCES>
+ <SOURCES />
</library>
</component> \ No newline at end of file
diff --git a/.idea/libraries/Gradle__org_hamcrest_hamcrest_core_1_3.xml b/.idea/libraries/Gradle__org_hamcrest_hamcrest_core_1_3.xml
index b9f5b319..8262f729 100644
--- a/.idea/libraries/Gradle__org_hamcrest_hamcrest_core_1_3.xml
+++ b/.idea/libraries/Gradle__org_hamcrest_hamcrest_core_1_3.xml
@@ -1,9 +1,11 @@
<component name="libraryTable">
<library name="Gradle: org.hamcrest:hamcrest-core:1.3">
<CLASSES>
- <root url="jar://$MAVEN_REPOSITORY$/org/hamcrest/hamcrest-core/1.3/hamcrest-core-1.3.jar!/" />
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/org.hamcrest/hamcrest-core/1.3/42a25dc3219429f0e5d060061f71acb49bf010a0/hamcrest-core-1.3.jar!/" />
</CLASSES>
<JAVADOC />
- <SOURCES />
+ <SOURCES>
+ <root url="jar://$USER_HOME$/.gradle/caches/modules-2/files-2.1/org.hamcrest/hamcrest-core/1.3/1dc37250fbc78e23a65a67fbbaf71d2e9cbc3c0b/hamcrest-core-1.3-sources.jar!/" />
+ </SOURCES>
</library>
</component> \ No newline at end of file
diff --git a/core/src/main/kotlin/Analysis/AnalysisEnvironment.kt b/core/src/main/kotlin/Analysis/AnalysisEnvironment.kt
index a5e35a0e..b0c39ee5 100644
--- a/core/src/main/kotlin/Analysis/AnalysisEnvironment.kt
+++ b/core/src/main/kotlin/Analysis/AnalysisEnvironment.kt
@@ -57,7 +57,7 @@ import java.io.File
* $messageCollector: required by compiler infrastructure and will receive all compiler messages
* $body: optional and can be used to configure environment without creating local variable
*/
-public class AnalysisEnvironment(val messageCollector: MessageCollector) : Disposable {
+class AnalysisEnvironment(val messageCollector: MessageCollector) : Disposable {
val configuration = CompilerConfiguration();
init {
@@ -119,14 +119,14 @@ public class AnalysisEnvironment(val messageCollector: MessageCollector) : Dispo
/**
* Classpath for this environment.
*/
- public val classpath: List<File>
+ val classpath: List<File>
get() = configuration.jvmClasspathRoots
/**
* Adds list of paths to classpath.
* $paths: collection of files to add
*/
- public fun addClasspath(paths: List<File>) {
+ fun addClasspath(paths: List<File>) {
configuration.addJvmClasspathRoots(paths)
}
@@ -134,14 +134,14 @@ public class AnalysisEnvironment(val messageCollector: MessageCollector) : Dispo
* Adds path to classpath.
* $path: path to add
*/
- public fun addClasspath(path: File) {
+ fun addClasspath(path: File) {
configuration.addJvmClasspathRoot(path)
}
/**
* List of source roots for this environment.
*/
- public val sources: List<String>
+ val sources: List<String>
get() = configuration.get(CommonConfigurationKeys.CONTENT_ROOTS)
?.filterIsInstance<KotlinSourceRoot>()
?.map { it.path } ?: emptyList()
@@ -150,25 +150,25 @@ public class AnalysisEnvironment(val messageCollector: MessageCollector) : Dispo
* Adds list of paths to source roots.
* $list: collection of files to add
*/
- public fun addSources(list: List<String>) {
+ fun addSources(list: List<String>) {
list.forEach {
configuration.add(CommonConfigurationKeys.CONTENT_ROOTS, contentRootFromPath(it))
}
}
- public fun addRoots(list: List<ContentRoot>) {
+ fun addRoots(list: List<ContentRoot>) {
configuration.addAll(CommonConfigurationKeys.CONTENT_ROOTS, list)
}
/**
* Disposes the environment and frees all associated resources.
*/
- public override fun dispose() {
+ override fun dispose() {
Disposer.dispose(this)
}
}
-public fun contentRootFromPath(path: String): ContentRoot {
+fun contentRootFromPath(path: String): ContentRoot {
val file = File(path)
return if (file.extension == "java") JavaSourceRoot(file, null) else KotlinSourceRoot(path)
}
diff --git a/core/src/main/kotlin/Formats/FormatDescriptor.kt b/core/src/main/kotlin/Formats/FormatDescriptor.kt
index 0c7ca794..e384f223 100644
--- a/core/src/main/kotlin/Formats/FormatDescriptor.kt
+++ b/core/src/main/kotlin/Formats/FormatDescriptor.kt
@@ -3,7 +3,7 @@ package org.jetbrains.dokka.Formats
import org.jetbrains.dokka.*
import kotlin.reflect.KClass
-public interface FormatDescriptor {
+interface FormatDescriptor {
val formatServiceClass: KClass<out FormatService>?
val outlineServiceClass: KClass<out OutlineFormatService>?
val generatorServiceClass: KClass<out Generator>
diff --git a/core/src/main/kotlin/Formats/FormatService.kt b/core/src/main/kotlin/Formats/FormatService.kt
index 73e54956..aa4e925c 100644
--- a/core/src/main/kotlin/Formats/FormatService.kt
+++ b/core/src/main/kotlin/Formats/FormatService.kt
@@ -7,7 +7,7 @@ package org.jetbrains.dokka
* * [HtmlFormatService] – outputs documentation to HTML format
* * [MarkdownFormatService] – outputs documentation in Markdown format
*/
-public interface FormatService {
+interface FormatService {
/** Returns extension for output files */
val extension: String
diff --git a/core/src/main/kotlin/Formats/HtmlFormatService.kt b/core/src/main/kotlin/Formats/HtmlFormatService.kt
index d513e41f..f78439ba 100644
--- a/core/src/main/kotlin/Formats/HtmlFormatService.kt
+++ b/core/src/main/kotlin/Formats/HtmlFormatService.kt
@@ -6,11 +6,11 @@ import java.io.File
import java.nio.file.Path
import java.nio.file.Paths
-public open class HtmlFormatService @Inject constructor(@Named("folders") locationService: LocationService,
- signatureGenerator: LanguageService,
- val templateService: HtmlTemplateService)
+open class HtmlFormatService @Inject constructor(@Named("folders") locationService: LocationService,
+ signatureGenerator: LanguageService,
+ val templateService: HtmlTemplateService)
: StructuredFormatService(locationService, signatureGenerator, "html"), OutlineFormatService {
- override public fun formatText(text: String): String {
+ override fun formatText(text: String): String {
return text.htmlEscape()
}
diff --git a/core/src/main/kotlin/Formats/HtmlTemplateService.kt b/core/src/main/kotlin/Formats/HtmlTemplateService.kt
index ae42a31b..13587b05 100644
--- a/core/src/main/kotlin/Formats/HtmlTemplateService.kt
+++ b/core/src/main/kotlin/Formats/HtmlTemplateService.kt
@@ -2,12 +2,12 @@ package org.jetbrains.dokka
import java.nio.file.Path
-public interface HtmlTemplateService {
+interface HtmlTemplateService {
fun appendHeader(to: StringBuilder, title: String?, basePath: Path)
fun appendFooter(to: StringBuilder)
companion object {
- public fun default(css: String? = null): HtmlTemplateService {
+ fun default(css: String? = null): HtmlTemplateService {
return object : HtmlTemplateService {
override fun appendFooter(to: StringBuilder) {
to.appendln("</BODY>")
diff --git a/core/src/main/kotlin/Formats/KotlinWebsiteFormatService.kt b/core/src/main/kotlin/Formats/KotlinWebsiteFormatService.kt
index 870347ab..f869bc75 100644
--- a/core/src/main/kotlin/Formats/KotlinWebsiteFormatService.kt
+++ b/core/src/main/kotlin/Formats/KotlinWebsiteFormatService.kt
@@ -2,7 +2,7 @@ package org.jetbrains.dokka
import com.google.inject.Inject
-public class KotlinWebsiteFormatService @Inject constructor(locationService: LocationService,
+class KotlinWebsiteFormatService @Inject constructor(locationService: LocationService,