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 da68704476e2 CAMEL-24894: docs - add the camel-docling output path
note to the 4.22 and 4.18 upgrade guides (#27368)
da68704476e2 is described below
commit da68704476e222210099f4b3bfc4e7bc6909a637
Author: Claus Ibsen <[email protected]>
AuthorDate: Mon Oct 5 10:25:30 2026 +0200
CAMEL-24894: docs - add the camel-docling output path note to the 4.22 and
4.18 upgrade guides (#27368)
The fix was backported to camel-4.22.x (#27365) and camel-4.18.x (#27362),
which added the upgrade note to their own guides. Sync the note into the
4.22.2 and 4.18.5 sections of the guides on main.
Signed-off-by: Claus Ibsen <[email protected]>
Co-authored-by: Claude Opus 5.5 (1M context) <[email protected]>
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 6 ++++++
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 8 ++++++++
2 files changed, 14 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index a0e136bbf307..2a12fb0deede 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -111,6 +111,12 @@ Additionally, a local input path that does not exist is
now reported as a `File
before Docling is invoked. Previously the size check silently skipped a path
that resolved to nothing and
the failure surfaced later, from the Docling process or API call.
+The `CamelDoclingOutputFilePath` header, which selects the CLI output
directory, is now normalized lexically
+(redundant separators and `.`/`..` segments are resolved) before it is passed
to Docling; a header value
+without such segments is still used as given. A new `outputBaseDirectory`
option additionally confines the
+header the same way `inputBaseDirectory` confines input paths - when set, an
output path that resolves outside
+it, including an absolute path, is rejected with an `IOException`.
`outputBaseDirectory` is unset by default.
+
=== camel-dynamic-router
The `dynamic-router-control` endpoint no longer takes the subscription
`predicate`, or the
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index e94b8d4219ae..2e067dde8f0f 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -183,6 +183,14 @@ coap://0.0.0.0:5683/my/resource?muteException=false
For the Rest DSL, set it with
`restConfiguration().endpointProperty("muteException", "false")`.
+=== camel-docling - output path handling
+
+The `CamelDoclingOutputFilePath` header, which selects the CLI output
directory, is now normalized lexically
+(redundant separators and `.`/`..` segments are resolved) before it is passed
to Docling; a header value
+without such segments is still used as given. A new `outputBaseDirectory`
option additionally confines the
+header the same way `inputBaseDirectory` confines input paths - when set, an
output path that resolves outside
+it, including an absolute path, is rejected with an `IOException`.
`outputBaseDirectory` is unset by default.
+
== Upgrading from 4.22.0 to 4.22.1
=== camel-docling
