qcacmn: Fix FTM documentation

The kernel-doc script identified a few kernel-doc issues in the ftm
folder, so fix them.

Change-Id: Icf1fac11bb2f3fa39cf29f6dabebc06bcb523d60
CRs-Fixed: 3376407

ftm/core/src/wlan_ftm_svc_i.h

@@ -1,5 +1,6 @@
 /*
  * Copyright (c) 2018 The Linux Foundation. All rights reserved.
+ * Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved.
  *
  *
  * Permission to use, copy, modify, and/or distribute this software for
@@ -47,7 +48,7 @@ struct ftm_seg_hdr_info {
  * @pdev: pdev pointer
  * @arg_list: argument list
  *
- * return: QDF_STATUS_SUCCESS for success or error code
+ * Return: QDF_STATUS_SUCCESS for success or error code
  */
 QDF_STATUS wlan_ftm_pdev_obj_create_notification(struct wlan_objmgr_pdev *pdev,
 							void *arg_list);
@@ -57,7 +58,7 @@ QDF_STATUS wlan_ftm_pdev_obj_create_notification(struct wlan_objmgr_pdev *pdev,
  * @pdev: pdev pointer
  * @arg_list: argument list
  *
- * return: QDF_STATUS_SUCCESS for success or error code
+ * Return: QDF_STATUS_SUCCESS for success or error code
  */
 QDF_STATUS wlan_ftm_pdev_obj_destroy_notification(struct wlan_objmgr_pdev *pdev,
 							void *arg_list);
@@ -67,8 +68,9 @@ QDF_STATUS wlan_ftm_pdev_obj_destroy_notification(struct wlan_objmgr_pdev *pdev,
  * @pdev: pdev pointer
  * @buf: data buffer
  * @len: event length
+ * @pdev_id: pdev id
  *
- * return: QDF_STATUS_SUCCESS for success or error code
+ * Return: QDF_STATUS_SUCCESS for success or error code
  */
 QDF_STATUS wlan_ftm_cmd_send(struct wlan_objmgr_pdev *pdev, uint8_t *buf,
 				uint32_t len, uint8_t pdev_id);

ftm/dispatcher/inc/wlan_ftm_ucfg_api.h

@@ -1,6 +1,6 @@
 /*
  * Copyright (c) 2018 The Linux Foundation. All rights reserved.
- * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
+ * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved.
  *
  *
  * Permission to use, copy, modify, and/or distribute this software for
@@ -72,9 +72,10 @@
 #define FTM_CMD_MAX_BUF_LENGTH		    2048
 
 /**
- * enum wifi_ftm_cmd_type - the enumeration of the command source per pdev
+ * enum wifi_ftm_pdev_cmd_type - the enumeration of the command source per pdev
  * @WIFI_FTM_CMD_IOCTL: command from ioctl on the pdev
  * @WIFI_FTM_CMD_NL80211: command from nl80211 on the pdev
+ * @WIFI_FTM_CMD_UNKNOWN: unknown command
  *
  */
 enum wifi_ftm_pdev_cmd_type {
@@ -106,7 +107,7 @@ struct wifi_ftm_pdev_priv_obj {
 };
 
 /**
- * wlan_ftm_testmode_cmd() - handle FTM testmode command
+ * ucfg_wlan_ftm_testmode_cmd() - handle FTM testmode command
  * @pdev: pdev pointer
  * @data: data
  * @len: data length
@@ -117,7 +118,7 @@ QDF_STATUS ucfg_wlan_ftm_testmode_cmd(struct wlan_objmgr_pdev *pdev,
 					uint8_t *data, uint32_t len);
 
 /**
- * wlan_ftm_testmode_rsp() - handle FTM testmode command
+ * ucfg_wlan_ftm_testmode_rsp() - handle FTM testmode command
  * @pdev: pdev pointer
  * @data: data
  *
@@ -128,11 +129,11 @@ QDF_STATUS ucfg_wlan_ftm_testmode_rsp(struct wlan_objmgr_pdev *pdev,
 
 /**
  * wlan_ftm_process_utf_event() - process ftm UTF event
- * @scn_handle: scn handle
- * @event: event buffer
+ * @pdev: pdev pointer
+ * @event_buf: event buffer
  * @len: event length
  *
- * return: QDF_STATUS_SUCCESS for success or error code
+ * Return: QDF_STATUS_SUCCESS for success or error code
  */
 QDF_STATUS wlan_ftm_process_utf_event(struct wlan_objmgr_pdev *pdev,
 					uint8_t *event_buf, uint32_t len);