Skip to content

Commit d4ac097

Browse files
committed
chore: Change anchor text
1 parent 4455a48 commit d4ac097

12 files changed

+37
-37
lines changed

docs/topics/components-stability.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,4 @@ Contracts in stdlib|Stable|1.3| |
6464
User-defined contracts|Experimental|1.3| |
6565
**All other experimental components, by default**|Experimental|N/A| |
6666

67-
*The pre-1.4 version of this page is available [here](components-stability-pre-1.4.md).*
67+
*[The pre-1.4 version of this page is available here](components-stability-pre-1.4.md).*

docs/topics/configure-build-for-eap.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ You only need to configure your build manually for existing projects — project
66

77
To configure your build to use the EAP version of Kotlin, you need to:
88

9-
* Specify the EAP version of Kotlin. Available EAP versions are listed [here](eap.md#build-details).
9+
* Specify the EAP version of Kotlin. [Available EAP versions are listed here](eap.md#build-details).
1010
* Change the versions of dependencies to EAP ones.
1111
The EAP version of Kotlin may not work with the libraries of the previously released version.
1212

@@ -25,7 +25,7 @@ This section describes how you can:
2525
### Adjust the Kotlin version
2626

2727
In the `plugins` block within `build.gradle(.kts)`, change the `KOTLIN-EAP-VERSION` to the actual EAP version,
28-
such as `%kotlinEapVersion%`. Available EAP versions are listed [here](eap.md#build-details).
28+
such as `%kotlinEapVersion%`. [Available EAP versions are listed here](eap.md#build-details).
2929

3030
Alternatively, you can specify the EAP version in the `pluginManagement` block in `settings.gradle(.kts)` – see [Gradle documentation](https://docs.gradle.org/current/userguide/plugins.html#sec:plugin_version_management) for details.
3131

@@ -93,7 +93,7 @@ dependencies {
9393
## Configure in Maven
9494

9595
In the sample Maven project definition, replace `KOTLIN-EAP-VERSION` with the actual version, such as `%kotlinEapVersion%`.
96-
Available EAP versions are listed [here](eap.md#build-details).
96+
[Available EAP versions are listed here](eap.md#build-details).
9797

9898
```xml
9999
<project ...>

docs/topics/js/js-overview.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ By generating TypeScript declaration files (d.ts) from Kotlin code, the new comp
9797
applications that mix TypeScript and Kotlin code, and leverage code-sharing functionality using Kotlin Multiplatform.
9898

9999
To learn more about the available features in the new Kotlin/JS IR compiler and how to try it for your project, visit the
100-
[documentation](js-ir-compiler.md).
100+
[Kotlin/JS IR compiler documentation](js-ir-compiler.md).
101101

102102
## Join the Kotlin/JS community
103103

docs/topics/native/native-command-line-compiler.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
The Kotlin/Native compiler is available for macOS, Linux, and Windows. It is available as a command line tool and ships
66
as part of the standard Kotlin distribution and can be downloaded from [GitHub Releases](%kotlinLatestUrl%). It supports
77
different targets including iOS (arm32, arm64, simulator x86_64), Windows (mingw32 and x86_64),
8-
Linux (x86_64, arm64, MIPS), macOS (x86_64), Raspberry PI, SMT32, WASM. See the full list of targets [here](native-overview.md).
8+
Linux (x86_64, arm64, MIPS), macOS (x86_64), Raspberry PI, SMT32, WASM. [See the full list of targets here](native-overview.md).
99
While cross-platform compilation is possible, which means using one platform to compile for a different one,
1010
in this %product% case we'll be targeting the same platform we're compiling on.
1111

docs/topics/native/native-objc-interop.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,12 @@ Swift/Objective-C.
88
Kotlin/Native provides bidirectional interoperability with Objective-C.
99
Objective-C frameworks and libraries can be used in Kotlin code if
1010
properly imported to the build (system frameworks are imported by default).
11-
See [here](mpp-configure-compilations.md#configure-interop-with-native-languages) for more details.
11+
See [compilation configurations](mpp-configure-compilations.md#configure-interop-with-native-languages) for more details.
1212
A Swift library can be used in Kotlin code if its API is exported to Objective-C
1313
with `@objc`. Pure Swift modules are not yet supported.
1414

1515
Kotlin modules can be used in Swift/Objective-C code if compiled into a
16-
framework (see [here](mpp-build-native-binaries.md#declare-binaries)).
16+
framework ([see here for how to declare binaries](mpp-build-native-binaries.md#declare-binaries)).
1717
See [calculator sample](https://github.com/JetBrains/kotlin/tree/master/kotlin-native/samples/calculator) for an example.
1818

1919
## Mappings

docs/topics/native/native-overview.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Kotlin/Native supports the following platforms:
2020
* Windows (MinGW)
2121
* Android NDK
2222

23-
The full list of supported targets is available [here](mpp-supported-platforms.md).
23+
[The full list of supported targets is available here](mpp-supported-platforms.md).
2424

2525

2626
## Interoperability

docs/topics/sam-with-receiver-plugin.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
The *sam-with-receiver* compiler plugin makes the first parameter of the annotated Java "single abstract method" (SAM)
44
interface method a receiver in Kotlin. This conversion only works when the SAM interface is passed as a Kotlin lambda,
5-
both for SAM adapters and SAM constructors (see the [documentation](java-interop.md#sam-conversions) for more details).
5+
both for SAM adapters and SAM constructors (see the [SAM conversions documentation](java-interop.md#sam-conversions) for more details).
66

77
Here is an example:
88

docs/topics/type-safe-builders.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ fun result() =
4747
```
4848

4949
This is completely legitimate Kotlin code.
50-
You can play with this code online (modify it and run in the browser) [here](https://play.kotlinlang.org/byExample/09_Kotlin_JS/06_HtmlBuilder).
50+
You can [play with this code online (modify it and run in the browser) here](https://play.kotlinlang.org/byExample/09_Kotlin_JS/06_HtmlBuilder).
5151

5252
## How it works
5353

docs/topics/whatsnew11.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ fun main(args: Array<String>) {
120120
```
121121
{kotlin-runnable="true" kotlin-min-compiler-version="1.3"}
122122

123-
See the [documentation](type-aliases.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/type-aliases.md) for more details.
123+
See the [type aliases documentation](type-aliases.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/type-aliases.md) for more details.
124124

125125
### Bound callable references
126126

@@ -171,7 +171,7 @@ fun main(args: Array<String>) {
171171
```
172172
{kotlin-runnable="true" kotlin-min-compiler-version="1.3"}
173173

174-
Read the [documentation](sealed-classes.md) or KEEPs for
174+
Read the [sealed classes documentation](sealed-classes.md) or KEEPs for
175175
[sealed class](https://github.com/Kotlin/KEEP/blob/master/proposals/sealed-class-inheritance.md) and
176176
[data class](https://github.com/Kotlin/KEEP/blob/master/proposals/data-class-inheritance.md) for more detail.
177177

@@ -196,7 +196,7 @@ fun main(args: Array<String>) {
196196
```
197197
{kotlin-runnable="true" kotlin-min-compiler-version="1.3"}
198198

199-
Read the [documentation](destructuring-declarations.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/destructuring-in-parameters.md) for more details.
199+
Read the [destructuring declarations documentation](destructuring-declarations.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/destructuring-in-parameters.md) for more details.
200200

201201
### Underscores for unused parameters
202202

@@ -290,7 +290,7 @@ fun main(args: Array<String>) {
290290

291291
You can also mark the entire property as `inline` - then the modifier is applied to both accessors.
292292

293-
Read the [documentation](inline-functions.md#inline-properties) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/inline-properties.md) for more details.
293+
Read the [inline functions documentation](inline-functions.md#inline-properties) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/inline-properties.md) for more details.
294294

295295
### Local delegated properties
296296

@@ -348,7 +348,7 @@ class MyUI {
348348
The `provideDelegate` method will be called for each property during the creation of a `MyUI` instance, and it can perform
349349
the necessary validation right away.
350350

351-
Read the [documentation](delegated-properties.md) for more details.
351+
Read the [delegated properties documentation](delegated-properties.md) for more details.
352352

353353
### Generic enum value access
354354

@@ -391,7 +391,7 @@ In Kotlin 1.1, you can restrict that, so that only methods defined on the implic
391391
will be available inside the lambda passed to `td`. You do that by defining your annotation marked with the `@DslMarker` meta-annotation
392392
and applying it to the base class of the tag classes.
393393

394-
Read the [documentation](type-safe-builders.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/scope-control-for-implicit-receivers.md) for more details.
394+
Read the [type safe builders documentation](type-safe-builders.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/scope-control-for-implicit-receivers.md) for more details.
395395

396396
### rem operator
397397

docs/topics/whatsnew12.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ actual fun hello(world: String): String =
5454
actual typealias URL = java.net.URL
5555
```
5656

57-
See the [documentation](multiplatform.md) for details and steps to build a multiplatform project.
57+
See the [multiplatform programming documentation](multiplatform.md) for details and steps to build a multiplatform project.
5858

5959
## Other language features
6060

docs/topics/whatsnew13.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ The key differences to the old model are:
2929
(for example, in a module that targets JS, Android and iOS, you can have a source set that is shared only between Android and iOS).
3030
* [Publishing multiplatform libraries](mpp-publish-lib.md) is now supported.
3131

32-
For more information, please refer to the [Multiplatform Programming documentation](multiplatform.md).
32+
For more information, please refer to the [multiplatform programming documentation](multiplatform.md).
3333

3434
## Contracts
3535

@@ -146,7 +146,7 @@ fun Request.getBody() =
146146
```
147147

148148
While it was already possible to extract this variable just before `when` , `val` in `when` has its scope properly restricted
149-
to the body of `when`, and so preventing namespace pollution. See the full documentation on `when` [here](control-flow.md#when-expression).
149+
to the body of `when`, and so preventing namespace pollution. [See the full documentation on `when` here](control-flow.md#when-expression).
150150

151151
## @JvmStatic and @JvmField in companions of interfaces
152152

docs/topics/whatsnew14.md

+17-17
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ fun main() {
3838
```
3939
{kotlin-runnable="true" kotlin-min-compiler-version="1.4"}
4040

41-
Learn more about [Kotlin functional interfaces and SAM conversions](fun-interfaces.md).
41+
[Learn more about Kotlin functional interfaces and SAM conversions](fun-interfaces.md).
4242

4343
### Explicit API mode for library authors
4444

@@ -102,7 +102,7 @@ with the value `strict` or `warning`.
102102
-Xexplicit-api={strict|warning}
103103
```
104104

105-
For more details about the explicit API mode, see the [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/explicit-api-mode.md).
105+
[Find more details about the explicit API mode in the KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/explicit-api-mode.md).
106106

107107
### Mixing named and positional arguments
108108

@@ -572,7 +572,7 @@ In 1.4.0, we've added a new mode for generating default methods: `-Xjvm-default=
572572
interfaces to `default` Java methods. For compatibility with the code that uses the interfaces compiled without `default`,
573573
we also added `all-compatibility` mode.
574574

575-
For more information about default methods in the Java interop, see the [documentation](java-to-kotlin-interop.md#default-methods-in-interfaces) and
575+
For more information about default methods in the Java interop, see the [interoperability documentation](java-to-kotlin-interop.md#default-methods-in-interfaces) and
576576
[this blog post](https://blog.jetbrains.com/kotlin/2020/07/kotlin-1-4-m3-generating-default-methods-in-interfaces/).
577577

578578
### Unified exception type for null checks
@@ -631,10 +631,10 @@ On the JS platform, Kotlin 1.4.0 provides the following improvements:
631631

632632
The `kotlin.js` Gradle plugin comes with an adjusted Gradle DSL, which provides a number of new configuration options and is more closely aligned to the DSL used by the `kotlin-multiplatform` plugin. Some of the most impactful changes include:
633633

634-
- Explicit toggles for the creation of executable files via `binaries.executable()`. Read more about the executing Kotlin/JS and its environment [here](js-project-setup.md#execution-environments).
635-
- Configuration of webpack's CSS and style loaders from within the Gradle configuration via `cssSupport`. Read more about using them [here](js-project-setup.md#css).
636-
- Improved management for npm dependencies, with mandatory version numbers or [semver](https://docs.npmjs.com/misc/semver#versions) version ranges, as well as support for _development_, _peer_, and _optional_ npm dependencies using `devNpm`, `optionalNpm` and `peerNpm`. Read more about dependency management for npm packages directly from Gradle [here](js-project-setup.md#npm-dependencies).
637-
- Stronger integrations for [Dukat](https://github.com/Kotlin/dukat), the generator for Kotlin external declarations. External declarations can now be generated at build time, or can be manually generated via a Gradle task. Read more about how to use the integration [here](js-external-declarations-with-dukat.md).
634+
- Explicit toggles for the creation of executable files via `binaries.executable()`. Read more about the [executing Kotlin/JS and its environment here](js-project-setup.md#execution-environments).
635+
- Configuration of webpack's CSS and style loaders from within the Gradle configuration via `cssSupport`. Read more about [using CSS and style loaders here](js-project-setup.md#css).
636+
- Improved management for npm dependencies, with mandatory version numbers or [semver](https://docs.npmjs.com/misc/semver#versions) version ranges, as well as support for _development_, _peer_, and _optional_ npm dependencies using `devNpm`, `optionalNpm` and `peerNpm`. [Read more about dependency management for npm packages directly from Gradle here](js-project-setup.md#npm-dependencies).
637+
- Stronger integrations for [Dukat](https://github.com/Kotlin/dukat), the generator for Kotlin external declarations. External declarations can now be generated at build time, or can be manually generated via a Gradle task. [Read more about how to use the integration here](js-external-declarations-with-dukat.md).
638638

639639
### New JS IR backend
640640

@@ -653,11 +653,11 @@ kotlin {
653653
}
654654
```
655655

656-
For more detailed information about how to configure the Kotlin/JS IR compiler backend, check out the [documentation](js-ir-compiler.md).
656+
For more detailed information about how to configure the new backend, check out the [Kotlin/JS IR compiler documentation](js-ir-compiler.md).
657657

658658
With the new [@JsExport](js-to-kotlin-interop.md#jsexport-annotation) annotation and the ability to **[generate TypeScript definitions](js-ir-compiler.md#preview-generation-of-typescript-declaration-files-d-ts) from Kotlin code**, the Kotlin/JS IR compiler backend improves JavaScript & TypeScript interoperability. This also makes it easier to integrate Kotlin/JS code with existing tooling, to create **hybrid applications** and leverage code-sharing functionality in multiplatform projects.
659659

660-
Learn more about the available features in the Kotlin/JS IR compiler backend in the [documentation](js-ir-compiler.md).
660+
[Learn more about the available features in the Kotlin/JS IR compiler backend](js-ir-compiler.md).
661661

662662
## Kotlin/Native
663663

@@ -695,7 +695,7 @@ queryData(id: 17) { result, error in
695695
}
696696
```
697697

698-
For more information about using suspending functions in Swift and Objective-C, see the [documentation](native-objc-interop.md).
698+
[Learn more about using suspending functions in Swift and Objective-C](native-objc-interop.md).
699699

700700
### Objective-C generics support by default
701701

@@ -713,7 +713,7 @@ kotlin {
713713
}
714714
```
715715

716-
Please note that all specifics and limitations listed in the [documentation](native-objc-interop.md#generics) are still valid.
716+
Please note that all specifics and limitations listed in the [documentation on interoperability with Objective-C](native-objc-interop.md#generics) are still valid.
717717

718718
### Exception handling in Objective-C/Swift interop
719719

@@ -745,7 +745,7 @@ kotlin {
745745
}
746746
```
747747

748-
For more information about crash report symbolication, see the [documentation](native-ios-symbolication.md).
748+
[Learn more about crash report symbolication](native-ios-symbolication.md).
749749

750750
### Performance improvements
751751

@@ -789,7 +789,7 @@ Depending on your needs, you can add dependencies between:
789789
Complete the initial configuration, and when you add a new dependency to `cocoapods`, just re-import the project in IntelliJ IDEA.
790790
The new dependency will be added automatically. No additional steps are required.
791791

792-
Learn [how to add dependencies](native-cocoapods.md).
792+
[Learn how to add dependencies](native-cocoapods.md).
793793

794794
## Kotlin Multiplatform
795795

@@ -906,7 +906,7 @@ native targets. This can help you share more native code without being limited b
906906
No additional steps are required – everything is done automatically. IntelliJ IDEA will help you detect common declarations
907907
that you can use in the shared code.
908908

909-
Learn more about [usage of platform-dependent libraries](mpp-share-on-platforms.md#use-native-libraries-in-the-hierarchical-structure).
909+
[Learn more about usage of platform-dependent libraries](mpp-share-on-platforms.md#use-native-libraries-in-the-hierarchical-structure).
910910

911911
### Specifying dependencies only once
912912

@@ -953,7 +953,7 @@ addressed later.
953953
If you need a dependency only for a specific platform, you can still use platform-specific variants of standard and kotlinx
954954
libraries with such suffixes as `-jvm` or` -js`, for example `kotlinx-coroutines-core-jvm`.
955955

956-
Learn more about [configuring dependencies](gradle.md#configuring-dependencies).
956+
[Learn more about configuring dependencies](gradle.md#configuring-dependencies).
957957

958958
## Gradle project improvements
959959

@@ -976,7 +976,7 @@ For platform-specific source sets, the corresponding platform-specific variant o
976976
library is added to the rest. The Kotlin Gradle plugin will select the appropriate JVM standard library depending on
977977
the `kotlinOptions.jvmTarget` [compiler option](gradle.md#compiler-options) of your Gradle build script.
978978

979-
Learn how to [change the default behavior](gradle.md#dependency-on-the-standard-library).
979+
[Learn how to change the default behavior](gradle.md#dependency-on-the-standard-library).
980980

981981
### Minimum Gradle version for Kotlin projects
982982

@@ -1339,7 +1339,7 @@ In 1.4.0, we have added new features to improve your experience with delegated p
13391339
Aside from the new API, we've made some optimizations that reduce the resulting bytecode size. These optimizations are
13401340
described in [this blog post](https://blog.jetbrains.com/kotlin/2019/12/what-to-expect-in-kotlin-1-4-and-beyond/#delegated-properties).
13411341

1342-
For more information about delegated properties, see the [documentation](delegated-properties.md).
1342+
[Learn more about delegated properties](delegated-properties.md).
13431343

13441344
### Converting from KType to Java Type
13451345

0 commit comments

Comments
 (0)