aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorSimon Ogorodnik <Simon.Ogorodnik@jetbrains.com>2019-09-30 18:55:29 +0300
committerSimon Ogorodnik <Simon.Ogorodnik@jetbrains.com>2019-09-30 18:55:29 +0300
commit3faee19a6b547837f49fbc6794965767cf8caf6d (patch)
tree119dfab8d77b4b0eb6e40cab7669495a8a1e5471 /README.md
parentab3a0654364534cf2c8cad86756450e908faa358 (diff)
parent5b1bfb684dcca4b7ff05d3c3c431df62acf2d5c1 (diff)
downloaddokka-3faee19a6b547837f49fbc6794965767cf8caf6d.tar.gz
dokka-3faee19a6b547837f49fbc6794965767cf8caf6d.tar.bz2
dokka-3faee19a6b547837f49fbc6794965767cf8caf6d.zip
Merge remote-tracking branch 'origin/master' into tmp--release--0.10.0
Diffstat (limited to 'README.md')
-rw-r--r--README.md26
1 files changed, 24 insertions, 2 deletions
diff --git a/README.md b/README.md
index 50bbb6b6..43e5ac9d 100644
--- a/README.md
+++ b/README.md
@@ -455,8 +455,8 @@ The available configuration options are shown below:
<!-- List of '.md' files with package and module docs -->
<!-- https://kotlinlang.org/docs/reference/kotlin-doc.html#module-and-package-documentation -->
<includes>
- <file>packages.md</file>
- <file>extra.md</file>
+ <include>packages.md</include>
+ <include>extra.md</include>
</includes>
<!-- List of sample roots -->
@@ -638,3 +638,25 @@ doesn't affect analysis of source code, it just changes the result. You can thin
Dokka is built with Gradle. To build it, use `./gradlew build`.
Alternatively, open the project directory in IntelliJ IDEA and use the IDE to build and run dokka.
+
+Here's how to import and configure Dokka in IntelliJ IDEA:
+ * Select "Open" from the IDEA welcome screen, or File > Open if a project is
+ already open
+* Select the directory with your clone of Dokka
+ * Note: IDEA may have an error after the project is initally opened; it is OK
+ to ignore this as the next step will address this error
+* After IDEA opens the project, select File > New > Module from existing sources
+ and select the `build.gradle` file from the root directory of your Dokka clone
+* Use the default options and select "OK"
+* After Dokka is loaded into IDEA, open the Gradle tool window (View > Tool
+ Windows > Gradle) and click on the top left "Refresh all Gradle projects"
+ button
+* Verify the following project settings. In File > Settings > Build, Execution,
+ Deployment > Build Tools > Gradle > Runner:
+ * Ensure "Delegate IDE build/run actions to gradle" is checked
+ * "Gradle Test Runner" should be selected in the "Run tests using" drop-down
+ menu
+* Note: After closing and re-opening the project, IDEA may give an error
+ message: "Error Loading Project: Cannot load 3 modules". Open up the details
+ of the error, and click "Remove Selected", as these module `.iml` files are
+ safe to remove.