Improve Javadoc postprocessing
- Remove stray extra "/" from postprocessed oracle URLs - Remove date lines so the Javadoc diff better shows what actually changed between releases ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=190973079
This commit is contained in:
parent
3a98f7aa99
commit
64b2b34798
@ -49,7 +49,7 @@ class CombinedJavadocPlugin implements Plugin<Project> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
doLast {
|
doLast {
|
||||||
project.javadocFixLinks()
|
project.fixJavadoc()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -37,7 +37,7 @@ android.libraryVariants.all { variant ->
|
|||||||
project.android.getBootClasspath())
|
project.android.getBootClasspath())
|
||||||
}
|
}
|
||||||
doLast {
|
doLast {
|
||||||
project.javadocFixLinks()
|
project.fixJavadoc()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -11,21 +11,29 @@
|
|||||||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
// See the License for the specific language governing permissions and
|
// See the License for the specific language governing permissions and
|
||||||
// limitations under the License.
|
// limitations under the License.
|
||||||
ext.javadocFixLinks = {
|
ext.fixJavadoc = {
|
||||||
|
def javadocPath = "${project.buildDir}/docs/javadoc"
|
||||||
// Fix external Android links to target the top frame.
|
// Fix external Android links to target the top frame.
|
||||||
def androidRoot = "https://developer.android.com/reference/"
|
def androidRoot = "https://developer.android.com/reference/"
|
||||||
def androidLink = "<a href=\"(${androidRoot}.*?)\\?is-external=true\""
|
def androidLink = "<a href=\"(${androidRoot}.*?)\\?is-external=true\""
|
||||||
def androidFixed = "<a href=\"\\1\" target=\"_top\""
|
def androidFixed = "<a href=\"\\1\" target=\"_top\""
|
||||||
ant.replaceregexp(
|
ant.replaceregexp(match:androidLink, replace:androidFixed, flags:'g') {
|
||||||
match:androidLink, replace:androidFixed, flags:'g', byline:true) {
|
fileset(dir: "${javadocPath}", includes: "**/*.html")
|
||||||
fileset(dir: "${project.buildDir}/docs/javadoc")
|
|
||||||
}
|
}
|
||||||
// Fix external Oracle links to use frames and target the top frame.
|
// Fix external Oracle links to use frames and target the top frame.
|
||||||
def oracleRoot = "https://docs.oracle.com/javase/7/docs/api/"
|
def oracleRoot = "https://docs.oracle.com/javase/7/docs/api/"
|
||||||
def oracleLink = "<a href=\"(${oracleRoot})(.*?)\\?is-external=true\""
|
def oracleLink = "<a href=\"(${oracleRoot})(.*?)\\?is-external=true\""
|
||||||
def oracleFixed = "<a href=\"\\1/index.html\\?\\2\" target=\"_top\""
|
def oracleFixed = "<a href=\"\\1index.html\\?\\2\" target=\"_top\""
|
||||||
ant.replaceregexp(
|
ant.replaceregexp(atch:oracleLink, replace:oracleFixed, flags:'g') {
|
||||||
match:oracleLink, replace:oracleFixed, flags:'g', byline:true) {
|
fileset(dir: "${javadocPath}", includes: "**/*.html")
|
||||||
fileset(dir: "${project.buildDir}/docs/javadoc")
|
}
|
||||||
|
// Remove date metadata that changes every time Javadoc is generated.
|
||||||
|
def javadocGeneratedBy = "<!-- Generated by javadoc.*?-->\n"
|
||||||
|
ant.replaceregexp(match:javadocGeneratedBy, replace:"") {
|
||||||
|
fileset(dir: "${javadocPath}", includes: "**/*.html")
|
||||||
|
}
|
||||||
|
def dateMeta = "<meta name=\"date\".*?>\n"
|
||||||
|
ant.replaceregexp(match:dateMeta, replace:"") {
|
||||||
|
fileset(dir: "${javadocPath}", includes: "**/*.html")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user