[14.0.x] ISPN-14324 docs updates and fixes (#10469)

* ISPN-14324 temp remove pipe command

* ISPN-14324 specify jmx roles

* ISPN-14324 fix sql xml example

* ISPN-14324 fix jakarta dependency

documentation/src/main/asciidoc/topics/proc_cli_batching_interactive.adoc

@@ -25,6 +25,8 @@ disconnect
 quit
 ----
 
+////
+
 [TIP]
 ====
 Use [command]`echo` to add commands in interactive mode.
@@ -58,3 +60,4 @@ echo describe|bin/cli.sh -c localhost:11222 -f -
   } ]
 }
 ----
+////

documentation/src/main/asciidoc/topics/proc_enabling_jmx_port.adoc

@@ -17,7 +17,7 @@ You can enable remote JMX ports using one of the following approaches:
 * Enable remote JMX ports manually using the standard Java management configuration options.
 
 .Prerequisites
-* For remote JMX with authentication, define user roles using the default security realm.
+* For remote JMX with authentication, define JMX specific user roles using the default security realm.
 Users must have `controlRole` with read/write access or the `monitorRole` with read-only access to access any JMX resources.
 
 .Procedure

documentation/src/main/asciidoc/topics/upgrading.adoc

@@ -93,14 +93,12 @@ Some modules that have Jakarta based jars are the following (note there are quit
 * infinispan-client-hotrod
 * infinispan-api
 
-If your application requires using the jakarta instead of javax namespace all you need to do is change your maven
-dependency to use the jakarta scope
+If your application requires using the jakarta instead of javax namespace all you need to do is to append your dependencies with `-jakarta`.
 
 ```xml
 <dependency>
    <groupId>org.infinispan</groupId>
-   <artifactId>infinispan-client-hotrod</artifactId>
-   <classifier>jakarta</classifier>
+   <artifactId>infinispan-client-hotrod-jakarta</artifactId>
 </dependency>
 ```
 

documentation/src/main/asciidoc/topics/xml/persistence_sql_query.xml

@@ -1,20 +1,22 @@
 <distributed-cache>
   <persistence>
-    <connection-pool connection-url=""/>
     <query-jdbc-store xmlns="urn:infinispan:config:store:sql:{schemaversion}"
                       dialect="POSTGRES"
-                      shared="true">
-      <queries key-columns="name">
-        <select-single>SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name WHERE t1.name = :name</select-single>
-        <select-all>SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name</select-all>
-        <delete-single>DELETE FROM Person t1 WHERE t1.name = :name; DELETE FROM Address t2 where t2.name = :name</delete-single>
-        <delete-all>DELETE FROM Person; DELETE FROM Address</delete-all>
-        <upsert>INSERT INTO Person (name,  picture, sex, birthdate, accepted_tos) VALUES (:name, :picture, :sex, :birthdate, :accepted_tos); INSERT INTO Address(name, street, city, zip) VALUES (:name, :street, :city, :zip)</upsert>
-        <size>SELECT COUNT(*) FROM Person</size>
-      </queries>
+                      shared="true" key-columns="name">
+          <connection-pool driver="org.postgresql.Driver"
+                            connection-url="jdbc:postgresql://localhost:5432/postgres"
+                            username="postgres"
+                            password="changeme"/>
+      <queries select-single="SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name WHERE t1.name = :name"
+        select-all="SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name"
+        delete-single="DELETE FROM Person t1 WHERE t1.name = :name; DELETE FROM Address t2 where t2.name = :name"
+        delete-all="DELETE FROM Person; DELETE FROM Address"
+        upsert="INSERT INTO Person (name,  picture, sex, birthdate, accepted_tos) VALUES (:name, :picture, :sex, :birthdate, :accepted_tos); INSERT INTO Address(name, street, city, zip) VALUES (:name, :street, :city, :zip)"
+        size="SELECT COUNT(*) FROM Person"
+      />
       <schema message-name="Person"
               package="com.example"
               embedded-key="true"/>
     </query-jdbc-store>
   </persistence>
-<distributed-cache>
+</distributed-cache>