*/
package gradlebuild.docs.dsl.docbook;

import org.gradle.internal.UncheckedException;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.StringReader;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * Extracts the main description of a javadoc comment from its raw text, as a stream of characters. See

            "-Dorg.gradle.java.installations.auto-detect=false",
            "-Porg.gradle.java.installations.auto-detect=false",
            "\"-Dorg.gradle.java.installations.paths=$expectedInstallationPaths\"",
            "\"-Porg.gradle.java.installations.paths=$expectedInstallationPaths\"",
        ).joinToString(" ")
    }

      when (val protocol = sslSocket.applicationProtocol) {
        null, "" -> null
        else -> protocol
      }
    } catch (e: UnsupportedOperationException) {
      // https://docs.oracle.com/javase/9/docs/api/javax/net/ssl/SSLSocket.html#getApplicationProtocol--
      null
    }

  @SuppressLint("NewApi")
  override fun configureTlsExtensions(
    sslSocket: SSLSocket,
    hostname: String?,

                "-PteamCityBuildId=%teamcity.build.id%",
                "-Dorg.gradle.java.installations.auto-download=false",
                "-Porg.gradle.java.installations.auto-download=false",
                "-Dorg.gradle.java.installations.auto-detect=false",
                "-Porg.gradle.java.installations.auto-detect=false",
                "\"-Dorg.gradle.java.installations.paths=$expectedInstallationPaths\"",

  /**
   * Make assertions about the suppressed exceptions on this. Prefer this over making direct calls
   * so tests pass on GraalVM, where suppressed exceptions are silently discarded.
   *
   * https://github.com/oracle/graal/issues/3008
   */
  @JvmStatic
  fun Throwable.assertSuppressed(block: (List<@JvmSuppressWildcards Throwable>) -> Unit) {
    if (isGraalVmImage) return
    block(suppressed.toList())
  }

   * use the {@code ArrayList} {@linkplain ArrayList#ArrayList() constructor} directly, taking
   * advantage of <a
   * href="https://docs.oracle.com/javase/tutorial/java/generics/genTypeInference.html#type-inference-instantiation">"diamond"
   * syntax</a>.
   */
  @SuppressWarnings("NonApiType") // acts as a direct substitute for a constructor call

                "-Dorg.gradle.java.installations.auto-download=false",
                "-Porg.gradle.java.installations.auto-download=false",
                "\"-Dorg.gradle.java.installations.paths=$expectedInstallationPaths\"",
                "\"-Porg.gradle.java.installations.paths=$expectedInstallationPaths\"",
                "\"-Porg.gradle.performance.branchName=%teamcity.build.branch%\"",

 *
 * <p><b>{@code default} method warning:</b> This class forwards calls to <i>only some</i> {@code
 * default} methods. Specifically, it forwards calls only for methods that existed <a
 * href="https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ConcurrentMap.html">before
 * {@code default} methods were introduced</a>. For newer methods, like {@code forEach}, it inherits

        }

        if (className.startsWith("java.")) {
            Element linkElement = document.createElement("ulink");
            linkElement.setAttribute("url", String.format("https://docs.oracle.com/javase/%s/docs/api/%s.html", javaVersion,
                    className.replace(".", "/")));
            Element classNameElement = document.createElement("classname");

        .build()

    executor = newVirtualThreadPerTaskExecutor()

    // Capture non-deterministic but probable sysout warnings of pinned threads
    // https://docs.oracle.com/en/java/javase/21/core/virtual-threads.html
    System.setOut(PrintStream(capturedOut))
  }

  @AfterEach
  fun checkForPinning() {
    assertThat(capturedOut.toString()).isEmpty()
  }