Skip to content

Commit

Permalink
Update Dokka's references to 1.8.20 (#3028)
Browse files Browse the repository at this point in the history
(cherry picked from commit bb1c151)
  • Loading branch information
IgnatBeresnev committed Jun 6, 2023
1 parent 46c10ac commit 3cfc50d
Show file tree
Hide file tree
Showing 37 changed files with 79 additions and 79 deletions.
12 changes: 6 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,9 @@ Bug reports, feature requests and questions are welcome. Submit issues [here](ht

## Submitting PRs

Dokka has extensive [Developer Guides](https://kotlin.github.io/dokka/1.8.10/developer_guide/introduction/) documentation
which goes over the development [Workflow](https://kotlin.github.io/dokka/1.8.10/developer_guide/workflow/) and
[Dokka's architecture](https://kotlin.github.io/dokka/1.8.10/developer_guide/architecture/architecture_overview/),
Dokka has extensive [Developer Guides](https://kotlin.github.io/dokka/1.8.20/developer_guide/introduction/) documentation
which goes over the development [Workflow](https://kotlin.github.io/dokka/1.8.20/developer_guide/workflow/) and
[Dokka's architecture](https://kotlin.github.io/dokka/1.8.20/developer_guide/architecture/architecture_overview/),
which can help you understand how to achieve what you want and where to look.

All development (both new features and bugfixes) takes place in the `master` branch, it contains sources for the next
Expand Down Expand Up @@ -61,18 +61,18 @@ Unit tests which are run as part of `build` should not take much time, but you c
### Use/test locally built Dokka

Below you will find a bare-bones instruction on how to use and test locally built Dokka. For more details and examples,
visit [Workflow](https://kotlin.github.io/dokka/1.8.10/developer_guide/workflow/) topic.
visit [Workflow](https://kotlin.github.io/dokka/1.8.20/developer_guide/workflow/) topic.

1. Change `dokka_version` in `gradle.properties` to something that you will use later on as the dependency version.
For instance, you can set it to something like `1.8.10-my-fix-SNAPSHOT`.
For instance, you can set it to something like `1.8.20-my-fix-SNAPSHOT`.
2. Publish it to Maven Local (`./gradlew publishToMavenLocal`)
3. In the project for which you want to generate documentation add Maven Local as a buildscript/dependency
repository (`mavenLocal()`)
4. Update your Dokka dependency to the version you've just published:

```kotlin
plugins {
id("org.jetbrains.dokka") version "1.8.10-my-fix-SNAPSHOT"
id("org.jetbrains.dokka") version "1.8.20-my-fix-SNAPSHOT"
}
```

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Apply the Gradle plugin for Dokka in the root build script of your project:

```kotlin
plugins {
id("org.jetbrains.dokka") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.20"
}
```

Expand All @@ -64,7 +64,7 @@ Apply Gradle plugin for Dokka in the root project:

```groovy
plugins {
id 'org.jetbrains.dokka' version '1.8.10'
id 'org.jetbrains.dokka' version '1.8.20'
}
```

Expand Down Expand Up @@ -98,7 +98,7 @@ Add the Dokka Maven plugin to the `plugins` section of your POM file:
<plugin>
<groupId>org.jetbrains.dokka</groupId>
<artifactId>dokka-maven-plugin</artifactId>
<version>1.8.10</version>
<version>1.8.20</version>
<executions>
<execution>
<phase>pre-site</phase>
Expand Down Expand Up @@ -137,7 +137,7 @@ Android platform:

```kotlin
dependencies {
dokkaPlugin("org.jetbrains.dokka:android-documentation-plugin:1.8.10")
dokkaPlugin("org.jetbrains.dokka:android-documentation-plugin:1.8.20")
}
```

Expand All @@ -148,7 +148,7 @@ dependencies {

```groovy
dependencies {
dokkaPlugin 'org.jetbrains.dokka:android-documentation-plugin:1.8.10'
dokkaPlugin 'org.jetbrains.dokka:android-documentation-plugin:1.8.20'
}
```

Expand All @@ -167,7 +167,7 @@ dependencies {
<plugin>
<groupId>org.jetbrains.dokka</groupId>
<artifactId>android-documentation-plugin</artifactId>
<version>1.8.10</version>
<version>1.8.20</version>
</plugin>
</dokkaPlugins>
</configuration>
Expand Down Expand Up @@ -214,7 +214,7 @@ implement plugins for missing or very specific features that are not provided ou
Learn more about Dokka plugins and their configuration in [Dokka plugins](https://kotlinlang.org/docs/dokka-plugins.html).

If you want to learn how to develop Dokka plugins, see
[Developer guides](https://kotlin.github.io/dokka/1.8.10/developer_guide/introduction/).
[Developer guides](https://kotlin.github.io/dokka/1.8.20/developer_guide/introduction/).

## Community

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,5 +9,5 @@ plugins {

tasks.dokkaHtml {
onlyIf { !isLocalPublication }
outputDirectory.set(layout.buildDirectory.dir("dokka").map { it.asFile })
outputDirectory.set(layout.buildDirectory.dir("dokka"))
}
4 changes: 2 additions & 2 deletions docs/v.list
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

<vars>
<var name="dokkaVersion"
value="1.8.10"
value="1.8.20"
type="string"/>
<var name="kotlinVersion"
value="1.8.10"
value="1.8.20"
type="string"/>
</vars>
6 changes: 3 additions & 3 deletions examples/gradle/dokka-customFormat-example/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@ import org.jetbrains.dokka.base.DokkaBase
import org.jetbrains.dokka.base.DokkaBaseConfiguration

plugins {
kotlin("jvm") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10"
kotlin("jvm") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20"
}

buildscript {
dependencies {
classpath("org.jetbrains.dokka:dokka-base:1.8.10")
classpath("org.jetbrains.dokka:dokka-base:1.8.20")
}
}

Expand Down
4 changes: 2 additions & 2 deletions examples/gradle/dokka-gradle-example/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@ import org.jetbrains.dokka.gradle.DokkaTask
import java.net.URL

plugins {
kotlin("jvm") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10"
kotlin("jvm") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20"
}

repositories {
Expand Down
10 changes: 5 additions & 5 deletions examples/gradle/dokka-kotlinAsJava-example/build.gradle.kts
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
plugins {
kotlin("jvm") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10"
kotlin("jvm") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20"
}

repositories {
Expand All @@ -11,11 +11,11 @@ dependencies {
testImplementation(kotlin("test-junit"))

// Will apply the plugin to all Dokka tasks
dokkaPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.8.10")
dokkaPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.8.20")

// Will apply the plugin only to the `:dokkaHtml` task
//dokkaHtmlPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.8.10")
//dokkaHtmlPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.8.20")

// Will apply the plugin only to the `:dokkaGfm` task
//dokkaGfmPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.8.10")
//dokkaGfmPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.8.20")
}
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
plugins {
kotlin("jvm") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10"
kotlin("jvm") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20"
`java-library`
`maven-publish`
}
Expand Down
4 changes: 2 additions & 2 deletions examples/gradle/dokka-multimodule-example/gradle.properties
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
kotlinVersion=1.8.10
dokkaVersion=1.8.10
kotlinVersion=1.8.20
dokkaVersion=1.8.20
4 changes: 2 additions & 2 deletions examples/gradle/dokka-multiplatform-example/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ import org.jetbrains.dokka.gradle.DokkaTask
import org.jetbrains.dokka.Platform

plugins {
kotlin("multiplatform") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10"
kotlin("multiplatform") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20"
}

repositories {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
plugins {
kotlin("jvm") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10" apply false
kotlin("jvm") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20" apply false
}

// The versioning plugin must be applied in all submodules
Expand All @@ -14,6 +14,6 @@ subprojects {
}
val dokkaPlugin by configurations
dependencies {
dokkaPlugin("org.jetbrains.dokka:versioning-plugin:1.8.10")
dokkaPlugin("org.jetbrains.dokka:versioning-plugin:1.8.20")
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import org.jetbrains.dokka.versioning.VersioningConfiguration

buildscript {
dependencies {
classpath("org.jetbrains.dokka:versioning-plugin:1.8.10")
classpath("org.jetbrains.dokka:versioning-plugin:1.8.20")
}

repositories {
Expand Down
4 changes: 2 additions & 2 deletions examples/maven/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<artifactId>kotlin-maven-example</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<kotlin.version>1.8.10</kotlin.version>
<dokka.version>1.8.10</dokka.version>
<kotlin.version>1.8.20</kotlin.version>
<dokka.version>1.8.20</dokka.version>
</properties>

<dependencies>
Expand Down
4 changes: 2 additions & 2 deletions examples/plugin/hide-internal-api/README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# Hide Internal API plugin example

This project represents a simple Dokka Plugin that was developed step-by-step in the
[Sample plugin](https://kotlin.github.io/dokka/1.8.10/developer_guide/plugin-development/sample-plugin-tutorial/)
[Sample plugin](https://kotlin.github.io/dokka/1.8.20/developer_guide/plugin-development/sample-plugin-tutorial/)
tutorial. This is a frequent request with varying requirements.

The plugin excludes any declaration that is marked with `org.jetbrains.dokka.internal.test.Internal` annotation.
The annotation itself is not provided in this project and is instead matched by the fully qualified name only.
You can change it to your own internal annotation or to some other marker that suits you.

To learn how to install and debug it locally,
[see documentation](https://kotlin.github.io/dokka/1.8.10/developer_guide/plugin-development/sample-plugin-tutorial/#debugging).
[see documentation](https://kotlin.github.io/dokka/1.8.20/developer_guide/plugin-development/sample-plugin-tutorial/#debugging).

___

Expand Down
4 changes: 2 additions & 2 deletions examples/plugin/hide-internal-api/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
import java.net.URI

plugins {
kotlin("jvm") version "1.8.10"
id("org.jetbrains.dokka") version "1.8.10"
kotlin("jvm") version "1.8.20"
id("org.jetbrains.dokka") version "1.8.20"
`maven-publish`
signing
}
Expand Down
2 changes: 1 addition & 1 deletion examples/plugin/hide-internal-api/gradle.properties
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokkaVersion=1.8.10
dokkaVersion=1.8.20
2 changes: 1 addition & 1 deletion gradle/libs.versions.toml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

gradlePlugin-kotlin = "1.8.20"
gradlePlugin-android = "4.1.3"
gradlePlugin-dokka = "1.8.10"
gradlePlugin-dokka = "1.8.20"

kotlinx-coroutines = "1.6.3"
kotlinx-bcv = "0.12.1"
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
dokka_it_android_gradle_plugin_version=4.1.3
android.useAndroidX=true
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ buildscript {
}
}

version = "1.8.10-SNAPSHOT"
version = "1.8.20-SNAPSHOT"

apply(from = "../template.root.gradle.kts")

Expand Down
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ buildscript {
}
}

version = "1.8.10-SNAPSHOT"
version = "1.8.20-SNAPSHOT"

apply(from = "../template.root.gradle.kts")

Expand All @@ -26,4 +26,4 @@ tasks.withType<DokkaTask> {
}
}

fun Project.getBooleanProperty(name: String): Boolean = (project.property(name) as String).toBoolean()
fun Project.getBooleanProperty(name: String): Boolean = (project.property(name) as String).toBoolean()
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
fail_on_warning=false
report_undocumented=false
report_undocumented=false
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
react_version=18.2.0-pre.467
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20

Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
#these flags are enabled by default since 1.6.20.
#remove when this test is executed with Kotlin >= 1.6.20
kotlin.mpp.enableGranularSourceSetsMetadata=true
Expand Down
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
task_number=100
Original file line number Diff line number Diff line change
@@ -1 +1 @@
dokka_it_kotlin_version=1.8.10
dokka_it_kotlin_version=1.8.20
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ class BasicGradleIntegrationTest(override val versions: BuildVersions) : Abstrac
val indexFile = File(this, "index.html")
assertTrue(indexFile.isFile, "Missing index.html")
assertTrue(
"""<title>Basic Project 1.8.10-SNAPSHOT API </title>""" in indexFile.readText(),
"""<title>Basic Project 1.8.20-SNAPSHOT API </title>""" in indexFile.readText(),
"Header with version number not present in index.html"
)

Expand Down
2 changes: 1 addition & 1 deletion integration-tests/maven/projects/it-maven/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<version>1.0-SNAPSHOT</version>

<properties>
<kotlin.version>1.8.10</kotlin.version>
<kotlin.version>1.8.20</kotlin.version>
</properties>
<build>
<plugins>
Expand Down
4 changes: 2 additions & 2 deletions mkdocs/src/doc/docs/developer_guide/workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Having built Dokka locally, you can publish it to `mavenLocal()`. This will allo
project as well as debug code remotely.

1. Change `dokka_version` in `gradle.properties` to something that you will use later on as the dependency version.
For instance, you can set it to something like `1.8.10-my-fix-SNAPSHOT`. This version will be propagated to plugins
For instance, you can set it to something like `1.8.20-my-fix-SNAPSHOT`. This version will be propagated to plugins
that reside inside Dokka's project (such as `mathjax`, `kotlin-as-java`, etc).
2. Publish it to maven local (`./gradlew publishToMavenLocal`). Corresponding artifacts should appear in `~/.m2`
3. In the project you want to generate documentation for or debug on, add maven local as a plugin/dependency
Expand All @@ -55,7 +55,7 @@ repositories {
4. Update your dokka dependency to the version you've just published:
```kotlin
plugins {
id("org.jetbrains.dokka") version "1.8.10-my-fix-SNAPSHOT"
id("org.jetbrains.dokka") version "1.8.20-my-fix-SNAPSHOT"
}
```

Expand Down
2 changes: 1 addition & 1 deletion plugins/kotlin-as-java/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The Kotlin as Java plugin is published to maven central as a
[separate artifact](https://mvnrepository.com/artifact/org.jetbrains.dokka/kotlin-as-java-plugin):

```text
org.jetbrains.dokka:kotlin-as-java-plugin:1.8.10
org.jetbrains.dokka:kotlin-as-java-plugin:1.8.20
```

**This plugin is at its early stages**, so you may experience issues and encounter bugs. Feel free to
Expand Down
2 changes: 1 addition & 1 deletion plugins/mathjax/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,5 +23,5 @@ The MathJax plugin is published to Maven Central as a
[separate artifact](https://mvnrepository.com/artifact/org.jetbrains.dokka/mathjax-plugin):

```text
org.jetbrains.dokka:mathjax-plugin:1.8.10
org.jetbrains.dokka:mathjax-plugin:1.8.20
```
Loading

0 comments on commit 3cfc50d

Please sign in to comment.