Removed mentions of HttpPipeline in HttpTrait. (Azure#45134)

Author: vcolin7

sdk/clientcore/core/src/main/java/io/clientcore/core/traits/HttpTrait.java

@@ -5,30 +5,21 @@
 
 import io.clientcore.core.http.client.HttpClient;
 import io.clientcore.core.http.pipeline.HttpInstrumentationOptions;
+import io.clientcore.core.http.pipeline.HttpPipelinePolicy;
 import io.clientcore.core.http.pipeline.HttpRedirectOptions;
 import io.clientcore.core.http.pipeline.HttpRetryOptions;
-import io.clientcore.core.http.pipeline.HttpPipeline;
-import io.clientcore.core.http.pipeline.HttpPipelinePolicy;
 
 /**
  * A {@link io.clientcore.core.traits trait} providing a consistent interface for configuration of HTTP-specific
  * settings. Refer to the
  * <a href="https://aka.ms/azsdk/java/docs/http-client-pipeline">HTTP clients and pipelines</a> documentation for more
  * details on proper usage and configuration of HTTP clients.
  *
- * <p>It is important to understand the precedence order of the {@link HttpTrait} APIs. In particular, if an
- * {@link HttpPipeline} is specified, this takes precedence over all other APIs in the trait, and they will be ignored.
- * If no {@link HttpPipeline} is specified, an HTTP pipeline will be constructed internally based on the settings
- * provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also
- * ignored if an {@link HttpPipeline} is specified, so please be sure to refer to the documentation of types that
- * implement this trait to understand the full set of implications.</p>
- *
  * @param <T> The concrete type that implements the trait. This is required so that fluent operations can continue to
  * return the concrete type, rather than the trait type.
  *
  * @see io.clientcore.core.traits
  * @see HttpClient
- * @see HttpPipeline
  * @see HttpPipelinePolicy
  * @see HttpInstrumentationOptions
  * @see HttpRetryOptions
@@ -38,13 +29,6 @@ public interface HttpTrait<T extends HttpTrait<T>> {
     /**
      * Sets the {@link HttpClient} to use for sending and receiving requests to and from the service.
      *
-     * <p><strong>Note:</strong> It is important to understand the precedence order of the {@link HttpTrait} APIs. In
-     * particular, if a {@link HttpPipeline} is specified, this takes precedence over all other APIs in the trait, and
-     * they will be ignored. If no {@link HttpPipeline} is specified, an HTTP pipeline will be constructed internally
-     * based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this
-     * trait that are also ignored if an {@link HttpPipeline} is specified, so please be sure to refer to the
-     * documentation of types that implement this trait to understand the full set of implications.</p>
-     *
      * @param client The {@link HttpClient} to use for requests.
      *
      * @return Returns the same concrete type with the appropriate properties updated, to allow for fluent chaining of
@@ -55,13 +39,6 @@ public interface HttpTrait<T extends HttpTrait<T>> {
     /**
      * Adds a {@link HttpPipelinePolicy pipeline policy} to apply on each request sent.
      *
-     * <p><strong>Note:</strong> It is important to understand the precedence order of the {@link HttpTrait} APIs. In
-     * particular, if a {@link HttpPipeline} is specified, this takes precedence over all other APIs in the trait, and
-     * they will be ignored. If no {@link HttpPipeline} is specified, an HTTP pipeline will be constructed internally
-     * based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this
-     * trait that are also ignored if an {@link HttpPipeline} is specified, so please be sure to refer to the
-     * documentation of types that implement this trait to understand the full set of implications.</p>
-     *
      * @param pipelinePolicy A {@link HttpPipelinePolicy pipeline policy}.
      *
      * @return Returns the same concrete type with the appropriate properties updated, to allow for fluent chaining of
@@ -74,13 +51,6 @@ public interface HttpTrait<T extends HttpTrait<T>> {
     /**
      * Sets the {@link HttpRetryOptions} for all the requests made through the client.
      *
-     * <p><strong>Note:</strong> It is important to understand the precedence order of the {@link HttpTrait} APIs. In
-     * particular, if a {@link HttpPipeline} is specified, this takes precedence over all other APIs in the trait, and
-     * they will be ignored. If no {@link HttpPipeline} is specified, an HTTP pipeline will be constructed internally
-     * based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this
-     * trait that are also ignored if an {@link HttpPipeline} is specified, so please be sure to refer to the
-     * documentation of types that implement this trait to understand the full set of implications.</p>
-     *
      * @param retryOptions The {@link HttpRetryOptions} to use for all the requests made through the client.
      *
      * @return Returns the same concrete type with the appropriate properties updated, to allow for fluent chaining of
@@ -105,13 +75,6 @@ public interface HttpTrait<T extends HttpTrait<T>> {
      *     the details.</li>
      * </ul>
      *
-     * <p><strong>Note:</strong> It is important to understand the precedence order of the {@link HttpTrait} APIs. In
-     * particular, if a {@link HttpPipeline} is specified, this takes precedence over all other APIs in the trait, and
-     * they will be ignored. If no {@link HttpPipeline} is specified, an HTTP pipeline will be constructed internally
-     * based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this
-     * trait that are also ignored if an {@link HttpPipeline} is specified, so please be sure to refer to the
-     * documentation of types that implement this trait to understand the full set of implications.</p>
-     *
      * @param instrumentationOptions The {@link HttpInstrumentationOptions configuration} to use when recording telemetry about HTTP
      * requests sent to the service and responses received from it.
      *
@@ -123,13 +86,6 @@ public interface HttpTrait<T extends HttpTrait<T>> {
     /**
      * Sets the {@link HttpRedirectOptions} for all the requests made through the client.
      *
-     * <p><strong>Note:</strong> It is important to understand the precedence order of the {@link HttpTrait} APIs. In
-     * particular, if a {@link HttpPipeline} is specified, this takes precedence over all other APIs in the trait, and
-     * they will be ignored. If no {@link HttpPipeline} is specified, an HTTP pipeline will be constructed internally
-     * based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this
-     * trait that are also ignored if an {@link HttpPipeline} is specified, so please be sure to refer to the
-     * documentation of types that implement this trait to understand the full set of implications.</p>
-     *
      * @param redirectOptions The {@link HttpRedirectOptions} to use for all the requests made through the client.
      *
      * @return Returns the same concrete type with the appropriate properties updated, to allow for fluent chaining of