From 5fe9e0ddd87c33508e26db1445bb4de36eaac63b Mon Sep 17 00:00:00 2001
From: Ihor Didyk <ihordidyk95@gmail.com>
Date: Tue, 25 Nov 2025 19:23:10 +0200
Subject: [PATCH] docs: requirements file support for maven plugin

---
 docs/user/Embedding-Build-Tools.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/user/Embedding-Build-Tools.md b/docs/user/Embedding-Build-Tools.md
index e7d1acf12b..10b2f473e7 100644
--- a/docs/user/Embedding-Build-Tools.md
+++ b/docs/user/Embedding-Build-Tools.md
@@ -148,6 +148,19 @@ The Python packages and their versions are specified as if used with `pip`:
       ...
   </configuration>
   ```
+- The **requirementsFile** element declares a path to a `pip`-compatible requirements file with third-party Python packages to be downloaded and installed by the plugin. <br/>Each line in the file is interpreted the same way as by `pip install -r`:
+
+  ```xml
+  <configuration>
+      <requirementsFile>requirements.txt</requirementsFile>
+      ...
+  </configuration>
+  ```
+
+  > **_NOTE:_**
+  > Exactly one of `packages` or `requirementsFile` must be configured.
+  > If both are present at the same time, the build will fail with a configuration error.
+
 
 - The **resourceDirectory** element can specify the relative [Java resource path](#java-resource-path).
   Remember to use `VirtualFileSystem$Builder#resourceDirectory` when configuring the `VirtualFileSystem` in Java.