From 3ef55caa1e6fa94085a41ec9a765a0ce66f537e0 Mon Sep 17 00:00:00 2001
From: Norman Walsh <ndw@nwalsh.com>
Date: Tue, 12 Aug 2025 09:40:03 +0100
Subject: [PATCH] Add namespace declarations to the JavaDoc comments

The documentation for POSTing queries to the REST API says very little about how
external variables should be bound. The comments in this file are helpful, but
only if you know the namespace declarations!
---
 .../src/main/java/org/exist/http/RESTServerParameter.java    | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/exist-core/src/main/java/org/exist/http/RESTServerParameter.java b/exist-core/src/main/java/org/exist/http/RESTServerParameter.java
index 0cf607c1f0..d4e23166cb 100644
--- a/exist-core/src/main/java/org/exist/http/RESTServerParameter.java
+++ b/exist-core/src/main/java/org/exist/http/RESTServerParameter.java
@@ -66,7 +66,8 @@ enum RESTServerParameter {
      * The value of this parameter used in the body of POST requests
      * has the following format:
      * 
-     * <exist:query start? = number
+     * <exist:query xmlns:exist="http://exist.sourceforge.net/NS/exist"
+     *  start? = number
      *  max? = number
      *  cache? = ("yes" | "no")
      *  session? = string
@@ -117,7 +118,7 @@ enum RESTServerParameter {
      *       exist:namespace?)
      *  </exist:qname>
      * 
-     *  <sx:sequence>
+     *  <sx:sequence xmlns:sx="http://exist-db.org/xquery/types/serialized">
      *      (sx:value+)
      *  </sx:sequence>
      *