WIP Prepare chunk documentation

v2.0/Developer_manuals/BaseX_ETS.adoc

@@ -565,6 +565,17 @@ Once the listener is implemented, the whole generation of the
 `etf:TestTaskResult` document will be done by the ETF test driver.
 ======================================
 
+[[the-prepare-chunk-document]]
+=== The prepare-chunk document
+A prepare-chunk.xq document is optional but can be used to preprocess testdata.
+
+Example usage: Prepare a spatial index and extract all objects with erroneous geometry before executing the tests.
+[NOTE]
+======================================
+* For every given chunk, prepare-chunk.xq will be executed.
+* The name of the chunk is passed to the document through the variable `$dbName`.
+======================================
+
 [[spatial-tests]]
 === Testing spatial aspects
 

v2.0/Developer_manuals/BaseX_ETS_GUI.adoc

@@ -60,6 +60,13 @@ declare variable $etsFile external := $projDir || file:dir-separator() || "ets-t
 
 Executing the XQuery should now execute the test suite.
 
+There are additional steps, in case the testproject uses a prepare-chunk document (see link:#the-prepare-chunk-document[below] for more information):
+
+* Set the external variable `$dbName` to the name of your database in BaseX.
+* Open and run the prepare-chunk document.
+
+Executing the XQuery document should now execute the test suite.
+
 ==== Best practices
 
 During the development of a test suite, it may be handy to compile a

v2.0/Developer_manuals/Developing_Executable_Test_Suites.adoc

@@ -42,6 +42,7 @@ include::../General/Document-metadata.adoc[]
 | 2017-11-25 | Jon Herrmann | Spatial indexing section updated
 | 2017-12-06 | Jon Herrmann | Message template bundles section updated
 | 2018-07-10 | Jon Herrmann | Links updated
+| 2020-05-06 | Christoph Spalek | Add prepare-chunk section
 |===