From 2f145a5c63b3c18030c0d7d64063049f4f2f0906 Mon Sep 17 00:00:00 2001
From: Eric Bischoff <ebischoff@suse.com>
Date: Sat, 16 Nov 2024 14:12:35 +0100
Subject: [PATCH 1/2] Fix list indentation

Signed-off-by: Eric Bischoff <ebischoff@suse.com>
---
 doc/source/setuphttpd.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/source/setuphttpd.rst b/doc/source/setuphttpd.rst
index f4676d869..600b5fb66 100644
--- a/doc/source/setuphttpd.rst
+++ b/doc/source/setuphttpd.rst
@@ -23,6 +23,7 @@ or directly connected via Apache's wsgi module.
 The detailed setup steps for each type of web server is out of this document's range,
 you can refer to the specific guide of your chosen web server. This guide walks you through
 the deployment process, either:
+
  * with premade packages (which use the mod_wsgi method);
  * manually, with uwsgi;
  * or manually, with Apache's mod_wsgi.

From 1f9ed4fe535e444df6086943bedaf911bd57982b Mon Sep 17 00:00:00 2001
From: Eric Bischoff <ebischoff@suse.com>
Date: Sat, 16 Nov 2024 14:13:10 +0100
Subject: [PATCH 2/2] Add a "Volume(s)" section to API documentation

Signed-off-by: Eric Bischoff <ebischoff@suse.com>
---
 doc/source/restapi.rst | 216 +++++++++++++++++++++--------------------
 1 file changed, 110 insertions(+), 106 deletions(-)

diff --git a/doc/source/restapi.rst b/doc/source/restapi.rst
index f4f936a5e..917b66786 100644
--- a/doc/source/restapi.rst
+++ b/doc/source/restapi.rst
@@ -431,112 +431,6 @@ Detach volume from a vm in z/VM
 
   No Response
 
-Refresh Volume Bootmap Info
----------------------------
-
-**PUT /volumes/volume_refresh_bootmap**
-
-Refresh a volume's bootmap info.
-
-* Request:
-
-.. restapi_parameters:: parameters.yaml
-
-  - fcpchannel: fcp_list
-  - wwpn: wwpn_list
-  - lun: lun
-  - transportfiles: transportfiles
-  - guest_networks: guest_networks
-
-* Request sample:
-
-.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_refresh_bootmap.tpl
-   :language: javascript
-
-* Response code:
-
-  HTTP status code 200 on success.
-
-* Response contents:
-
-.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_refresh_bootmap_response.tpl
-   :language: javascript
-
-Get Volume Connector
---------------------
-
-**GET /volumes/conn/{userid}**
-
-Get volume connector for z/VM.
-
-* Request:
-
-.. restapi_parameters:: parameters.yaml
-
-  - userid: guest_userid
-  - reserve: fcp_reserve
-
-* Response code:
-
-  HTTP status code 200 on success.
-
-* Response sample:
-
-.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_get_volume_connector.tpl
-   :language: javascript
-
-Get FCP Usage
---------------------
-
-**GET /volumes/fcp/{fcp_id}**
-
-Get the FCP usage in database for z/VM.
-
-* Request:
-
-.. restapi_parameters:: parameters.yaml
-
-  - fcp_id: fcp_id
-
-* Response code:
-
-  HTTP status code 200 on success.
-
-* Response contents:
-
-.. restapi_parameters:: parameters.yaml
-
-  - output: fcp_usage
-
-* Response sample:
-
-.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_get_fcp_usage.tpl
-
-Set FCP Usage
---------------------
-
-**PUT /volumes/fcp/{fcp_id}**
-
-Set the FCP usage in database for z/VM.
-
-* Request:
-
-.. restapi_parameters:: parameters.yaml
-
-  - fcp_id: fcp_id
-  - userid: fcp_userid
-  - reserved: fcp_reserve
-  - connections: fcp_connections
-
-* Response code:
-
-  HTTP status code 200 on success.
-
-* Response contents:
-
-  No response.
-
-
 Get Guests stats including cpu and memory
 -----------------------------------------
 
@@ -2076,6 +1970,116 @@ Delete a vswitch by using given name.
 
   No response.
 
+Volume(s)
+=========
+
+Handling of volumes and FCP devices.
+
+Refresh Volume Bootmap Info
+---------------------------
+
+**PUT /volumes/volume_refresh_bootmap**
+
+Refresh a volume's bootmap info.
+
+* Request:
+
+.. restapi_parameters:: parameters.yaml
+
+  - fcpchannel: fcp_list
+  - wwpn: wwpn_list
+  - lun: lun
+  - transportfiles: transportfiles
+  - guest_networks: guest_networks
+
+* Request sample:
+
+.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_refresh_bootmap.tpl
+   :language: javascript
+
+* Response code:
+
+  HTTP status code 200 on success.
+
+* Response contents:
+
+.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_refresh_bootmap_response.tpl
+   :language: javascript
+
+Get Volume Connector
+--------------------
+
+**GET /volumes/conn/{userid}**
+
+Get volume connector for z/VM.
+
+* Request:
+
+.. restapi_parameters:: parameters.yaml
+
+  - userid: guest_userid
+  - reserve: fcp_reserve
+
+* Response code:
+
+  HTTP status code 200 on success.
+
+* Response sample:
+
+.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_get_volume_connector.tpl
+   :language: javascript
+
+Get FCP Usage
+--------------------
+
+**GET /volumes/fcp/{fcp_id}**
+
+Get the FCP usage in database for z/VM.
+
+* Request:
+
+.. restapi_parameters:: parameters.yaml
+
+  - fcp_id: fcp_id
+
+* Response code:
+
+  HTTP status code 200 on success.
+
+* Response contents:
+
+.. restapi_parameters:: parameters.yaml
+
+  - output: fcp_usage
+
+* Response sample:
+
+.. literalinclude:: ../../zvmsdk/tests/fvt/api_templates/test_get_fcp_usage.tpl
+
+Set FCP Usage
+-------------
+
+**PUT /volumes/fcp/{fcp_id}**
+
+Set the FCP usage in database for z/VM.
+
+* Request:
+
+.. restapi_parameters:: parameters.yaml
+
+  - fcp_id: fcp_id
+  - userid: fcp_userid
+  - reserved: fcp_reserve
+  - connections: fcp_connections
+
+* Response code:
+
+  HTTP status code 200 on success.
+
+* Response contents:
+
+  No response.
+
 Files
 =====
 Imports and exports raw file data.