From 895f6864b723bd452fe7f5e208a3a1fa3185446a Mon Sep 17 00:00:00 2001
From: Guillaume Smet <guillaume.smet@gmail.com>
Date: Mon, 23 Aug 2021 15:33:07 +0200
Subject: [PATCH] Apply suggestions from code review

Co-authored-by: Erin Schnabel <ebullientworks@gmail.com>
---
 .../common/deployment/ResteasyServerCommonProcessor.java  | 7 ++++++-
 .../vertx/http/deployment/HttpRootPathBuildItem.java      | 8 ++++----
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/extensions/resteasy-classic/resteasy-server-common/deployment/src/main/java/io/quarkus/resteasy/server/common/deployment/ResteasyServerCommonProcessor.java b/extensions/resteasy-classic/resteasy-server-common/deployment/src/main/java/io/quarkus/resteasy/server/common/deployment/ResteasyServerCommonProcessor.java
index cf6a1ffebddd1..0fb0eac20350f 100755
--- a/extensions/resteasy-classic/resteasy-server-common/deployment/src/main/java/io/quarkus/resteasy/server/common/deployment/ResteasyServerCommonProcessor.java
+++ b/extensions/resteasy-classic/resteasy-server-common/deployment/src/main/java/io/quarkus/resteasy/server/common/deployment/ResteasyServerCommonProcessor.java
@@ -137,7 +137,12 @@ static final class ResteasyConfig {
 
         /**
          * Set this to override the default path for JAX-RS resources if there are no
-         * annotated application classes.
+         * annotated application classes. This path is specified with a leading {@literal /}, but is resolved relative
+         *  to {@literal quarkus.http.root-path}.
+         * <ul>
+         * <li>If {@literal quarkus.http.root-path=/} and {@code quarkus.resteasy.path=/bar}, the JAX-RS resource path will be {@literal /bar}</li>
+         * <li>If {@literal quarkus.http.root-path=/bar} and {@code quarkus.resteasy.path=/bar}, the JAX-RS resource path will be {@literal /foo/bar}</li>
+         * </ul>
          */
         @ConfigItem(defaultValue = "/")
         @ConvertWith(NormalizeRootHttpPathConverter.class)
diff --git a/extensions/vertx-http/deployment/src/main/java/io/quarkus/vertx/http/deployment/HttpRootPathBuildItem.java b/extensions/vertx-http/deployment/src/main/java/io/quarkus/vertx/http/deployment/HttpRootPathBuildItem.java
index 11f0690f7b6f0..40afedb5e3c4c 100644
--- a/extensions/vertx-http/deployment/src/main/java/io/quarkus/vertx/http/deployment/HttpRootPathBuildItem.java
+++ b/extensions/vertx-http/deployment/src/main/java/io/quarkus/vertx/http/deployment/HttpRootPathBuildItem.java
@@ -73,13 +73,13 @@ public String resolvePath(String path) {
      * <p>
      * Given {@literal quarkus.http.root-path=/}
      * <ul>
-     * <li>{@code resolvePath("foo")} will return {@literal /foo}</li>
-     * <li>{@code resolvePath("/foo")} will return {@literal /foo}</li>
+     * <li>{@code relativePath("foo")} will return {@literal /foo}</li>
+     * <li>{@code relativePath("/foo")} will return {@literal /foo}</li>
      * </ul>
      * Given {@literal quarkus.http.root-path=/app}
      * <ul>
-     * <li>{@code resolvePath("foo")} will return {@literal /app/foo}</li>
-     * <li>{@code resolvePath("/foo")} will return {@literal /app/foo}</li>
+     * <li>{@code relativePath("foo")} will return {@literal /app/foo}</li>
+     * <li>{@code relativePath("/foo")} will return {@literal /app/foo}</li>
      * </ul>
      * <p>
      * The returned path will not end with a slash.