From 2df5c9886f7f3f167870e7aa389b857c9dd2d165 Mon Sep 17 00:00:00 2001
From: James Strachan <james.strachan@gmail.com>
Date: Fri, 13 Apr 2012 15:43:44 +0100
Subject: [PATCH] include a target and css style for external source links in
 the doc

---
 .../main/kotlin/org/jetbrains/kotlin/doc/model/KotlinModel.kt | 4 ++++
 .../jetbrains/kotlin/doc/templates/ClassExtensionsTemplate.kt | 2 +-
 .../org/jetbrains/kotlin/doc/templates/ClassTemplate.kt       | 2 +-
 .../jetbrains/kotlin/doc/templates/PackageTemplateSupport.kt  | 4 ++--
 4 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/model/KotlinModel.kt b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/model/KotlinModel.kt
index 85be8b91aa2..69390a01843 100644
--- a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/model/KotlinModel.kt
+++ b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/model/KotlinModel.kt
@@ -761,6 +761,10 @@ abstract class KAnnotated(val model: KModel, val declarationDescriptor: Declarat
         return model.config.sourceRootHref != null
     }
 
+    fun sourceTargetAttribute(): String {
+        return if (isLinkToSourceRepo()) " target=\"_top\" class=\"repoSourceCode\"" else ""
+    }
+
     fun sourceLink(): String {
         val file = model.filePath(declarationDescriptor)
         if (file != null) {
diff --git a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassExtensionsTemplate.kt b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassExtensionsTemplate.kt
index 507985d9d6f..f43aabefdab 100644
--- a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassExtensionsTemplate.kt
+++ b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassExtensionsTemplate.kt
@@ -29,7 +29,7 @@ ${pkg.name}</FONT>
 Extensions on ${klass.name}</H2>
 <DL>
 <DT>
-extension functions on class <A HREF="${sourceHref(klass)}"><B>${klass.name}</B></A><DT>
+extension functions on class <A HREF="${sourceHref(klass)}"${klass.sourceTargetAttribute()}><B>${klass.name}</B></A><DT>
 from package ${link(pkg)}
 </DL>
 </PRE>
diff --git a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassTemplate.kt b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassTemplate.kt
index fa990cc07b0..8c25a676bcb 100644
--- a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassTemplate.kt
+++ b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/ClassTemplate.kt
@@ -184,7 +184,7 @@ Class ${klass.simpleName}</H2>
 <DL>
 <DT><PRE><FONT SIZE="-1">""")
         printAnnotations(klass.annotations)
-        print("""</FONT>${klass.visibility} ${klass.kindCode} <A HREF="${sourceHref(klass)}"><B>${klass.simpleName}</B></A><DT>""")
+        print("""</FONT>${klass.visibility} ${klass.kindCode} <A HREF="${sourceHref(klass)}"${klass.sourceTargetAttribute()}><B>${klass.simpleName}</B></A><DT>""")
         if (!klass.baseClasses.isEmpty()) {
             print("""extends """)
             for (bc in klass.baseClasses) {
diff --git a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/PackageTemplateSupport.kt b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/PackageTemplateSupport.kt
index b6fb43cf8c3..05cabceea97 100644
--- a/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/PackageTemplateSupport.kt
+++ b/libraries/tools/kdoc/src/main/kotlin/org/jetbrains/kotlin/doc/templates/PackageTemplateSupport.kt
@@ -128,7 +128,7 @@ abstract class PackageTemplateSupport(open val pkg: KPackage) : KDocTemplate() {
 
         printTypeParameters(function, " ")
         printReceiverType(function, " ", ".", " ")
-        print("""<A HREF="${sourceHref(function)}"><B>${function.name}</B></A>""")
+        print("""<A HREF="${sourceHref(function)}"${function.sourceTargetAttribute()}><B>${function.name}</B></A>""")
         printParameters(function)
         print(": ")
         print(link(function.returnType))
@@ -207,7 +207,7 @@ abstract class PackageTemplateSupport(open val pkg: KPackage) : KDocTemplate() {
         }
         */
         println("""</CODE></FONT></TD>""")
-        print("""<TD><CODE><B><A HREF="${sourceHref(property)}">${property.name}</A></B>: """)
+        print("""<TD><CODE><B><A HREF="${sourceHref(property)}"${property.sourceTargetAttribute()}>${property.name}</A></B>: """)
         print(link(property.returnType))
         //printParameters(property)
         println("""</CODE>""")