Migrate from traditional Javadoc /** ... */ to Markdown Javadoc /// ...

core/src/main/java/com/google/googlejavaformat/CloseOp.java

@@ -16,19 +16,15 @@
 
 import com.google.common.base.MoreObjects;
 
-/**
- * A {@code CloseOp} closes a level. It is an {@link Op} in the sequence of {@link Op}s generated by
- * {@link OpsBuilder}. When the sequence is turned into a {@link Doc} by {@link DocBuilder}, ranges
- * delimited by {@link OpenOp}-{@code CloseOp} pairs turn into nested {@link Doc.Level}s.
- */
+/// A `CloseOp` closes a level. It is an [Op] in the sequence of [Op]s generated by [OpsBuilder].
+/// When the sequence is turned into a [Doc] by [DocBuilder], ranges delimited by [OpenOp]-`CloseOp`
+/// pairs turn into nested [Doc.Level]s.
 public enum CloseOp implements Op {
   CLOSE;
 
-  /**
-   * Make a {@code CloseOp}, returning a singleton since they are all the same.
-   *
-   * @return the singleton {@code CloseOp}
-   */
+  /// Make a `CloseOp`, returning a singleton since they are all the same.
+  ///
+  /// @return the singleton `CloseOp`
   public static Op make() {
     return CLOSE;
   }

core/src/main/java/com/google/googlejavaformat/CommentsHelper.java

@@ -18,19 +18,15 @@
 import java.util.Optional;
 import java.util.regex.Pattern;
 
-/**
- * Rewrite comments. This interface is implemented by {@link
- * com.google.googlejavaformat.java.JavaCommentsHelper JavaCommentsHelper}.
- */
+/// Rewrite comments. This interface is implemented by
+/// [`JavaCommentsHelper`][com.google.googlejavaformat.java.JavaCommentsHelper].
 public interface CommentsHelper {
-  /**
-   * Try to rewrite comments, returning rewritten text.
-   *
-   * @param tok the comment's tok
-   * @param maxWidth the line length for the output
-   * @param column0 the current column
-   * @return the rewritten comment
-   */
+  /// Try to rewrite comments, returning rewritten text.
+  ///
+  /// @param tok the comment's tok
+  /// @param maxWidth the line length for the output
+  /// @param column0 the current column
+  /// @return the rewritten comment
   String rewrite(Input.Tok tok, int maxWidth, int column0);
 
   static Optional<String> reformatParameterComment(Tok tok) {