remove unused descriptions from api macros

these are now a hard error in the api macro

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

src/api2/access/user.rs

@@ -249,10 +249,7 @@ pub fn create_user(password: Option<String>, param: Value) -> Result<(), Error>
             },
          },
     },
-    returns: {
+    returns: { type: user::User },
-        description: "The user configuration (with config digest).",
-        type: user::User,
-    },
     access: {
         permission: &Permission::Or(&[
             &Permission::Privilege(&["access", "users"], PRIV_SYS_AUDIT, false),
@@ -468,10 +465,7 @@ pub fn delete_user(userid: Userid, digest: Option<String>) -> Result<(), Error>
             },
         },
     },
-    returns: {
+    returns: { type: user::ApiToken },
-        description: "Get API token metadata (with config digest).",
-        type: user::ApiToken,
-    },
     access: {
         permission: &Permission::Or(&[
             &Permission::Privilege(&["access", "users"], PRIV_SYS_AUDIT, false),

src/api2/admin/datastore.rs

@@ -975,10 +975,7 @@ pub fn garbage_collection_status(
     returns: {
         description: "List the accessible datastores.",
         type: Array,
-        items: {
+        items: { type: DataStoreListItem },
-            description: "Datastore name and description.",
-            type: DataStoreListItem,
-        },
     },
     access: {
         permission: &Permission::Anybody,

src/api2/config/datastore.rs

@@ -151,10 +151,7 @@ pub fn create_datastore(param: Value) -> Result<(), Error> {
             },
         },
     },
-    returns: {
+    returns: { type: datastore::DataStoreConfig },
-        description: "The datastore configuration (with config digest).",
-        type: datastore::DataStoreConfig,
-    },
     access: {
         permission: &Permission::Privilege(&["datastore", "{name}"], PRIV_DATASTORE_AUDIT, false),
     },

src/api2/config/remote.rs

@@ -19,10 +19,7 @@ use crate::config::acl::{PRIV_REMOTE_AUDIT, PRIV_REMOTE_MODIFY};
     returns: {
         description: "The list of configured remotes (with config digest).",
         type: Array,
-        items: {
+        items: { type: remote::Remote },
-            type: remote::Remote,
-            description: "Remote configuration (without password).",
-        },
     },
     access: {
         description: "List configured remotes filtered by Remote.Audit privileges",
@@ -124,10 +121,7 @@ pub fn create_remote(password: String, param: Value) -> Result<(), Error> {
             },
         },
     },
-    returns: {
+    returns: { type: remote::Remote },
-        description: "The remote configuration (with config digest).",
-        type: remote::Remote,
-    },
     access: {
         permission: &Permission::Privilege(&["remote", "{name}"], PRIV_REMOTE_AUDIT, false),
     }
@@ -347,10 +341,7 @@ pub async fn remote_client(remote: remote::Remote) -> Result<HttpClient, Error>
     returns: {
         description: "List the accessible datastores.",
         type: Array,
-        items: {
+        items: { type: DataStoreListItem },
-            description: "Datastore name and description.",
-            type: DataStoreListItem,
-        },
     },
 )]
 /// List datastores of a remote.cfg entry

src/api2/config/sync.rs

@@ -182,10 +182,7 @@ pub fn create_sync_job(
             },
         },
     },
-    returns: {
+    returns: { type: sync::SyncJobConfig },
-        description: "The sync job configuration.",
-        type: sync::SyncJobConfig,
-    },
     access: {
         description: "Limited to sync job entries where user has Datastore.Audit on target datastore, and Remote.Audit on source remote.",
         permission: &Permission::Anybody,

src/api2/config/verify.rs

@@ -127,10 +127,7 @@ pub fn create_verification_job(
             },
         },
     },
-    returns: {
+    returns: { type: verify::VerificationJobConfig },
-        description: "The verification job configuration.",
-        type: verify::VerificationJobConfig,
-    },
     access: {
         permission: &Permission::Anybody,
         description: "Requires Datastore.Audit or Datastore.Verify on job's datastore.",

src/api2/node/network.rs

@@ -102,10 +102,7 @@ pub fn list_network_devices(
             },
         },
     },
-    returns: {
+    returns: { type: Interface },
-        description: "The network interface configuration (with config digest).",
-        type: Interface,
-    },
     access: {
         permission: &Permission::Privilege(&["system", "network", "interfaces", "{name}"], PRIV_SYS_AUDIT, false),
     },
@@ -135,7 +132,6 @@ pub fn read_interface(iface: String) -> Result<Value, Error> {
                 schema: NETWORK_INTERFACE_NAME_SCHEMA,
             },
             "type": {
-                description: "Interface type.",
                 type: NetworkInterfaceType,
                 optional: true,
             },
@@ -388,7 +384,6 @@ pub enum DeletableProperty {
                 schema: NETWORK_INTERFACE_NAME_SCHEMA,
             },
             "type": {
-                description: "Interface type. If specified, need to match the current type.",
                 type: NetworkInterfaceType,
                 optional: true,
             },

src/api2/node/subscription.rs

@@ -73,10 +73,7 @@ pub fn check_subscription(
             },
         },
     },
-    returns: {
+    returns: { type: SubscriptionInfo },
-        description: "Subscription status.",
-        type: SubscriptionInfo,
-    },
     access: {
         permission: &Permission::Anybody,
     },

src/api2/node/tasks.rs

@@ -166,7 +166,6 @@ fn check_task_access(auth_id: &Authid, upid: &UPID) -> Result<(), Error> {
             },
             user: {
                 type: Userid,
-                description: "The user who started the task.",
             },
             tokenid: {
                 type: Tokenname,

src/bin/proxmox_backup_client/key.rs

@@ -372,7 +372,6 @@ fn create_master_key() -> Result<(), Error> {
             },
             "output-format": {
                 type: PaperkeyFormat,
-                description: "Output format. Text or Html.",
                 optional: true,
             },
         },