Skip to content

Commit d5ab2f2

Browse files
committed
Broken relative links after migration
1 parent 2164611 commit d5ab2f2

File tree

4 files changed

+33
-33
lines changed

4 files changed

+33
-33
lines changed

src/site/antora/modules/ROOT/pages/faq.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,12 +45,12 @@ Refer to xref:manual/configuration.adoc[the Configuration page] for further deta
4545
== How do I configure Log4j programmatically?
4646
4747
Starting with version `2.4`, Log4j provides xref:manual/customconfig.adoc[an API for programmatic configuration].
48-
link:../javadoc/log4j-core/org/apache/logging/log4j/core/config/builder/api/ConfigurationBuilder.html[The new `ConfigurationBuilder` API] allows you to create ``Configuration``s in code by constructing component definitions without requiring you to know about the internals of actual configuration objects like loggers and appenders.
48+
link:javadoc/log4j-core/org/apache/logging/log4j/core/config/builder/api/ConfigurationBuilder.html[The new `ConfigurationBuilder` API] allows you to create ``Configuration``s in code by constructing component definitions without requiring you to know about the internals of actual configuration objects like loggers and appenders.
4949
5050
[#reconfig_from_code]
5151
== How do I reconfigure Log4j programmatically?
5252
53-
You can reconfigure Log4j programmatically using link:../javadoc/log4j-core/org/apache/logging/log4j/core/config/Configurator.html[the `Configurator` API] as follows:
53+
You can reconfigure Log4j programmatically using link:javadoc/log4j-core/org/apache/logging/log4j/core/config/Configurator.html[the `Configurator` API] as follows:
5454
5555
[source,java]
5656
----
@@ -67,12 +67,12 @@ Normally there is no need to do this manually.
6767
Each `LoggerContext` registers a shutdown hook that takes care of releasing resources when the JVM exits, unless the `log4j.shutdownHookEnabled` system property is set to `false`.
6868
Likewise, xref:jakarta.adoc[Web applications] replace the shutdown hook with their own resource management mechanisms.
6969
That is, they clean up necessary resources when the web application is stopped.
70-
However, if you need to manually shut down Log4j, you can use one of the `shutdown()` methods of link:../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#shutdown()[`LogManager`].
70+
However, if you need to manually shut down Log4j, you can use one of the `shutdown()` methods of link:javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#shutdown()[`LogManager`].
7171
7272
[#reconfig_level_from_code]
7373
== How do I set a logger level programmatically?
7474
75-
You can set the level of a logger using link:../javadoc/log4j-core/org/apache/logging/log4j/core/config/Configurator.html[`Configurator`] from Log4j Core:
75+
You can set the level of a logger using link:javadoc/log4j-core/org/apache/logging/log4j/core/config/Configurator.html[`Configurator`] from Log4j Core:
7676
7777
[source,java]
7878
----

src/site/antora/modules/ROOT/pages/jakarta.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Most notably:
5555
5656
- the usage of `ThreadLocal` for object pooling is disabled.
5757
- a web-safe implementation of
58-
link:../javadoc/log4j-api/org/apache/logging/log4j/spi/ThreadContextMap.html[`ThreadContextMap`] is used.
58+
link:javadoc/log4j-api/org/apache/logging/log4j/spi/ThreadContextMap.html[`ThreadContextMap`] is used.
5959
- JMX notifications are sent synchronously.
6060
- the JVM shutdown hook is disabled.
6161
@@ -245,7 +245,7 @@ https://jakarta.ee/specifications/servlet/5.0/apidocs/jakarta/servlet/asyncconte
245245
method.
246246
247247
To successfully propagate the logger context along asynchronous calls, the
248-
link:../javadoc/log4j-jakarta-web/org/apache/logging/log4j/web/WebLoggerContextUtils.html[`WebLoggerContextUtils`]
248+
link:javadoc/log4j-jakarta-web/org/apache/logging/log4j/web/WebLoggerContextUtils.html[`WebLoggerContextUtils`]
249249
helper class is made available.
250250
Using this class you can either decorate a `Runnable` with method calls that bind the appropriate logger context to the thread:
251251
@@ -256,7 +256,7 @@ include::example$manual/webapp/AsyncServlet.java[tag=automatic]
256256
----
257257
258258
or, if more flexibility is required, you can apply the same logic by using
259-
link:../javadoc/log4j-jakarta-web/org/apache/logging/log4j/web/Log4jWebSupport.html[`Log4jWebSupport`]:
259+
link:javadoc/log4j-jakarta-web/org/apache/logging/log4j/web/Log4jWebSupport.html[`Log4jWebSupport`]:
260260
261261
.Snippet from an example {antora-examples-url}/manual/webapp/AsyncServlet.java[`AsyncServlet.java`]
262262
[source,java,indent=0]
@@ -289,7 +289,7 @@ and no version compatible with Jakarta Server Pages 3.0 is available.
289289
====
290290
291291
The Log4j Taglib library defines a tag for most
292-
link:../javadoc/log4j-api/org/apache/logging/log4j/Logger.html[`Logger`]
292+
link:javadoc/log4j-api/org/apache/logging/log4j/Logger.html[`Logger`]
293293
methods, including:
294294
295295
* simple and parameterized log statements:
@@ -440,7 +440,7 @@ See the https://docs.gradle.org/current/userguide/war_plugin.html#sec:war_depend
440440
When using a shared instance of Log4j Core,
441441
you might be interested in identifying the application associated with a given log event.
442442
Log4j Core provides a mechanism to split all
443-
link:../javadoc/log4j-api/org/apache/logging/log4j/Logger.html[`Logger`]
443+
link:javadoc/log4j-api/org/apache/logging/log4j/Logger.html[`Logger`]
444444
instances into logging domains called
445445
xref:manual/architecture.adoc#LoggerContext[`LoggerContext`]s.
446446
You have therefore two ways to separate log events:
@@ -482,10 +482,10 @@ xref:manual/systemproperties.adoc#log4j2.contextSelector[`log4j2.contextSelector
482482
system property to:
483483
484484
* either
485-
link:../javadoc/log4j-core/org/apache/logging/log4j/core/selector/BasicContextSelector.html[`org.apache.logging.log4j.core.selector.BasicContextSelector`]
485+
link:javadoc/log4j-core/org/apache/logging/log4j/core/selector/BasicContextSelector.html[`org.apache.logging.log4j.core.selector.BasicContextSelector`]
486486
to use synchronous loggers,
487487
* or
488-
link:../javadoc/log4j-core/org/apache/logging/log4j/core/async/BasicAsyncLoggerContextSelector.html[`org.apache.logging.log4j.core.async.BasicAsyncLoggerContextSelector`]
488+
link:javadoc/log4j-core/org/apache/logging/log4j/core/async/BasicAsyncLoggerContextSelector.html[`org.apache.logging.log4j.core.async.BasicAsyncLoggerContextSelector`]
489489
to use asynchronous loggers.
490490
491491
In this approach, you must use xref:manual/lookups.adoc[lookups] to register the application that generated a log event.
@@ -580,7 +580,7 @@ include::example$manual/webapp/log4j2-single.properties[tag=routing]
580580
==== Multiple logger contexts
581581
582582
Since Log4j Core uses
583-
link:../javadoc/log4j-core/org/apache/logging/log4j/core/selector/ClassLoaderContextSelector.html[`ClassLoaderContextSelector`]
583+
link:javadoc/log4j-core/org/apache/logging/log4j/core/selector/ClassLoaderContextSelector.html[`ClassLoaderContextSelector`]
584584
by default, no configuration is needed to achieve multiple logger contexts in your application server:
585585
the classes of each classloader will use the logger context associated with the classloader.
586586

src/site/antora/modules/ROOT/pages/manual/customloglevels.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,28 +27,28 @@ Log4j contains following predefined levels:
2727
|===
2828
| Name | Priority
2929
30-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#OFF[`OFF`]<<dont-use-in-code,[see note]>>
30+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#OFF[`OFF`]<<dont-use-in-code,[see note]>>
3131
| 0
3232
33-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#FATAL[`FATAL`]
33+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#FATAL[`FATAL`]
3434
| 100
3535
36-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#ERROR[`ERROR`]
36+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#ERROR[`ERROR`]
3737
| 200
3838
39-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#WARN[`WARN`]
39+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#WARN[`WARN`]
4040
| 300
4141
42-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#INFO[`INFO`]
42+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#INFO[`INFO`]
4343
| 400
4444
45-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#DEBUG[`DEBUG`]
45+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#DEBUG[`DEBUG`]
4646
| 500
4747
48-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#TRACE[`TRACE`]
48+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#TRACE[`TRACE`]
4949
| 600
5050
51-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level#ALL[`ALL`]<<dont-use-in-code,[see note]>>
51+
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html#ALL[`ALL`]<<dont-use-in-code,[see note]>>
5252
| Integer.MAX_VALUE
5353
|===
5454

src/site/antora/modules/ROOT/pages/migrate-from-log4j1.adoc

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -148,25 +148,25 @@ In order to migrate you code, you need to:
148148
| Migrate Log4j 1 type | to Log4j type
149149
150150
| {log4j1-url}/apidocs/org/apache/log4j/MDC.html[org.apache.log4j.MDC]
151-
| link:../javadoc/log4j-api/org/apache/logging/log4j/ThreadContext.html[org.apache.logging.log4j.ThreadContext]
151+
| link:javadoc/log4j-api/org/apache/logging/log4j/ThreadContext.html[org.apache.logging.log4j.ThreadContext]
152152
153153
| {log4j1-url}/apidocs/org/apache/log4j/NDC.html[org.apache.log4j.NDC]
154-
| link:../javadoc/log4j-api/org/apache/logging/log4j/ThreadContext.html[org.apache.logging.log4j.ThreadContext]
154+
| link:javadoc/log4j-api/org/apache/logging/log4j/ThreadContext.html[org.apache.logging.log4j.ThreadContext]
155155
156156
| {log4j1-url}/apidocs/org/apache/log4j/Priority.html[org.apache.log4j.Priority]
157-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html[org.apache.logging.log4j.Level]
157+
| link:javadoc/log4j-api/org/apache/logging/log4j/Level.html[org.apache.logging.log4j.Level]
158158
159159
| {log4j1-url}/apidocs/org/apache/log4j/Level.html[org.apache.log4j.Level]
160-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Level.html[org.apache.logging.log4j.Level]
160+
| link:javadoc/log4j-api/org/apache/logging/log4j/Level.html[org.apache.logging.log4j.Level]
161161
162162
| {log4j1-url}/apidocs/org/apache/log4j/Category.html[org.apache.log4j.Category]
163-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Logger.html[org.apache.logging.log4j.Logger]
163+
| link:javadoc/log4j-api/org/apache/logging/log4j/Logger.html[org.apache.logging.log4j.Logger]
164164
165165
| {log4j1-url}/apidocs/org/apache/log4j/Logger.html[org.apache.log4j.Logger]
166-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Logger.html[org.apache.logging.log4j.Logger]
166+
| link:javadoc/log4j-api/org/apache/logging/log4j/Logger.html[org.apache.logging.log4j.Logger]
167167
168168
| {log4j1-url}/apidocs/org/apache/log4j/LogManager.html[org.apache.log4j.LogManager]
169-
| link:../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html[org.apache.logging.log4j.LogManager]
169+
| link:javadoc/log4j-api/org/apache/logging/log4j/LogManager.html[org.apache.logging.log4j.LogManager]
170170
|===
171171
172172
* Some Log4j 1 methods were renamed or moved to a different class.
@@ -178,13 +178,13 @@ Therefore, you need to replace the following methods with their Log4j 2 API equi
178178
| Migrate Log4j 1 method | to Log4j method
179179
180180
| {log4j1-url}/apidocs/org/apache/log4j/Logger.html#getLogger(java.lang.String)[Logger.getLogger()]
181-
| link:../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#getLogger()[LogManager.getLogger()]
181+
| link:javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#getLogger()[LogManager.getLogger()]
182182
183183
| {log4j1-url}/apidocs/org/apache/log4j/Logger.html#getRootLogger()[Logger.getRootLogger()]
184-
| link:../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#getRootLogger()[LogManager.getRootLogger()]
184+
| link:javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#getRootLogger()[LogManager.getRootLogger()]
185185
186186
| {log4j1-url}/apidocs/org/apache/log4j/Category.html#getEffectiveLevel()[Category.getEffectiveLevel()]
187-
| link:../javadoc/log4j-api/org/apache/logging/log4j/Logger.html#getLevel()[Logger.getLevel()]
187+
| link:javadoc/log4j-api/org/apache/logging/log4j/Logger.html#getLevel()[Logger.getLevel()]
188188
|===
189189
190190
* Finally, some methods need specific conversion rules to be applied:
@@ -199,14 +199,14 @@ Therefore, you need to replace the following methods with their Log4j 2 API equi
199199
200200
| {log4j1-url}/apidocs/org/apache/log4j/LogManager.html#shutdown()[`LogManager.shutdown()`]
201201
| Since Log4j 2.6, an equivalent
202-
link:../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#shutdown()[`o.a.l.l.LogManager.shutdown()`]
202+
link:javadoc/log4j-api/org/apache/logging/log4j/LogManager.html#shutdown()[`o.a.l.l.LogManager.shutdown()`]
203203
method can be used.
204204
205205
The utility of this method call depends upon the logging backend used with Log4j API.
206206
207207
The Log4j Core backend automatically adds a JVM shutdown hook on start up to perform any cleanups, so the `LogManager.shutdown()` call can be safely removed.
208208
Starting in Log4j 2.1, you can also specify a custom
209-
link:../javadoc/log4j-core/org/apache/logging/log4j/core/util/ShutdownCallbackRegistry.html[ShutdownCallbackRegistry].
209+
link:javadoc/log4j-core/org/apache/logging/log4j/core/util/ShutdownCallbackRegistry.html[ShutdownCallbackRegistry].
210210
211211
See
212212
xref:manual/systemproperties.adoc#log4j2.shutdownCallbackRegistry[log4j2.shutdownCallbackRegistry]
@@ -504,7 +504,7 @@ The support for Log4j 1 configuration files uses Log4j 2 Core plugin system and
504504
The Log4j 1 to Log4j 2 bridge supports out-of-the-box the following
505505
{log4j1-url}/index.html[Log4j 1]
506506
and
507-
link:/log4j/extras/index/html[Apache Extras for Log4j 1]
507+
link:/log4j/extras/index.html[Apache Extras for Log4j 1]
508508
components:
509509
510510
Appenders::

0 commit comments

Comments
 (0)