KDoc links to a package

[vmishenev]

package example

/**
* ref to  [example]
*/
fun x(){}

It works in IDEA K1/K2 and Dokka K1/K2.

[IgnatBeresnev]

Related: #3004

[IgnatBeresnev]

I've added the kdoc-spec tag since the documentation on kotlinlang doesn't say that links can lead to packages.

To link to another element (class, method, property, or parameter), simply put its name in square brackets

Given that linking to packages seems logical, it already works in K2 and the fix in K1 is trivial, it makes sense increase the priority of this kdoc spec question.

If we decide that links to packages are acceptable, the documentation on kotlinlang needs to be updated.