From 364e4736d1766b57ebd247b4e960a3684979521c Mon Sep 17 00:00:00 2001
From: Tyler Bui-Palsulich <tbp@google.com>
Date: Mon, 30 Mar 2020 13:56:53 -0400
Subject: [PATCH 1/5] feat: add Devsite Javadoc profile

---
 pom.xml | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)

diff --git a/pom.xml b/pom.xml
index 0f659743..fa6cdb70 100644
--- a/pom.xml
+++ b/pom.xml
@@ -572,5 +572,97 @@
         <skipITs>false</skipITs>
       </properties>
     </profile>
+    <profile>
+      <id>devsite-apidocs</id>
+      <activation>
+        <property>
+          <name>devsite.template</name>
+        </property>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <!-- Generate API docs using Doclava for the developer site. -->
+            <artifactId>maven-javadoc-plugin</artifactId>
+            <!-- Note: version 3.x.x uses additionalOption instead of additionalparam. -->
+            <version>3.1.1</version>
+            <executions>
+              <execution>
+                <phase>site</phase>
+                <goals>
+                  <goal>aggregate</goal>
+                </goals>
+              </execution>
+            </executions>
+            <configuration>
+              <docletArtifact>
+                <groupId>com.google.doclava</groupId>
+                <artifactId>doclava</artifactId>
+                <version>1.0.6</version>
+              </docletArtifact>
+              <doclet>com.google.doclava.Doclava</doclet>
+              <bootclasspath>${sun.boot.class.path}</bootclasspath>
+              <additionalDependencies>
+                <additionalDependency>
+                  <groupId>com.google.j2objc</groupId>
+                  <artifactId>j2objc-annotations</artifactId>
+                  <version>1.3</version>
+                </additionalDependency>
+              </additionalDependencies>
+              <additionalOptions>
+                <additionalOption>-hdf</additionalOption>
+                <additionalOption>book.path</additionalOption>
+                <additionalOption>/java/_book.yaml</additionalOption>
+                <additionalOption>-hdf</additionalOption>
+                <additionalOption>project.path</additionalOption>
+                <additionalOption>/_project.yaml</additionalOption>
+                <additionalOption>-hdf</additionalOption>
+                <additionalOption>devsite.path</additionalOption>
+                <additionalOption>/java/docs/reference/</additionalOption>
+                <additionalOption>-d</additionalOption>
+                <additionalOption>${project.build.directory}/apidocs</additionalOption>
+                <additionalOption>-templatedir</additionalOption>
+                <additionalOption>${devsite.template}</additionalOption>
+                <additionalOption>-toroot</additionalOption>
+                <additionalOption>/java/docs/reference/</additionalOption>
+                <additionalOption>-yaml</additionalOption>
+                <additionalOption>_toc.yaml</additionalOption>
+                <additionalOption>-warning</additionalOption>
+                <additionalOption>101</additionalOption>
+              </additionalOptions>
+              <useStandardDocletOptions>false</useStandardDocletOptions>
+              <additionalJOption>-J-Xmx1024m</additionalJOption>
+            </configuration>
+          </plugin>
+          <plugin>
+            <!-- Clean up some references and files. -->
+            <artifactId>maven-antrun-plugin</artifactId>
+            <version>1.7</version>
+            <executions>
+              <execution>
+                <phase>site</phase>
+                <goals>
+                  <goal>run</goal>
+                </goals>
+                <configuration>
+                  <target>
+                    <echo message="Updating relative links in API docs" />
+                    <replace dir="${project.build.directory}/apidocs" token="href=&quot;com" value="href=&quot;/java/docs/reference/com" />
+                    <copy file="${project.build.directory}/apidocs/assets/_toc.yaml" todir="${project.build.directory}/apidocs/reference" />
+                    <delete file="${project.build.directory}/apidocs/reference/classes.html" />
+                    <delete file="${project.build.directory}/apidocs/reference/hierarchy.html" />
+                    <delete file="${project.build.directory}/apidocs/reference/index.html" />
+                    <delete file="${project.build.directory}/apidocs/reference/lists.js" />
+                    <delete file="${project.build.directory}/apidocs/reference/package-list" />
+                    <delete file="${project.build.directory}/apidocs/reference/packages.html" />
+                    <delete file="${project.build.directory}/apidocs/reference/current.xml" />
+                  </target>
+                </configuration>
+              </execution>
+            </executions>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
   </profiles>
 </project>

From 73bf509e71bb2d932b8643316b53694932271542 Mon Sep 17 00:00:00 2001
From: Tyler Bui-Palsulich <tbp@google.com>
Date: Tue, 31 Mar 2020 08:27:06 -0400
Subject: [PATCH 2/5] fix: output dir, google/io, comments, remove memory flag

---
 pom.xml | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/pom.xml b/pom.xml
index fa6cdb70..45e84439 100644
--- a/pom.xml
+++ b/pom.xml
@@ -576,6 +576,7 @@
       <id>devsite-apidocs</id>
       <activation>
         <property>
+          <!-- Activate with the -Ddevsite.template=/path/to/templates flag. -->
           <name>devsite.template</name>
         </property>
       </activation>
@@ -620,7 +621,7 @@
                 <additionalOption>devsite.path</additionalOption>
                 <additionalOption>/java/docs/reference/</additionalOption>
                 <additionalOption>-d</additionalOption>
-                <additionalOption>${project.build.directory}/apidocs</additionalOption>
+                <additionalOption>${project.build.directory}/devsite</additionalOption>
                 <additionalOption>-templatedir</additionalOption>
                 <additionalOption>${devsite.template}</additionalOption>
                 <additionalOption>-toroot</additionalOption>
@@ -631,7 +632,6 @@
                 <additionalOption>101</additionalOption>
               </additionalOptions>
               <useStandardDocletOptions>false</useStandardDocletOptions>
-              <additionalJOption>-J-Xmx1024m</additionalJOption>
             </configuration>
           </plugin>
           <plugin>
@@ -647,15 +647,19 @@
                 <configuration>
                   <target>
                     <echo message="Updating relative links in API docs" />
-                    <replace dir="${project.build.directory}/apidocs" token="href=&quot;com" value="href=&quot;/java/docs/reference/com" />
-                    <copy file="${project.build.directory}/apidocs/assets/_toc.yaml" todir="${project.build.directory}/apidocs/reference" />
-                    <delete file="${project.build.directory}/apidocs/reference/classes.html" />
-                    <delete file="${project.build.directory}/apidocs/reference/hierarchy.html" />
-                    <delete file="${project.build.directory}/apidocs/reference/index.html" />
-                    <delete file="${project.build.directory}/apidocs/reference/lists.js" />
-                    <delete file="${project.build.directory}/apidocs/reference/package-list" />
-                    <delete file="${project.build.directory}/apidocs/reference/packages.html" />
-                    <delete file="${project.build.directory}/apidocs/reference/current.xml" />
+                    <!-- TODO: What is the right behavior for io* and google*? -->
+                    <replace dir="${project.build.directory}/devsite" token="href=&quot;com" value="href=&quot;/java/docs/reference/com" />
+                    <replace dir="${project.build.directory}/devsite" token="href=&quot;io" value="href=&quot;/java/docs/reference/io" />
+                    <replace dir="${project.build.directory}/devsite" token="href=&quot;google" value="href=&quot;/java/docs/reference/google" />
+                    <copy file="${project.build.directory}/devsite/assets/_toc.yaml" todir="${project.build.directory}/devsite/reference" />
+                    <echo message="Removing files not needed by Devsite" />
+                    <delete file="${project.build.directory}/devsite/reference/classes.html" />
+                    <delete file="${project.build.directory}/devsite/reference/hierarchy.html" />
+                    <delete file="${project.build.directory}/devsite/reference/index.html" />
+                    <delete file="${project.build.directory}/devsite/reference/lists.js" />
+                    <delete file="${project.build.directory}/devsite/reference/package-list" />
+                    <delete file="${project.build.directory}/devsite/reference/packages.html" />
+                    <delete file="${project.build.directory}/devsite/reference/current.xml" />
                   </target>
                 </configuration>
               </execution>

From f7ae81f8823261de49d62ac1fe4de52d55ac7005 Mon Sep 17 00:00:00 2001
From: Tyler Bui-Palsulich <tbp@google.com>
Date: Wed, 1 Apr 2020 16:17:47 -0400
Subject: [PATCH 3/5] Don't delete package-list

---
 pom.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 45e84439..eb8b4b0e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -657,7 +657,6 @@
                     <delete file="${project.build.directory}/devsite/reference/hierarchy.html" />
                     <delete file="${project.build.directory}/devsite/reference/index.html" />
                     <delete file="${project.build.directory}/devsite/reference/lists.js" />
-                    <delete file="${project.build.directory}/devsite/reference/package-list" />
                     <delete file="${project.build.directory}/devsite/reference/packages.html" />
                     <delete file="${project.build.directory}/devsite/reference/current.xml" />
                   </target>

From 387857048533001896be4a5d9299f1fe40d02c57 Mon Sep 17 00:00:00 2001
From: Tyler Bui-Palsulich <tbp@google.com>
Date: Wed, 1 Apr 2020 16:18:28 -0400
Subject: [PATCH 4/5] Fix _project.yaml path

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index eb8b4b0e..647cafa3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -616,7 +616,7 @@
                 <additionalOption>/java/_book.yaml</additionalOption>
                 <additionalOption>-hdf</additionalOption>
                 <additionalOption>project.path</additionalOption>
-                <additionalOption>/_project.yaml</additionalOption>
+                <additionalOption>/java/_project.yaml</additionalOption>
                 <additionalOption>-hdf</additionalOption>
                 <additionalOption>devsite.path</additionalOption>
                 <additionalOption>/java/docs/reference/</additionalOption>

From 8c5b42e4168c2a44e613122c77e4e51f36af93fb Mon Sep 17 00:00:00 2001
From: Tyler Bui-Palsulich <tbp@google.com>
Date: Wed, 1 Apr 2020 17:29:40 -0400
Subject: [PATCH 5/5] Remove docs from path

---
 pom.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/pom.xml b/pom.xml
index 647cafa3..e2092c2a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -619,13 +619,13 @@
                 <additionalOption>/java/_project.yaml</additionalOption>
                 <additionalOption>-hdf</additionalOption>
                 <additionalOption>devsite.path</additionalOption>
-                <additionalOption>/java/docs/reference/</additionalOption>
+                <additionalOption>/java/reference/</additionalOption>
                 <additionalOption>-d</additionalOption>
                 <additionalOption>${project.build.directory}/devsite</additionalOption>
                 <additionalOption>-templatedir</additionalOption>
                 <additionalOption>${devsite.template}</additionalOption>
                 <additionalOption>-toroot</additionalOption>
-                <additionalOption>/java/docs/reference/</additionalOption>
+                <additionalOption>/java/reference/</additionalOption>
                 <additionalOption>-yaml</additionalOption>
                 <additionalOption>_toc.yaml</additionalOption>
                 <additionalOption>-warning</additionalOption>
@@ -648,9 +648,9 @@
                   <target>
                     <echo message="Updating relative links in API docs" />
                     <!-- TODO: What is the right behavior for io* and google*? -->
-                    <replace dir="${project.build.directory}/devsite" token="href=&quot;com" value="href=&quot;/java/docs/reference/com" />
-                    <replace dir="${project.build.directory}/devsite" token="href=&quot;io" value="href=&quot;/java/docs/reference/io" />
-                    <replace dir="${project.build.directory}/devsite" token="href=&quot;google" value="href=&quot;/java/docs/reference/google" />
+                    <replace dir="${project.build.directory}/devsite" token="href=&quot;com" value="href=&quot;/java/reference/com" />
+                    <replace dir="${project.build.directory}/devsite" token="href=&quot;io" value="href=&quot;/java/reference/io" />
+                    <replace dir="${project.build.directory}/devsite" token="href=&quot;google" value="href=&quot;/java/reference/google" />
                     <copy file="${project.build.directory}/devsite/assets/_toc.yaml" todir="${project.build.directory}/devsite/reference" />
                     <echo message="Removing files not needed by Devsite" />
                     <delete file="${project.build.directory}/devsite/reference/classes.html" />