This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 2ffd382e21a7 CAMEL-16861: Cleanup docs (#21802)
2ffd382e21a7 is described below
commit 2ffd382e21a755ca0312ceeaf3af63392ff4c091
Author: Claus Ibsen <[email protected]>
AuthorDate: Sat Mar 7 14:36:29 2026 +0100
CAMEL-16861: Cleanup docs (#21802)
---
.../camel-ftp/src/main/docs/ftp-component.adoc | 5 +++
docs/user-manual/modules/ROOT/pages/jmx.adoc | 16 ++++++++
.../modules/ROOT/pages/producertemplate.adoc | 19 +++++++++
.../management/ManagedCustomProcessorTest.java | 1 -
docs/user-manual/modules/faq/nav.adoc | 19 ---------
.../modules/faq/pages/how-do-i-use-log4j.adoc | 46 ----------------------
...how-does-camel-look-up-beans-and-endpoints.adoc | 20 ----------
.../modules/faq/pages/how-does-camel-work.adoc | 4 --
.../faq/pages/how-does-the-website-work.adoc | 5 ---
...hould-i-invoke-my-pojos-or-spring-services.adoc | 15 -------
.../how-to-create-executable-jar-camel-main.adoc | 41 -------------------
...end-the-same-message-to-multiple-endpoints.adoc | 33 ----------------
docs/user-manual/modules/faq/pages/index.adoc | 36 +----------------
.../modules/faq/pages/is-there-an-ide.adoc | 12 ------
...when-adding-and-removing-routes-at-runtime.adoc | 9 -----
.../modules/faq/pages/what-is-a-router.adoc | 22 -----------
.../modules/faq/pages/what-is-the-license.adoc | 5 ---
.../faq/pages/what-platforms-are-supported.adoc | 5 ---
.../pages/why-cant-i-use-sign-in-my-password.adoc | 9 -----
...my-message-lose-its-headers-during-routing.adoc | 3 --
...use-too-many-threads-with-producertemplate.adoc | 28 -------------
...-does-ftp-component-not-download-any-files.adoc | 7 ----
.../why-does-maven-not-download-dependencies.adoc | 9 -----
...jms-route-only-consume-one-message-at-once.adoc | 16 --------
...is-my-processor-not-showing-up-in-jconsole.adoc | 32 ---------------
.../faq/pages/why-use-multiple-camelcontext.adoc | 14 -------
26 files changed, 41 insertions(+), 390 deletions(-)
diff --git a/components/camel-ftp/src/main/docs/ftp-component.adoc
b/components/camel-ftp/src/main/docs/ftp-component.adoc
index 8722b4f3c49e..81e475d39103 100644
--- a/components/camel-ftp/src/main/docs/ftp-component.adoc
+++ b/components/camel-ftp/src/main/docs/ftp-component.adoc
@@ -544,6 +544,11 @@ String data =
template.retrieveBodyNoWait("ftp://admin@localhost:21/nolist/?pass
This component has log level *TRACE* that can be helpful if you have
problems.
+=== Why does FTP component not download any files?
+
+The xref:components::ftp-component.adoc[FTP] component has many options. So
make sure you have configured it properly.
+Also, a common issue is that you have to use either active or passive mode. So
you may have to set `passiveMode=true` on the endpoint configuration.
+
== Examples
In the sample below, we set up Camel to download all the reports from the
diff --git a/docs/user-manual/modules/ROOT/pages/jmx.adoc
b/docs/user-manual/modules/ROOT/pages/jmx.adoc
index fae600c4d003..9918110fdf56 100644
--- a/docs/user-manual/modules/ROOT/pages/jmx.adoc
+++ b/docs/user-manual/modules/ROOT/pages/jmx.adoc
@@ -146,6 +146,22 @@ due to the increasing number of MBeans in the registry
from its associated
services/producers. Keep in mind that an MBean is not a lightweight object
and consumes memory.
+=== Why is my processor not showing up in JMX?
+
+Not every processor is managed, and thus not all are visible in JMX,
+such as when browsing JConsole.
+
+A `Processor` must implement the `org.apache.camel.Service` to be managed.
+
+All EIP that are implemented in `Processor` are a `Service`.
+
+Your custom `Processor` can implement `Service` or extend `ServiceSupport`,
+and information that should be exposed in JMX can be marked up with the
following annotations from `camel-management` JAR:
+
+- `@ManagedResource` - on class level for general information
+- `@ManagedAttribute` - for JMX attributes
+- `@ManagedOperation` - for JMX operations
+
== Management naming pattern
You can configure a naming pattern for the MBeans names that Camel creates.
diff --git a/docs/user-manual/modules/ROOT/pages/producertemplate.adoc
b/docs/user-manual/modules/ROOT/pages/producertemplate.adoc
index 783a9d684857..13b03f29e680 100644
--- a/docs/user-manual/modules/ROOT/pages/producertemplate.adoc
+++ b/docs/user-manual/modules/ROOT/pages/producertemplate.adoc
@@ -184,6 +184,25 @@ camel.main.producerTemplateCacheSize = 50
The default maximum cache size is 1000.
+== Reusing ProducerTemplate
+
+When you use a `ProducerTemplate` you should ideally reuse the template for
the duration of the lifecycle
+of your Camel application.
+
+A common reason is creating a new `ProducerTemplate` inside a `Processor` or
+xref:ROOT:bean-integration.adoc[bean method invocation].
+
+You are not meant to create a `ProducerTemplate` for each message
+invocation; you are meant to create a single instance on startup and
+keep it around.
+
+When you have finished using the `ProducerTemplate` you should call
+the `stop()` method to close down all the resources it has been using.
+
+If you fail to do so then the Camel application can create more and more
resources (threads etc.)
+
+It's better to either explicitly create one on startup and inject
+the `ProducerTemplate` into your `Processor` or bean, for the template to be
reused.
== See Also
diff --git
a/docs/user-manual/modules/faq/examples/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java
b/docs/user-manual/modules/faq/examples/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java
deleted file mode 120000
index e976af7636ff..000000000000
---
a/docs/user-manual/modules/faq/examples/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java
+++ /dev/null
@@ -1 +0,0 @@
-../../../../../../../../../../../../../../core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java
\ No newline at end of file
diff --git a/docs/user-manual/modules/faq/nav.adoc
b/docs/user-manual/modules/faq/nav.adoc
index d39c2d9c0eab..082415cfa567 100644
--- a/docs/user-manual/modules/faq/nav.adoc
+++ b/docs/user-manual/modules/faq/nav.adoc
@@ -2,40 +2,21 @@
** xref:can-i-get-commercial-support.adoc[Can I get commercial support?]
** link:/community/support/[How can I get help?]
** xref:how-can-i-get-the-source-code.adoc[How can I get the source code?]
-** xref:how-does-camel-work.adoc[How does Camel work?]
-** xref:how-does-the-website-work.adoc[How does the website work?]
** xref:how-do-i-become-a-committer.adoc[How do I become a committer?]
** xref:how-do-i-edit-the-website.adoc[How do I edit the website?]
** xref:running-camel-standalone.adoc[Running Camel standalone]
-** xref:what-is-a-router.adoc[What is a router?]
** xref:what-is-camel.adoc[What is Camel?]
-** xref:what-is-the-license.adoc[What is the license?]
** xref:ROOT:languages.adoc[What languages are supported?]
-** xref:what-platforms-are-supported.adoc[What platforms are supported?]
** xref:why-the-name-camel.adoc[Why the name Camel?]
-** xref:how-does-camel-look-up-beans-and-endpoints.adoc[How does Camel look up
beans and endpoints?]
-** xref:how-should-i-invoke-my-pojos-or-spring-services.adoc[How should I
invoke my POJOs or Spring Services?]
** xref:how-to-avoid-sending-some-or-all-message-headers.adoc[How to avoid
sending some or all message headers?]
** xref:how-to-remove-the-http-protocol-headers-in-the-camel-message.adoc[How
to remove the http protocol headers in the camel message?]
-** xref:how-to-send-the-same-message-to-multiple-endpoints.adoc[How to send
the same message to multiple endpoints?]
**
xref:how-to-switch-the-cxf-consumer-between-http-and-https-without-touching-the-spring-configuration.adoc[How
to switch the CXF consumer between HTTP and HTTPS without touching the Spring
configuration?]
** xref:how-to-use-a-dynamic-uri-in-to.adoc[How to use a dynamic URI in to()?]
-** xref:is-there-an-ide.adoc[Is there an IDE?]
** xref:using-getin-or-getout-methods-on-exchange.adoc[Using getIn or getOut
methods on Exchange]
-** xref:why-cant-i-use-sign-in-my-password.adoc[Why can't I use + sign in my
password?]
** xref:why-can-i-not-use-when-or-otherwise-in-a-java-camel-route.adoc[Why can
I not use when or otherwise in a Java Camel route?]
-** xref:why-does-ftp-component-not-download-any-files.adoc[Why does FTP
component not download any files?]
**
xref:why-does-my-file-consumer-not-pick-up-the-file-and-how-do-i-let-the-file-consumer-use-the-camel-error-handler.adoc[Why
does my file consumer not pick up the file, and how do I let the file consumer
use the Camel error handler?]
**
xref:why-does-useoriginalmessage-with-error-handler-not-work-as-expected.adoc[Why
does useOriginalMessage with error handler not work as expected?]
-** xref:why-do-my-message-lose-its-headers-during-routing.adoc[Why do my
message lose its headers during routing?]
** xref:why-is-my-message-body-empty.adoc[Why is my message body empty?]
-** xref:why-is-my-processor-not-showing-up-in-jconsole.adoc[Why is my
processor not showing up in JConsole?]
** xref:why-is-the-exception-null-when-i-use-onexception.adoc[Why is the
exception null when I use onException?]
-** xref:why-use-multiple-camelcontext.adoc[Why use multiple CamelContext?]
-** xref:how-do-i-use-log4j.adoc[How do I use log4j?]
-** xref:why-does-my-jms-route-only-consume-one-message-at-once.adoc[Why does
my JMS route only consume one message at once?]
** xref:exception-orgapachecamelnosuchendpointexception.adoc[Exception -
org.apache.camel.NoSuchEndpointException]
** xref:exception-orgxmlsaxsaxparseexception.adoc[Exception -
org.xml.sax.SAXParseException]
-** xref:memory-leak-when-adding-and-removing-routes-at-runtime.adoc[Memory
leak when adding and removing routes at runtime]
-** xref:why-does-camel-use-too-many-threads-with-producertemplate.adoc[Why
does Camel use too many threads with ProducerTemplate?]
-** xref:why-does-maven-not-download-dependencies.adoc[Why does maven not
download dependencies?]
diff --git a/docs/user-manual/modules/faq/pages/how-do-i-use-log4j.adoc
b/docs/user-manual/modules/faq/pages/how-do-i-use-log4j.adoc
deleted file mode 100644
index c6928223b560..000000000000
--- a/docs/user-manual/modules/faq/pages/how-do-i-use-log4j.adoc
+++ /dev/null
@@ -1,46 +0,0 @@
-= How do I use Log4j?
-
-Camel uses http://www.slf4j.org/[sfl4j] which allows you to configure
-logging via, among others:
-
-* http://logging.apache.org/log4j/[Log4j]
-* http://logback.qos.ch/[Logback]
-*
https://docs.oracle.com/javase/8/docs/api/java/util/logging/package-summary.html[JDK
Util Logging logging]
-
-The quick way to enable Log4j is to add log4j to your classpath or maven
-`pom.xml`. For example the following in your `pom.xml` should do the trick:
-
-[source,xml]
-----
- <dependencies>
- <dependency>
- <groupId>commons-logging</groupId>
- <artifactId>commons-logging</artifactId>
- </dependency>
- <dependency>
- <groupId>log4j</groupId>
- <artifactId>log4j</artifactId>
- </dependency>
- </dependencies>
-----
-
-Then to configure log4j you need to add a `log4j.properties` or
-`log4j.xml` to your classpath (so they go in a directory which is on
-your classpath).
-
-Here's an example `log4j.properties` file:
-
-[source,java]
-----
-log4j.rootLogger=INFO, out
-
-#
-# uncomment the following line to enable debugging of Camel
-#
-#log4j.logger.org.apache.camel=DEBUG
-
-log4j.appender.out=org.apache.log4j.ConsoleAppender
-log4j.appender.out.layout=org.apache.log4j.PatternLayout
-log4j.appender.out.layout.ConversionPattern=[%30.30t] %-30.30c{1} %-5p %m%n
-#log4j.appender.out.layout.ConversionPattern=%d [%-15.15t] %-5p %-30.30c{1} -
%m%n
-----
diff --git
a/docs/user-manual/modules/faq/pages/how-does-camel-look-up-beans-and-endpoints.adoc
b/docs/user-manual/modules/faq/pages/how-does-camel-look-up-beans-and-endpoints.adoc
deleted file mode 100644
index 6d64bb78424e..000000000000
---
a/docs/user-manual/modules/faq/pages/how-does-camel-look-up-beans-and-endpoints.adoc
+++ /dev/null
@@ -1,20 +0,0 @@
-= How does Camel look up beans, components or endpoints?
-
-There are many times using Camel that a name is used for a bean such as
-using the xref:components::bean-component.adoc[Bean] endpoint or using the
-xref:components:languages:bean-language.adoc[Bean Language] to create a
-xref:ROOT:expression.adoc[Expression] or xref:ROOT:predicate.adoc[Predicate] or
-referring to any xref:ROOT:component.adoc[Component] or
-xref:ROOT:endpoint.adoc[Endpoint].
-
-Camel uses the xref:ROOT:registry.adoc[Registry] to resolve names when
-looking up beans or components or endpoints.
-
-Lots of test cases in the camel-core module don't use Spring (as
-camel-core explicitly doesn't depend on spring) - though test cases in
-camel-spring do.
-
-So you can just define beans, components or endpoints in your
-xref:ROOT:registry.adoc[Registry] implementation then you can refer to them
-by name in the xref:ROOT:endpoint.adoc[Endpoint] URIs or
xref:components::bean-component.adoc[Bean]
-endpoints or xref:components:languages:bean-language.adoc[Bean Language]
expressions.
diff --git a/docs/user-manual/modules/faq/pages/how-does-camel-work.adoc
b/docs/user-manual/modules/faq/pages/how-does-camel-work.adoc
deleted file mode 100644
index 51ea079d62da..000000000000
--- a/docs/user-manual/modules/faq/pages/how-does-camel-work.adoc
+++ /dev/null
@@ -1,4 +0,0 @@
-= How does Camel work?
-
-Please see the xref:ROOT:architecture.adoc[Architecture] for details of how
-things work.
diff --git a/docs/user-manual/modules/faq/pages/how-does-the-website-work.adoc
b/docs/user-manual/modules/faq/pages/how-does-the-website-work.adoc
deleted file mode 100644
index 99184fb32365..000000000000
--- a/docs/user-manual/modules/faq/pages/how-does-the-website-work.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= How does the website work?
-
-The website content sources are distributed across all the camel repositories,
and assembled using the Antora and Hugo static site generators, configured in
the https://github.com/apache/camel-website repository.
-
-See xref:how-do-i-edit-the-website.adoc[] for instructions for simple website
edits and xref:ROOT:improving-the-documentation.adoc[] for more detailed
information and instructions for more complicated edits.
diff --git
a/docs/user-manual/modules/faq/pages/how-should-i-invoke-my-pojos-or-spring-services.adoc
b/docs/user-manual/modules/faq/pages/how-should-i-invoke-my-pojos-or-spring-services.adoc
deleted file mode 100644
index 68c48ef1014c..000000000000
---
a/docs/user-manual/modules/faq/pages/how-should-i-invoke-my-pojos-or-spring-services.adoc
+++ /dev/null
@@ -1,15 +0,0 @@
-= How should I invoke my POJOs or Spring Services?
-
-The various options are described in detail in
-xref:ROOT:bean-integration.adoc[Bean Integration], in particular the
-xref:ROOT:bean-binding.adoc[Bean Binding] describes how we invoke a bean
-inside a route.
-
-See the xref:ROOT:pojo-consuming.adoc[POJO Consuming] for examples using
-either the `@Consume` annotation or using the routing DSL:
-
-[source,java]
-----
-from("jms:someQueue").bean(MyBean.class, "someMethod");
-----
-
diff --git
a/docs/user-manual/modules/faq/pages/how-to-create-executable-jar-camel-main.adoc
b/docs/user-manual/modules/faq/pages/how-to-create-executable-jar-camel-main.adoc
deleted file mode 100644
index fa79582a818a..000000000000
---
a/docs/user-manual/modules/faq/pages/how-to-create-executable-jar-camel-main.adoc
+++ /dev/null
@@ -1,41 +0,0 @@
-= How to create executable JAR for camel-main project
-
-== Fat jar with camel-maven-plugin
-
-In Camel 3.10 onwards you can use the camel-maven-plugin to
-(https://github.com/apache/camel/blob/main/tooling/maven/camel-maven-plugin/src/main/docs/camel-maven-plugin.adoc#camelprepare-fatjar)[prepare
a fat jar].
-
-== Using maven-shade-plugin
-
-You need to use `maven-shade-plugin` to create executable JAR.
-Be aware that uber jar is not fully tested feature and it is Your
responsibility to ensure all services are fully functional.
-You might need some modifications, depending on Your project structure.
-
-[source]
-----
-<plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-shade-plugin</artifactId>
- <version>3.2.1</version>
- <executions>
- <execution>
- <phase>package</phase>
- <goals>
- <goal>shade</goal>
- </goals>
- <configuration>
- <shadedArtifactAttached>true</shadedArtifactAttached>
- <shadedClassifierName>executable-jar</shadedClassifierName>
- <transformers>
- <transformer
implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
- <mainClass>my.package.MainClass</mainClass>
- </transformer>
- <transformer
implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
-
<resource>META-INF/services/org/apache/camel/TypeConverterLoader</resource>
- </transformer>
- </transformers>
- </configuration>
- </execution>
- </executions>
-</plugin>
-----
diff --git
a/docs/user-manual/modules/faq/pages/how-to-send-the-same-message-to-multiple-endpoints.adoc
b/docs/user-manual/modules/faq/pages/how-to-send-the-same-message-to-multiple-endpoints.adoc
deleted file mode 100644
index 4a32b14b5dc3..000000000000
---
a/docs/user-manual/modules/faq/pages/how-to-send-the-same-message-to-multiple-endpoints.adoc
+++ /dev/null
@@ -1,33 +0,0 @@
-= How to send the same message to multiple endpoints?
-
-When you need to send the *same* message to multiple endpoints then you
-should use xref:components:eips:multicast-eip.adoc[Multicast].
-
-In the sample below we consume messages from the activemq queue `foo`
-and want to send the *same message* to both `seda:foo` and `seda:bar`.
-Sending the same message requires that we use
-xref:components:eips:multicast-eip.adoc[Multicast]. This is done by adding the
`multicast()`
-before the to type:
-
-[source,java]
-----
-from("activemq:queue:foo").multicast().to("seda:foo", "seda:bar");
-----
-
-[NOTE]
-====
-**Pipeline is default in Camel**
-
-If you have a route such as:
-
-[source,java]
-----
-from("activemq:queue:foo").to("seda:foo", "seda:bar");
-----
-
-It is by default a xref:components:eips:pipeline-eip.adoc[pipeline] in Camel
(that is
-the opposite to xref:components:eips:multicast-eip.adoc[Multicast]). In the
above example
-using pipes and filters then the result from seda:foo is sent to
-seda:bar, ie. its not the *same* message sent to multiple destinations,
-but a sent through a chain (the pipes and the filters).
-====
diff --git a/docs/user-manual/modules/faq/pages/index.adoc
b/docs/user-manual/modules/faq/pages/index.adoc
index 34ce1fafece0..93d14ebd7776 100644
--- a/docs/user-manual/modules/faq/pages/index.adoc
+++ b/docs/user-manual/modules/faq/pages/index.adoc
@@ -5,8 +5,7 @@ questions which are not on this list, please talk to us on the
link:/community/mailing-list/[Mailing Lists].
We link:/community/contributing/[welcome contributions] and
-this entire website is in
-xref:how-does-the-website-work.adoc[the GitHub repository you can send a pull
request],
+this entire website is in the GitHub repository you can send a pull request,
so please join in and help us make the documentation better!
[[FAQ-GeneralQuestions]]
@@ -17,16 +16,11 @@ General questions about Camel
* xref:can-i-get-commercial-support.adoc[Can I get commercial support?]
* link:/community/support/[How can I get help?]
* xref:how-can-i-get-the-source-code.adoc[How can I get the source code?]
-* xref:how-does-camel-work.adoc[How does Camel work?]
-* xref:how-does-the-website-work.adoc[How does the website work?]
* xref:how-do-i-become-a-committer.adoc[How do I become a committer?]
* xref:how-do-i-edit-the-website.adoc[How do I edit the website?]
* xref:running-camel-standalone.adoc[Running Camel standalone]
-* xref:what-is-a-router.adoc[What is a router?]
* xref:what-is-camel.adoc[What is Camel?]
-* xref:what-is-the-license.adoc[What is the license?]
* xref:ROOT:languages.adoc[What languages are supported?]
-* xref:what-platforms-are-supported.adoc[What platforms are supported?]
* xref:why-the-name-camel.adoc[Why the name Camel?]
[[FAQ-UsingCamelQuestions]]
@@ -34,41 +28,16 @@ General questions about Camel
Questions on using Apache Camel
-* xref:how-does-camel-look-up-beans-and-endpoints.adoc[How does Camel look up
beans and endpoints?]
-* xref:how-should-i-invoke-my-pojos-or-spring-services.adoc[How should I
invoke my POJOs or Spring Services?]
* xref:how-to-avoid-sending-some-or-all-message-headers.adoc[How to avoid
sending some or all message headers?]
-* xref:how-to-create-executable-jar-camel-main.adoc[How to create executable
JAR for camel-main project?]
* xref:how-to-remove-the-http-protocol-headers-in-the-camel-message.adoc[How
to remove the http protocol headers in the camel message?]
-* xref:how-to-send-the-same-message-to-multiple-endpoints.adoc[How to send the
same message to multiple endpoints?]
*
xref:how-to-switch-the-cxf-consumer-between-http-and-https-without-touching-the-spring-configuration.adoc[How
to switch the CXF consumer between HTTP and HTTPS without touching the Spring
configuration?]
* xref:how-to-use-a-dynamic-uri-in-to.adoc[How to use a dynamic URI in to()?]
-* xref:is-there-an-ide.adoc[Is there an IDE?]
* xref:using-getin-or-getout-methods-on-exchange.adoc[Using getIn or getOut
methods on Exchange]
-* xref:why-cant-i-use-sign-in-my-password.adoc[Why can't I use + sign in my
password?]
* xref:why-can-i-not-use-when-or-otherwise-in-a-java-camel-route.adoc[Why can
I not use when or otherwise in a Java Camel route?]
-* xref:why-does-ftp-component-not-download-any-files.adoc[Why does FTP
component not download any files?]
*
xref:why-does-my-file-consumer-not-pick-up-the-file-and-how-do-i-let-the-file-consumer-use-the-camel-error-handler.adoc[Why
does my file consumer not pick up the file, and how do I let the file consumer
use the Camel error handler?]
*
xref:why-does-useoriginalmessage-with-error-handler-not-work-as-expected.adoc[Why
does useOriginalMessage with error handler not work as expected?]
-* xref:why-do-my-message-lose-its-headers-during-routing.adoc[Why do my
message lose its headers during routing?]
* xref:why-is-my-message-body-empty.adoc[Why is my message body empty?]
-* xref:why-is-my-processor-not-showing-up-in-jconsole.adoc[Why is my processor
not showing up in JConsole?]
* xref:why-is-the-exception-null-when-i-use-onexception.adoc[Why is the
exception null when I use onException?]
-* xref:why-use-multiple-camelcontext.adoc[Why use multiple CamelContext?]
-
-[[FAQ-LoggingQuestions]]
-== Logging Questions
-
-Questions on logging output from Camel to a console, using the
-xref:components::log-component.adoc[Log] endpoint or JDK 1.4 logging or Log4j
etc
-
-* xref:how-do-i-use-log4j.adoc[How do I use log4j?]
-
-[[FAQ-JMSQuestions]]
-=== JMS Questions
-
-Questions on using the xref:components::jms-component.adoc[JMS] endpoints in
Camel
-
-* xref:why-does-my-jms-route-only-consume-one-message-at-once.adoc[Why does my
JMS route only consume one message at once?]
[[FAQ-CommonProblems]]
== Common Problems
@@ -77,6 +46,3 @@ Common Problems that people have when riding the Camel
* xref:exception-orgapachecamelnosuchendpointexception.adoc[Exception -
org.apache.camel.NoSuchEndpointException]
* xref:exception-orgxmlsaxsaxparseexception.adoc[Exception -
org.xml.sax.SAXParseException]
-* xref:memory-leak-when-adding-and-removing-routes-at-runtime.adoc[Memory leak
when adding and removing routes at runtime]
-* xref:why-does-camel-use-too-many-threads-with-producertemplate.adoc[Why does
Camel use too many threads with ProducerTemplate?]
-* xref:why-does-maven-not-download-dependencies.adoc[Why does maven not
download dependencies?]
diff --git a/docs/user-manual/modules/faq/pages/is-there-an-ide.adoc
b/docs/user-manual/modules/faq/pages/is-there-an-ide.adoc
deleted file mode 100644
index ccaf261bea86..000000000000
--- a/docs/user-manual/modules/faq/pages/is-there-an-ide.adoc
+++ /dev/null
@@ -1,12 +0,0 @@
-= Is there an IDE for editing Camel routes?
-
-Apache Camel offers no IDE out of the box.
-
-You could use your Java IDE for smart completion when creating
-xref:ROOT:routes.adoc[Java routing rules] via the xref:ROOT:dsl.adoc[DSL] which
-will give you smart completion in Java code.
-Or you can use your XML IDE (with XSD smart completion) to edit the
-xref:ROOT:spring.adoc[routing rules in XML] using Spring XML files.
-
-Some of the xref:ROOT:commercial-camel-offerings.adoc[Commercial Companies]
-offers IDE's and other tooling for Camel.
diff --git
a/docs/user-manual/modules/faq/pages/memory-leak-when-adding-and-removing-routes-at-runtime.adoc
b/docs/user-manual/modules/faq/pages/memory-leak-when-adding-and-removing-routes-at-runtime.adoc
deleted file mode 100644
index 1d6c3f9fcbd4..000000000000
---
a/docs/user-manual/modules/faq/pages/memory-leak-when-adding-and-removing-routes-at-runtime.adoc
+++ /dev/null
@@ -1,9 +0,0 @@
-= Memory leak when adding and removing routes at runtime
-
-If you add and remove many routes at runtime, then take notice that
-xref:components::jmx-component.adoc[JMX] may take up memory when routes is
added.
-As Camel cannot 100% reclaim all MBeans when removing a route (some
-resources may be shared by other routes, etc.).
-
-Therefore it's advised to disable JMX for new routes, by setting
-`registerNewRoutes=false`. See details at
xref:components::jmx-component.adoc[JMX].
diff --git a/docs/user-manual/modules/faq/pages/what-is-a-router.adoc
b/docs/user-manual/modules/faq/pages/what-is-a-router.adoc
deleted file mode 100644
index 0c937c2bf221..000000000000
--- a/docs/user-manual/modules/faq/pages/what-is-a-router.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= What is a router?
-
-We often talk about that Camel is a mediation and routing framework; so
-what exactly is a router and what does it do?
-
-Basically a router just consumes xref:components:eips:message.adoc[Message]
exchanges
-from some xref:ROOT:endpoint.adoc[Endpoint], then sends them on to some other
-xref:ROOT:endpoint.adoc[Endpoint] using some kind of
-xref:components:eips:enterprise-integration-patterns.adoc[Enterprise
Integration
-Patterns].
-
-For example a router could implement the
-xref:components:eips:choice-eip.adoc[Content Based Router] pattern, to route
-from an endpoint to one or more destination endpoints using a
-xref:ROOT:predicate.adoc[Predicate] based on the message content.
-
-Typically a route or router consists of one or more consumers; either an
-xref:components:eips:eventDrivenConsumer-eip.adoc[Event Driven Consumer] or a
-xref:components:eips:polling-consumer.adoc[Polling Consumer] or possibly a
-xref:components:eips:transactional-client.adoc[Transactional Client]. Then
there are one
-or more xref:ROOT:processor.adoc[Processor] instances which could send the
-message to one or more endpoints.
diff --git a/docs/user-manual/modules/faq/pages/what-is-the-license.adoc
b/docs/user-manual/modules/faq/pages/what-is-the-license.adoc
deleted file mode 100644
index 6802fb300a1c..000000000000
--- a/docs/user-manual/modules/faq/pages/what-is-the-license.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= What is the license?
-
-This software is open source using the
-http://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 licence] (a
-liberal BSD style license which is very commercial friendly).
diff --git
a/docs/user-manual/modules/faq/pages/what-platforms-are-supported.adoc
b/docs/user-manual/modules/faq/pages/what-platforms-are-supported.adoc
deleted file mode 100644
index 8afcfad4bead..000000000000
--- a/docs/user-manual/modules/faq/pages/what-platforms-are-supported.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= What platforms are supported?
-
-- Java 8 Support until 3.14.x
-- Java 11 Support for all 3.x version
-- Java 17 Support starting with 3.17.0
diff --git
a/docs/user-manual/modules/faq/pages/why-cant-i-use-sign-in-my-password.adoc
b/docs/user-manual/modules/faq/pages/why-cant-i-use-sign-in-my-password.adoc
deleted file mode 100644
index 77194f3bfd86..000000000000
--- a/docs/user-manual/modules/faq/pages/why-cant-i-use-sign-in-my-password.adoc
+++ /dev/null
@@ -1,9 +0,0 @@
-= Why can't I use `+` sign in my password?
-
-How do I configure password options on Camel endpoints without the value being
encoded?
-
-When you configure Camel endpoints using xref:ROOT:uris.adoc[URIs] then the
-parameter values gets url encoded by default.
-This can be a problem when you want to configure passwords _as is_.
-
-
diff --git
a/docs/user-manual/modules/faq/pages/why-do-my-message-lose-its-headers-during-routing.adoc
b/docs/user-manual/modules/faq/pages/why-do-my-message-lose-its-headers-during-routing.adoc
deleted file mode 100644
index 58e57e3f6f29..000000000000
---
a/docs/user-manual/modules/faq/pages/why-do-my-message-lose-its-headers-during-routing.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-= Why do my message lose its headers during routing?
-
-See this xref:using-getin-or-getout-methods-on-exchange.adoc[FAQ entry].
diff --git
a/docs/user-manual/modules/faq/pages/why-does-camel-use-too-many-threads-with-producertemplate.adoc
b/docs/user-manual/modules/faq/pages/why-does-camel-use-too-many-threads-with-producertemplate.adoc
deleted file mode 100644
index 1503ad4548e9..000000000000
---
a/docs/user-manual/modules/faq/pages/why-does-camel-use-too-many-threads-with-producertemplate.adoc
+++ /dev/null
@@ -1,28 +0,0 @@
-= Why does Camel use too many threads with `ProducerTemplate`?
-
-A common reason is creating a new `ProducerTemplate` inside a `Processor` or
-xref:ROOT:bean-integration.adoc[bean method invocation].
-
-You are not meant to create a `ProducerTemplate` for each message
-invocation; you are meant to create a single instance on startup and
-keep it around.
-
-Also when you have finished using the `ProducerTemplate` you should call
-the `stop()` method to close down all the resources it has been using.
-
-It's better to either explicitly create one on startup or get your IoC
-container (xref:ROOT:spring.adoc[Spring]) to inject
-it into your `Processor` or bean then it can take care of creating it and
-destroying all the resources when you have finished with it.
-
-For instance using xref:ROOT:spring.adoc[Spring] you can define a template
-and have Spring handle the lifecycle of it:
-
-[source,java]
-----
- <camelContext xmlns="http://activemq.apache.org/camel/schema/spring";>
- <template id="template"/>
- </camelContext>
-----
-
-Then you can refer to the ProducerTemplate with the id `template`.
diff --git
a/docs/user-manual/modules/faq/pages/why-does-ftp-component-not-download-any-files.adoc
b/docs/user-manual/modules/faq/pages/why-does-ftp-component-not-download-any-files.adoc
deleted file mode 100644
index 346859b2305e..000000000000
---
a/docs/user-manual/modules/faq/pages/why-does-ftp-component-not-download-any-files.adoc
+++ /dev/null
@@ -1,7 +0,0 @@
-= Why does FTP component not download any files?
-
-The xref:components::ftp-component.adoc[FTP] component has many options. So
make sure you
-have configured it properly.
-Also a common issue is that you have to use either active or passive
-mode. So you may have to set `passiveMode=true` on the endpoint
-configuration.
diff --git
a/docs/user-manual/modules/faq/pages/why-does-maven-not-download-dependencies.adoc
b/docs/user-manual/modules/faq/pages/why-does-maven-not-download-dependencies.adoc
deleted file mode 100644
index 99d677af7bfc..000000000000
---
a/docs/user-manual/modules/faq/pages/why-does-maven-not-download-dependencies.adoc
+++ /dev/null
@@ -1,9 +0,0 @@
-= Why does Maven not download dependencies?
-
-Maven uses HTTP to download its dependencies along with the dependencies
-of the Maven project (such as Camel).
-
-If you run Maven and it fails to download your required dependencies it's
-likely to be caused by your local firewall & HTTP proxy configurations.
-
-See the http://maven.apache.org/guides/mini/guide-proxies.html[Maven
documentation for details of how to configure the HTTP proxy].
diff --git
a/docs/user-manual/modules/faq/pages/why-does-my-jms-route-only-consume-one-message-at-once.adoc
b/docs/user-manual/modules/faq/pages/why-does-my-jms-route-only-consume-one-message-at-once.adoc
deleted file mode 100644
index 9389d3a90b6b..000000000000
---
a/docs/user-manual/modules/faq/pages/why-does-my-jms-route-only-consume-one-message-at-once.adoc
+++ /dev/null
@@ -1,16 +0,0 @@
-= Why does my JMS route only consume one message at once?
-
-The default xref:components::jms-component.adoc[JMS] endpoint configuration
defines
-*concurrentConsumers* to be 1 so only 1 message is processed
-concurrently at any point in time. To change this to make things more
-concurrent, just configure this value; either at the JMS component level
-or endpoint level.
-
-E.g.
-
-[source,java]
-----
-from("activemq:SomeQueue?concurrentConsumers=25").
- bean(SomeCode.class);
-----
-
diff --git
a/docs/user-manual/modules/faq/pages/why-is-my-processor-not-showing-up-in-jconsole.adoc
b/docs/user-manual/modules/faq/pages/why-is-my-processor-not-showing-up-in-jconsole.adoc
deleted file mode 100644
index 15708b3d77e2..000000000000
---
a/docs/user-manual/modules/faq/pages/why-is-my-processor-not-showing-up-in-jconsole.adoc
+++ /dev/null
@@ -1,32 +0,0 @@
-= Why is my processor not showing up in JConsole?
-
-Not every processor is managed, and thus not all are visible in
-JConsole.
-
-A processor must implement the `org.apache.camel.Service` to be managed.
-Most EIP processors do this.
-For example, the minor ones such as `setHeader` do not and thus are not
-visible in JConsole.
-
-From *Camel 2.6* onwards your custom `Processor` should use the Spring
-JMX annotations (for *Camel 2.9* onwards see the tip box below). Just
-add `@ManagedResource` to the class, and the other annotations for the
-attributes and operations. Then Camel will automatically use those when
-the processor is being registered in JMX.
-
-\{snippet:id=e1|lang=java|title=Custom
-processor|url=camel/trunk/camel-core/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java}
-
-The same applies when using beans in your routes.
-
-[source,java]
-----
-include::{examplesdir}/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java[tags=e1]
-----
-
-Camel 2.9 onwards provides Camel's own JMX annotations
-
-Notice that from Camel 2.9 onwards its encouraged to use the
-`@ManagedResource`, `@ManagedAttribute` and `@ManagedOperation` from the
-`org.apache.camel.api.management` package. This allows your custom code
-to not depend on Spring JARs anymore.
diff --git
a/docs/user-manual/modules/faq/pages/why-use-multiple-camelcontext.adoc
b/docs/user-manual/modules/faq/pages/why-use-multiple-camelcontext.adoc
deleted file mode 100644
index 9f2adaab8cb9..000000000000
--- a/docs/user-manual/modules/faq/pages/why-use-multiple-camelcontext.adoc
+++ /dev/null
@@ -1,14 +0,0 @@
-= Why use multiple CamelContext?
-
-In general, you don't tend to want multiple camel contexts in your
-application, if you're running Camel as a standalone Java instance.
-However, if you're deploying Camel routes as OSGi bundles, or WARs in an
-application server, then you can end up having multiple routes being
-deployed, each in it's own, isolated camel context, in the same JVM.
-This makes sense: you want each Camel application to be deployable in
-isolation, in it's own Application Context, and not affected by the
-other Camel applications.
-
-If you want the endpoints or producers in different camel contexts to
-communicate with another, there are a number of solutions. You can use
-xref:components::jms-component.adoc[JMS].
