From ba0ef5a5ef3c682f85c3184a12fc3b9f5325a281 Mon Sep 17 00:00:00 2001
From: Koen Aers <koen.aers@gmail.com>
Date: Tue, 6 May 2025 14:28:36 +0200
Subject: [PATCH] HBX-2984: Create Reference Guide for Ant   - Add the
 information for the '<classpath>' configuration

Signed-off-by: Koen Aers <koen.aers@gmail.com>
---
 ant/docs/examples/classpath/build.xml |  4 +---
 ant/docs/reference-guide.md           | 18 +++++++++++++++---
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/ant/docs/examples/classpath/build.xml b/ant/docs/examples/classpath/build.xml
index 02a349afc2..6b575617a6 100644
--- a/ant/docs/examples/classpath/build.xml
+++ b/ant/docs/examples/classpath/build.xml
@@ -36,9 +36,7 @@
   <target name="reveng" depends="compile">
     <hibernatetool destdir="generated-sources">
       <!-- The classpath to be used by the 'hibernatetool' task to look up additional classes or resources -->
-      <classpath>
-        <pathelement location="additional/classes"/>
-      </classpath>
+      <classpath location="additional/classes"/>
       <!-- Dummy configuration, as it is needed for any 'hibernatetool' task -->
       <configuration />
       <!-- Custom exporter of class 'HelloExporter' to be found on the specified classpath -->
diff --git a/ant/docs/reference-guide.md b/ant/docs/reference-guide.md
index e4b5b89212..7a3872c9bf 100644
--- a/ant/docs/reference-guide.md
+++ b/ant/docs/reference-guide.md
@@ -77,7 +77,7 @@ and nested elements.
 
 Let's walk through the different possibilities.
 
-#### 1.2.1 The 'destdir' Attribute
+#### 1.2.1 The `destdir` Attribute
 
 This mandatory attribute lets you control the folder where the artefacts will be generated. If the 
 specified folder does not exist it will be created.
@@ -90,7 +90,7 @@ specified folder does not exist it will be created.
 In the snippet above the artefacts will be generated in the subfolder `path/to/generated/sources` of 
 the working directory.
 
-#### 1.2.2 The 'templatepath' Attribute
+#### 1.2.2 The `templatepath` Attribute
 
 The generation of artefacts is based on FreeMarker templates. By default, the templates are 
 looked up on the classpath. If you want to have fine control over the artefact generation
@@ -106,10 +106,22 @@ location of those templates.
 ```
 
 
-#### 1.2.3 The 'classpath' Element
+#### 1.2.3 The `<classpath>` Element
 
+The `<classpath>` element can be added within the `<hiberatetool>` task to specify where to look
+for classes and/or resources that are used e.g. by the configured exporters. 
 
+```xml
+<hibernatetool 
+        destdir="...">
+    <classpath location="location/of/additional/classes"/>
+    ...
+</hibernatetool>
+
+```
 
+All the usual configuration possibilities for [Ant path-like structures](https://ant.apache.org/manual/using.html#path) 
+are applicable. 
 
 ## 2. The Hibernate Tools Configurations