Jak dziedziczę dokumentację KDoc?

Question

W Javadoc Java, istnieje sposób dziedziczenia dokumentacji metody w podklasie przy użyciu {@inheritDoc} tag.

Czy jest sposób na to samo w KDoc Kotlina?

Zasadniczo, co chciałbym zrobić, jest następujący:

abstract class Base { 
    /** 
    * Some KDoc documentation here. 
    */ 
    abstract fun foo() 
} 

class Derived: Base() { 
    /** 
    * Here is all the documentation from Base#foo's KDoc inherited. 
    * 
    * And here goes something more in addition. 
    */ 
    override fun foo() { /* ... */ } 
} 

Answer 1

Dokka zawsze kopie dokumentacji z elementem podstawy do odziedziczonej jednego czy odziedziczone użytkownik nie posiada własnej dokumentacji. Nie ma sposobu na połączenie dokumentacji podstawowej z dodatkowym tekstem dostarczonym w dziedziczonym elemencie.

(Dokka nie obsługuje znacznika @inheritdoc Javadoc bo to nieuchronnie prowadzi do proliferacji komentarzy zawierających tylko /** @inheritdoc */ co uważam Super bezużyteczne i zbędne.)