docs(15.10): note the libraries removed from WEB-INF/lib for plugin developers

de/15.10/install/upgrade.rst

@@ -732,6 +732,12 @@ Die folgenden Änderungen betreffen Plugins, die Klassen von ``fess-crawler`` ve
 - ``TikaExtractor.setTikaConfig`` und die Komponente ``tikaConfig`` in ``fess.xml`` wurden entfernt.
 - Bei der Log-Stufe ``debug`` übergibt ``CrawlJob`` dem Crawler nicht mehr ``-Dorg.apache.tika.service.error.warn=true``, weil Tika 4 diese Eigenschaft nicht liest.
 
+Das ``WEB-INF/lib`` von 15.10 enthält außerdem die folgenden Bibliotheken nicht mehr, die 15.9 noch auslieferte. Die Tika-3-Module hatten sie eingebunden; die Tika-4-Module, die 15.10 verwendet, hängen nicht von ihnen ab. Keine Klasse der 15.10-WAR verweist auf sie.
+
+- Entfernt wurden JAXB (``jakarta.xml.bind-api``, ``jaxb-core``, ``jaxb-runtime``, ``txw2`` und ``istack-commons-runtime``), ``jempbox``, ``xmpbox`` und ``juniversalchardet``. ``jakarta.activation-api`` und ``angus-activation`` sind weiterhin enthalten.
+- Verwendet Ihr Plugin Klassen dieser Bibliotheken, nehmen Sie die Bibliotheken in die Plugin-JAR auf (zum Beispiel mit dem Maven Shade Plugin). Ein Plugin kann sich auf Klassen verlassen, die die WAR bereitstellt, aber nicht auf Klassen eines anderen Plugins, und die 15.10-WAR stellt diese nicht mehr bereit. Klassen in ``WEB-INF/lib`` werden vor denen in ``WEB-INF/plugin`` aufgelöst, daher entstehen keine Duplikate, wenn Sie eine Bibliothek aufnehmen, die die WAR nicht enthält.
+- Ob ein Plugin betroffen ist, prüfen Sie, indem Sie nachsehen, ob die benötigten Klassen in den JARs des ``WEB-INF/lib`` von 15.10 enthalten sind. Ein Codepfad, der eine entfernte Klasse verwendet, schlägt zur Laufzeit fehl, zum Beispiel mit ``NoClassDefFoundError``; Codepfade, die diese Klassen nicht verwenden, sind nicht betroffen.
+
 Für 15.9 gebaute Plugins
 ------------------------
 

en/15.10/install/upgrade.rst

@@ -718,6 +718,12 @@ The following changes affect plugins that use classes of ``fess-crawler``. Rebui
 - ``TikaExtractor.setTikaConfig`` and the ``tikaConfig`` component of ``fess.xml`` were removed.
 - At the ``debug`` log level, ``CrawlJob`` no longer passes ``-Dorg.apache.tika.service.error.warn=true`` to the crawler, because Tika 4 does not read it.
 
+The 15.10 ``WEB-INF/lib`` also no longer contains the following libraries, which 15.9 shipped. The Tika 3 modules brought them in, and the Tika 4 modules that 15.10 uses do not depend on them. No class in the 15.10 WAR refers to them.
+
+- The removed libraries are JAXB (``jakarta.xml.bind-api``, ``jaxb-core``, ``jaxb-runtime``, ``txw2`` and ``istack-commons-runtime``), ``jempbox``, ``xmpbox`` and ``juniversalchardet``. ``jakarta.activation-api`` and ``angus-activation`` are still included.
+- If your plugin uses classes of these libraries, include the libraries in the plugin JAR (for example, with the Maven Shade Plugin). A plugin can rely on classes that the WAR provides, but not on classes of another plugin, and the 15.10 WAR no longer provides these. Classes in ``WEB-INF/lib`` are resolved before those in ``WEB-INF/plugin``, so including a library that the WAR does not contain causes no duplication.
+- To check whether a plugin is affected, see whether the classes it needs are in the JARs of the 15.10 ``WEB-INF/lib``. A code path that uses a removed class fails at run time, for example with ``NoClassDefFoundError``; code paths that do not use these classes are not affected.
+
 Plugins Built for 15.9
 ----------------------
 

es/15.10/install/upgrade.rst

@@ -729,6 +729,12 @@ Los cambios siguientes afectan a los plugins que usan clases de ``fess-crawler``
 - Se eliminaron ``TikaExtractor.setTikaConfig`` y el componente ``tikaConfig`` de ``fess.xml``.
 - Con el nivel de registro ``debug``, ``CrawlJob`` ya no pasa ``-Dorg.apache.tika.service.error.warn=true`` al rastreador, porque Tika 4 no lee esa propiedad.
 
+El ``WEB-INF/lib`` de la versión 15.10 tampoco contiene ya las bibliotecas siguientes, que la versión 15.9 incluía. Las aportaban los módulos de Tika 3; los módulos de Tika 4 que usa la versión 15.10 no dependen de ellas. Ninguna clase del WAR de la versión 15.10 hace referencia a ellas.
+
+- Las bibliotecas retiradas son JAXB (``jakarta.xml.bind-api``, ``jaxb-core``, ``jaxb-runtime``, ``txw2`` e ``istack-commons-runtime``), ``jempbox``, ``xmpbox`` y ``juniversalchardet``. ``jakarta.activation-api`` y ``angus-activation`` se siguen incluyendo.
+- Si su plugin usa clases de estas bibliotecas, inclúyalas en el JAR del plugin (por ejemplo, con el Maven Shade Plugin). Un plugin puede depender de las clases que proporciona el WAR, pero no de las de otro plugin, y el WAR de la versión 15.10 ya no proporciona estas. Las clases de ``WEB-INF/lib`` se resuelven antes que las de ``WEB-INF/plugin``, por lo que incluir una biblioteca que el WAR no contiene no genera duplicados.
+- Para saber si un plugin está afectado, compruebe si las clases que necesita están en los JAR de ``WEB-INF/lib`` de la versión 15.10. Un procesamiento que use una clase retirada falla en tiempo de ejecución, por ejemplo con ``NoClassDefFoundError``; los que no usan esas clases no se ven afectados.
+
 Plugins compilados para la versión 15.9
 ---------------------------------------
 

fr/15.10/install/upgrade.rst

@@ -735,6 +735,12 @@ Les modifications suivantes concernent les plugins qui utilisent des classes de
 - ``TikaExtractor.setTikaConfig`` et le composant ``tikaConfig`` de ``fess.xml`` ont été supprimés.
 - Au niveau de journalisation ``debug``, ``CrawlJob`` ne transmet plus ``-Dorg.apache.tika.service.error.warn=true`` au crawler, car Tika 4 ne lit plus cette propriété.
 
+Le ``WEB-INF/lib`` de la version 15.10 ne contient plus non plus les bibliothèques suivantes, que la version 15.9 fournissait. Les modules Tika 3 les apportaient ; les modules Tika 4 utilisés par la version 15.10 n'en dépendent pas. Aucune classe du WAR de la version 15.10 n'y fait référence.
+
+- Les bibliothèques retirées sont JAXB (``jakarta.xml.bind-api``, ``jaxb-core``, ``jaxb-runtime``, ``txw2`` et ``istack-commons-runtime``), ``jempbox``, ``xmpbox`` et ``juniversalchardet``. ``jakarta.activation-api`` et ``angus-activation`` sont toujours incluses.
+- Si votre plugin utilise des classes de ces bibliothèques, incluez-les dans le JAR du plugin (par exemple avec le Maven Shade Plugin). Un plugin peut s'appuyer sur les classes fournies par le WAR, mais pas sur celles d'un autre plugin, et le WAR de la version 15.10 ne fournit plus celles-ci. Les classes de ``WEB-INF/lib`` sont résolues avant celles de ``WEB-INF/plugin`` : inclure une bibliothèque que le WAR ne contient pas ne crée donc aucun doublon.
+- Pour savoir si un plugin est concerné, vérifiez si les classes dont il a besoin figurent dans les JAR du ``WEB-INF/lib`` de la version 15.10. Un traitement qui utilise une classe retirée échoue à l'exécution, par exemple avec ``NoClassDefFoundError`` ; les traitements qui n'utilisent pas ces classes ne sont pas concernés.
+
 Plugins construits pour la version 15.9
 ---------------------------------------
 

ja/15.10/install/upgrade.rst

@@ -708,6 +708,12 @@ cipher を設定していない場合のリクエストのロール
 - ``TikaExtractor.setTikaConfig`` と、``fess.xml`` の ``tikaConfig`` コンポーネントを削除しました。
 - ログレベルが ``debug`` のとき、``CrawlJob`` はクローラーに ``-Dorg.apache.tika.service.error.warn=true`` を渡さなくなりました。Tika 4 がこの値を読まないためです。
 
+15.10 の ``WEB-INF/lib`` には、15.9 に含まれていた次のライブラリも含まれなくなりました。これらは Tika 3 のモジュールが引き込んでいたもので、15.10 が使う Tika 4 のモジュールは依存していません。15.10 の WAR のクラスはこれらを参照していません。
+
+- 含まれなくなったライブラリは、JAXB（``jakarta.xml.bind-api``、``jaxb-core``、``jaxb-runtime``、``txw2``、``istack-commons-runtime``）、``jempbox``、``xmpbox``、``juniversalchardet`` です。``jakarta.activation-api`` と ``angus-activation`` は引き続き含まれます。
+- プラグインがこれらのライブラリのクラスを使う場合は、ライブラリをプラグインの JAR に含めてください（たとえば Maven Shade Plugin で同梱します）。プラグインは WAR が提供するクラスには依存できますが、他のプラグインのクラスには依存できず、15.10 の WAR はこれらを提供しません。``WEB-INF/lib`` のクラスは ``WEB-INF/plugin`` のクラスより先に解決されるため、WAR に無いライブラリを同梱しても重複しません。
+- プラグインが影響を受けるかどうかは、必要とするクラスが 15.10 の ``WEB-INF/lib`` の JAR に含まれているかで確認できます。削除されたクラスを使う処理は、たとえば ``NoClassDefFoundError`` で実行時に失敗します。これらのクラスを使わない処理には影響しません。
+
 15.9 向けにビルドされたプラグイン
 ---------------------------------
 

ko/15.10/install/upgrade.rst

@@ -708,6 +708,12 @@ cipher가 없을 때 요청으로 전달되는 롤
 - ``TikaExtractor.setTikaConfig`` 와 ``fess.xml`` 의 ``tikaConfig`` 컴포넌트가 삭제되었습니다.
 - 로그 레벨이 ``debug`` 일 때 ``CrawlJob`` 은 크롤러에 ``-Dorg.apache.tika.service.error.warn=true`` 를 전달하지 않습니다. Tika 4가 이 값을 읽지 않기 때문입니다.
 
+15.10 의 ``WEB-INF/lib`` 에는 15.9 에 포함되어 있던 다음 라이브러리도 더 이상 들어 있지 않습니다. 이 라이브러리들은 Tika 3 의 모듈이 가져오던 것이며, 15.10 이 사용하는 Tika 4 의 모듈은 이를 의존하지 않습니다. 15.10 의 WAR 에 있는 어떤 클래스도 이 라이브러리를 참조하지 않습니다.
+
+- 더 이상 들어 있지 않은 라이브러리는 JAXB(``jakarta.xml.bind-api``, ``jaxb-core``, ``jaxb-runtime``, ``txw2``, ``istack-commons-runtime``)와 ``jempbox``, ``xmpbox``, ``juniversalchardet`` 입니다. ``jakarta.activation-api`` 와 ``angus-activation`` 은 그대로 포함됩니다.
+- 플러그인이 이 라이브러리의 클래스를 사용한다면 라이브러리를 플러그인의 JAR 에 포함시키십시오(예: Maven Shade Plugin 사용). 플러그인은 WAR 가 제공하는 클래스에는 의존할 수 있지만 다른 플러그인의 클래스에는 의존할 수 없으며, 15.10 의 WAR 는 더 이상 이 클래스를 제공하지 않습니다. ``WEB-INF/lib`` 의 클래스가 ``WEB-INF/plugin`` 의 클래스보다 먼저 해석되므로, WAR 에 없는 라이브러리를 포함해도 중복되지 않습니다.
+- 플러그인이 영향을 받는지는 필요한 클래스가 15.10 의 ``WEB-INF/lib`` JAR 에 있는지로 확인할 수 있습니다. 제거된 클래스를 사용하는 처리는 실행 시 예를 들어 ``NoClassDefFoundError`` 로 실패하며, 이 클래스를 사용하지 않는 처리는 영향을 받지 않습니다.
+
 15.9용으로 빌드된 플러그인
 --------------------------
 

zh-cn/15.10/install/upgrade.rst

@@ -696,6 +696,12 @@ LDAP 的角色 OU 与嵌套组
 - 已删除 ``TikaExtractor.setTikaConfig`` 和 ``fess.xml`` 中的 ``tikaConfig`` 组件。
 - 日志级别为 ``debug`` 时，``CrawlJob`` 不再向爬虫传递 ``-Dorg.apache.tika.service.error.warn=true``，因为 Tika 4 不再读取该属性。
 
+15.10 的 ``WEB-INF/lib`` 中也不再包含以下 15.9 随附的库。它们原先由 Tika 3 的模块引入，而 15.10 使用的 Tika 4 模块不再依赖它们。15.10 的 WAR 中没有任何类引用它们。
+
+- 不再包含的库有 JAXB（``jakarta.xml.bind-api``、``jaxb-core``、``jaxb-runtime``、``txw2``、``istack-commons-runtime``）、``jempbox``、``xmpbox`` 和 ``juniversalchardet``。``jakarta.activation-api`` 和 ``angus-activation`` 仍然包含。
+- 如果插件使用这些库中的类，请将这些库包含在插件的 JAR 中（例如使用 Maven Shade Plugin 打包）。插件可以依赖 WAR 提供的类，但不能依赖其他插件的类，而 15.10 的 WAR 不再提供这些类。``WEB-INF/lib`` 中的类先于 ``WEB-INF/plugin`` 中的类解析，因此包含 WAR 中没有的库不会产生重复。
+- 插件是否受影响，可以通过它所需的类是否存在于 15.10 的 ``WEB-INF/lib`` 的 JAR 中来确认。使用已移除类的处理会在运行时失败，例如抛出 ``NoClassDefFoundError``；不使用这些类的处理不受影响。
+
 为 15.9 构建的插件
 ------------------