Skip to content

Commit ae06bc2

Browse files
committed
Merge remote-tracking branch 'origin/master'
2 parents b87b2f1 + cea99b6 commit ae06bc2

File tree

3 files changed

+11
-5
lines changed

3 files changed

+11
-5
lines changed

src/docs/asciidoc/faq.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -258,7 +258,7 @@ public String toString() {
258258
* For example, using Apache 2, configuration:
259259
[source,properties]
260260
----
261-
RequestHeader=set X-Forwarded-Prefix "/custom-path"
261+
RequestHeader set X-Forwarded-Prefix "/custom-path"
262262
----
263263
* Then, in your Spring Boot application make sure your application handles this header: `X-Forwarded-For`. There are two ways to achieve this:
264264
[source,properties]

src/docs/asciidoc/v2/faq.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,7 @@ public String toString() {
249249
* For example, using Apache 2, configuration:
250250
[source,properties]
251251
----
252-
RequestHeader=set X-Forwarded-Prefix "/custom-path"
252+
RequestHeader set X-Forwarded-Prefix "/custom-path"
253253
----
254254
* Then, in your Spring Boot application make sure your application handles this header: `X-Forwarded-For`. There are two ways to achieve this:
255255
[source,properties]

src/docs/asciidoc/v2/modules.adoc

+9-3
Original file line numberDiff line numberDiff line change
@@ -213,12 +213,11 @@ This dependency improves the support of javadoc tags and comments:
213213
- ``@return ``: is resolved as the `@Operation` response description
214214
- The javadoc comment of an attribute: is resolved as '@Schema' description for this field.
215215

216-
This dependency is based on the library https://github.com/dnault/therapi-runtime-javadoc[therapi-runtime-javadoc]
217-
218-
NOTE: Make sure, you enable the annotation processor of `therapi-runtime-javadoc` in order to enable javadoc support for springdoc-openapi.
216+
NOTE: `springdoc-openapi-starter-common` relies on https://github.com/dnault/therapi-runtime-javadoc[`therapi-runtime-javadoc`] to read Javadoc comments at runtime. Ensure that you add it as well as its annotation processor to your project's dependencies. Otherwise, the Javadoc support will fail silently.
219217

220218
[source,xml, subs="attributes+"]
221219
----
220+
<!--Annotation processor -->
222221
<build>
223222
<plugins>
224223
<plugin>
@@ -236,6 +235,13 @@ NOTE: Make sure, you enable the annotation processor of `therapi-runtime-javadoc
236235
</plugin>
237236
</plugins>
238237
</build>
238+
239+
<!-- Runtime library -->
240+
<dependency>
241+
<groupId>com.github.therapi</groupId>
242+
<artifactId>therapi-runtime-javadoc</artifactId>
243+
<version>0.15.0</version>
244+
</dependency>
239245
----
240246

241247
TIP: If both a swagger-annotation description and a javadoc comment are present. The value of the swagger-annotation description will be used.

0 commit comments

Comments
 (0)