qcacmn: Fix target_if.h documentation

The kernel-doc script reported documentation issues in
target_if/core/inc/target_if.h, so fix them.

Change-Id: I3c539f3a581f5886c013e34fa54904899cbe9d17
CRs-Fixed: 3417467

target_if/core/inc/target_if.h

@@ -95,6 +95,7 @@ enum wmi_init_status {
  * @magic: magic for target if ctx
  * @get_psoc_hdl_cb:  function pointer to get psoc
  * @get_pdev_hdl_cb:  function pointer to get pdev
+ * @service_ready_cb: function pointeer for service ready callback
  * @lock: spin lock for protecting the ctx
  */
 struct target_if_ctx {
@@ -190,21 +191,23 @@ struct target_version_info {
  * @wmi_timeout: wait timeout for target events
  * @event: qdf_event for target events
  * @service_bitmap: WMI service bitmap
- * @target_cap: target capabilities
- * @service_ext2_param: service ready ext2 event params
+ * @target_caps: target capabilities
  * @service_ext_param: ext service params
+ * @service_ext2_param: service ready ext2 event params
  * @mac_phy_cap: phy caps array
  * @mac_phy_caps_ext2: mac phy caps ext2 params
  * @dbr_ring_cap: dbr_ring capability info
- * @reg_cap: regulatory caps array
  * @scaling_params: Spectral bin scaling parameters
  * @num_mem_chunks: number of mem chunks allocated
- * @hw_mode_caps: HW mode caps of preferred mode
  * @mem_chunks: allocated memory blocks for FW
+ * @hw_mode_cap: HW mode caps of preferred mode
+ * @hw_modes: supported hardware modes
+ * @pdev_id_to_phy_id_map: pdev id to phy id map
+ * @is_pdevid_to_phyid_map: true if @pdev_id_to_phy_id_map is valid
  * @scan_radio_caps: scan radio capabilities
  * @device_mode: Global Device mode
  * @sbs_lower_band_end_freq: sbs lower band end frequency
- * @health_mon_params: health monitor params
+ * @health_mon_param: health monitor params
  */
 struct tgt_info {
 	struct host_fw_ver version;
@@ -265,9 +268,11 @@ struct tgt_info {
  * @set_default_tgt_config: Sets target config with default values
  * @sw_version_check: Checks the SW version
  * @smart_log_enable: Enable Smart Logs feature
+ * @eapol_minrate_enable: Enable EAPOL minimum rate configuration
  * @cfr_support_enable: CFR support enable
  * @set_pktlog_checksum: Set the pktlog checksum from FW ready event to pl_dev
  * @csa_switch_count_status: CSA event handler
+ * @ema_init: Initialize Enhanced MBSSID advertisement feature
  * @mlo_capable: Checks if the SoC is MLO capable
  * @mlo_get_group_id: Get the MLO group id of the SoC
  * @mlo_setup_done_event: MLO setup sequence complete event handler
@@ -341,8 +346,6 @@ struct target_ops {
 #endif
 };
 
-
-
 /**
  * struct target_psoc_info - target psoc information
  * @hdls: component handles (htc/htt/wmi) sub structure
@@ -394,8 +397,7 @@ struct target_mu_caps {
 
 /**
  * target_if_init() - target_if Initialization
- * @get_wmi_handle: function pointer to get wmi handle
- *
+ * @psoc_hdl_cb: function pointer to get wmi handle
  *
  * Return: QDF_STATUS
  */
@@ -403,7 +405,6 @@ QDF_STATUS target_if_init(get_psoc_handle_callback psoc_hdl_cb);
 
 /**
  * target_if_deinit() - Close target_if
- * @scn_handle: scn handle
  *
  * Return: QDF_STATUS_SUCCESS - in case of success
  */
@@ -419,7 +420,7 @@ QDF_STATUS target_if_store_pdev_target_if_ctx(
 		get_pdev_handle_callback pdev_hdl_cb);
 
 /**
- * wlan_get_tgt_if_ctx() -Get target if ctx
+ * target_if_get_ctx() - Get target if ctx
  *
  * Return: target if ctx
  */
@@ -449,7 +450,8 @@ struct wlan_objmgr_psoc *target_if_get_psoc_from_scn_hdl(void *scn_handle);
  */
 struct wlan_objmgr_pdev *target_if_get_pdev_from_scn_hdl(void *scn_handle);
 
-/** target_if_register_tx_ops() - register tx_ops
+/**
+ * target_if_register_tx_ops() - register tx_ops
  * @tx_ops: tx_ops structure
  *
  * This function is to be used by components to populate
@@ -899,8 +901,7 @@ static inline void target_psoc_set_num_radios(
 /**
  * target_psoc_set_pdev_id_to_phy_id_map() - set pdev to phy id mapping
  * @psoc_info:  pointer to structure target_psoc_info
- * @pdev_id: pdev id
- * @phy_id: phy_id
+ * @phy_id_map: phy_id
  *
  * API to set pdev id to phy id mapping
  *
@@ -938,6 +939,7 @@ static inline uint8_t target_psoc_get_num_radios
 /**
  * target_psoc_get_num_radios_for_mode() - get number of radios for a hw-mode
  * @psoc_info:  pointer to structure target_psoc_info
+ * @mode: hardware mode
  *
  * API to get number_of_radios for a HW mode
  *
@@ -995,9 +997,9 @@ static inline uint32_t *target_psoc_get_service_bitmap
 }
 
 /**
- * target_psoc_set_num_mem_chunks - set num_mem_chunks
+ * target_psoc_set_num_mem_chunks() - set num_mem_chunks
  * @psoc_info:  pointer to structure target_psoc_info
- & @num_mem_chunks: Num Memory chunks allocated for FW
+ * @num_mem_chunks: Num Memory chunks allocated for FW
  *
  * API to set num_mem_chunks
  *
@@ -1027,8 +1029,9 @@ static inline uint32_t target_psoc_get_num_mem_chunks
 
 	return psoc_info->info.num_mem_chunks;
 }
+
 /**
- * target_psoc_set_hif_hdl - set hif_hdl
+ * target_psoc_set_hif_hdl() - set hif_hdl
  * @psoc_info:  pointer to structure target_psoc_info
  * @hif_hdl:    HIF handle
  *
@@ -1064,7 +1067,7 @@ static inline struct hif_opaque_softc *target_psoc_get_hif_hdl
 }
 
 /**
- * target_psoc_set_hif_hdl - set htc_hdl
+ * target_psoc_set_htc_hdl() - set htc_hdl
  * @psoc_info:  pointer to structure target_psoc_info
  * @htc_hdl:    HTC handle
  *
@@ -1098,8 +1101,9 @@ static inline HTC_HANDLE target_psoc_get_htc_hdl
 
 	return psoc_info->hdls.htc_hdl;
 }
+
 /**
- * target_psoc_set_wmi_hdl - set wmi_hdl
+ * target_psoc_set_wmi_hdl() - set wmi_hdl
  * @psoc_info:  pointer to structure target_psoc_info
  * @wmi_hdl:    WMI handle
  *
@@ -1135,7 +1139,7 @@ static inline struct wmi_unified *target_psoc_get_wmi_hdl
 }
 
 /**
- * target_psoc_set_accelerator_hdl - set accelerator_hdl
+ * target_psoc_set_accelerator_hdl() - set accelerator_hdl
  * @psoc_info:  pointer to structure target_psoc_info
  * @accelerator_hdl: Accelator handle
  *
@@ -1172,7 +1176,7 @@ struct common_accelerator_handle *target_psoc_get_accelerator_hdl
 }
 
 /**
- * target_psoc_set_feature_ptr - set feature_ptr
+ * target_psoc_set_feature_ptr() - set feature_ptr
  * @psoc_info:  pointer to structure target_psoc_info
  * @feature_ptr: set feature pointer
  *
@@ -1285,7 +1289,7 @@ static inline uint32_t target_psoc_get_target_rev
 }
 
 /**
- * target_psoc_set_dbglog_hdl - set dbglog_hdl
+ * target_psoc_set_dbglog_hdl() - set dbglog_hdl
  * @psoc_info:  pointer to structure target_psoc_info
  * @dbglog_hdl:    dbglog handle
  *
@@ -1355,7 +1359,7 @@ static inline wmi_host_ext_resource_config *target_psoc_get_wlan_ext_res_cfg
 }
 
 /**
- * target_psoc_get_event_queue() - get event_queue
+ * target_psoc_get_event() - get event queue
  * @psoc_info:  pointer to structure target_psoc_info
  *
  * API to get event_queue
@@ -1446,6 +1450,7 @@ static inline uint32_t target_psoc_get_num_scan_radio_caps
 /**
  * target_psoc_get_mac_phy_cap_for_mode() - get mac_phy_cap for a hw-mode
  * @psoc_info:  pointer to structure target_psoc_info
+ * @mode: hardware mode
  *
  * API to get mac_phy_cap for a specified hw-mode
  *
@@ -1657,7 +1662,7 @@ static inline struct target_ops *target_psoc_get_tif_ops
 }
 
 /**
- * target_pdev_set_feature_ptr - set feature_ptr
+ * target_pdev_set_feature_ptr() - set feature_ptr
  * @pdev_info:  pointer to structure target_pdev_info
  * @feature_ptr: Feature pointer
  *
@@ -1692,7 +1697,7 @@ static inline void *target_pdev_get_feature_ptr
 }
 
 /**
- * target_pdev_set_wmi_handle - set wmi_handle
+ * target_pdev_set_wmi_handle() - set wmi_handle
  * @pdev_info:  pointer to structure target_pdev_info
  * @wmi_handle: WMI handle
  *
@@ -1711,7 +1716,7 @@ static inline void target_pdev_set_wmi_handle
 }
 
 /**
- * target_pdev_get_wmi_handle - get wmi_handle
+ * target_pdev_get_wmi_handle() - get wmi_handle
  * @pdev_info:  pointer to structure target_dev_info
  *
  * API to get wmi_handle
@@ -1728,7 +1733,7 @@ static inline struct wmi_unified *target_pdev_get_wmi_handle
 }
 
 /**
- * target_pdev_set_accelerator_hdl - set accelerator_hdl
+ * target_pdev_set_accelerator_hdl() - set accelerator_hdl
  * @pdev_info:  pointer to structure target_pdev_info
  * @accelerator_hdl: Accelator handle
  *
@@ -1747,7 +1752,7 @@ static inline void target_pdev_set_accelerator_hdl
 }
 
 /**
- * target_pdev_get_accelerator_hdl - get accelerator_hdl
+ * target_pdev_get_accelerator_hdl() - get accelerator_hdl
  * @pdev_info:  pointer to structure target_dev_info
  *
  * API to get accelerator_hdl
@@ -1764,7 +1769,7 @@ target_pdev_get_accelerator_hdl(struct target_pdev_info *pdev_info)
 }
 
 /**
- * target_pdev_set_pdev_idx - set pdev_idx
+ * target_pdev_set_pdev_idx() - set pdev_idx
  * @pdev_info:  pointer to structure target_pdev_info
  * @pdev_idx:   PDEV id of FW
  *
@@ -1782,7 +1787,7 @@ static inline void target_pdev_set_pdev_idx
 }
 
 /**
- * target_pdev_get_pdev_idx  - get pdev_idx
+ * target_pdev_get_pdev_idx() - get pdev_idx
  * @pdev_info:  pointer to structure target_dev_info
  *
  * API to get pdev_idx
@@ -1799,7 +1804,7 @@ static inline int32_t  target_pdev_get_pdev_idx
 }
 
 /**
- * target_pdev_set_phy_idx - set phy_idx
+ * target_pdev_set_phy_idx() - set phy_idx
  * @pdev_info:  pointer to structure target_pdev_info
  * @phy_idx:    phy ID of FW
  *
@@ -1817,7 +1822,7 @@ static inline void target_pdev_set_phy_idx
 }
 
 /**
- * target_pdev_get_phy_idx  - get phy_idx
+ * target_pdev_get_phy_idx() - get phy_idx
  * @pdev_info:  pointer to structure target_dev_info
  *
  * API to get phy_idx
@@ -1834,7 +1839,7 @@ static inline int32_t target_pdev_get_phy_idx
 }
 
 /**
- * GET_WMI_HDL_FROM_PSOC - get wmi handle from psoc
+ * GET_WMI_HDL_FROM_PSOC() - get wmi handle from psoc
  * @psoc:  psoc object
  *
  * API to get wmi_handle from psoc
@@ -1860,7 +1865,7 @@ static inline struct wmi_unified *GET_WMI_HDL_FROM_PSOC(
 }
 
 /**
- * GET_WMI_HDL_FROM_PDEV - get wmi handle from pdev
+ * GET_WMI_HDL_FROM_PDEV() - get wmi handle from pdev
  * @pdev:  pdev object
  *
  * API to get wmi_handle from pdev
@@ -1886,7 +1891,7 @@ static inline struct wmi_unified *GET_WMI_HDL_FROM_PDEV(
 }
 
 /**
- * get_wmi_unified_hdl_from_psoc - get wmi handle from psoc
+ * get_wmi_unified_hdl_from_psoc() - get wmi handle from psoc
  * @psoc:  psoc object
  *
  * API to get wmi_handle from psoc
@@ -1901,7 +1906,7 @@ get_wmi_unified_hdl_from_psoc(struct wlan_objmgr_psoc *psoc)
 }
 
 /**
- * get_wmi_unified_hdl_from_pdev - get wmi handle from pdev
+ * get_wmi_unified_hdl_from_pdev() - get wmi handle from pdev
  * @pdev:  pdev object
  *
  * API to get wmi_handle from pdev
@@ -1916,7 +1921,7 @@ get_wmi_unified_hdl_from_pdev(struct wlan_objmgr_pdev *pdev)
 }
 
 /**
- * target_if_ext_res_cfg_enable - Enable ext resource config
+ * target_if_ext_res_cfg_enable() - Enable ext resource config
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -1935,7 +1940,7 @@ static inline void target_if_ext_res_cfg_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_peer_cfg_enable - Enable peer config
+ * target_if_peer_cfg_enable() - Enable peer config
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -1953,7 +1958,7 @@ static inline void target_if_peer_cfg_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_mesh_support_enable - Enable MESH mode support
+ * target_if_mesh_support_enable() - Enable MESH mode support
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -1971,7 +1976,7 @@ static inline void target_if_mesh_support_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_eapol_minrate_enable - Enable EAPOL Minrate in Tunnel Mode
+ * target_if_eapol_minrate_enable() - Enable EAPOL Minrate in Tunnel Mode
  * @psoc: psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -1989,7 +1994,7 @@ static inline void target_if_eapol_minrate_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_smart_antenna_enable - Enable Smart antenna module
+ * target_if_smart_antenna_enable() - Enable Smart antenna module
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -2007,7 +2012,7 @@ static inline void target_if_smart_antenna_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_cfr_support_enable - Enable cfr support
+ * target_if_cfr_support_enable() - Enable cfr support
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -2025,7 +2030,7 @@ static inline void target_if_cfr_support_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_set_pktlog_checksum - Set pktlog checksum
+ * target_if_set_pktlog_checksum() - Set pktlog checksum
  * @pdev: pdev object
  * @tgt_hdl: target_psoc_info pointer
  * @checksum: checksum received from FW
@@ -2043,7 +2048,7 @@ static inline void target_if_set_pktlog_checksum(struct wlan_objmgr_pdev *pdev,
 }
 
 /**
- * target_if_atf_cfg_enable - Enable ATF config
+ * target_if_atf_cfg_enable() - Enable ATF config
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -2061,7 +2066,7 @@ static inline void target_if_atf_cfg_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_btcoex_cfg_enable - Enable BT coex config
+ * target_if_btcoex_cfg_enable() - Enable BT coex config
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -2079,7 +2084,7 @@ static inline void target_if_btcoex_cfg_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_lteu_cfg_enable - Enable LTEU config
+ * target_if_lteu_cfg_enable() - Enable LTEU config
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -2098,7 +2103,7 @@ static inline void target_if_lteu_cfg_enable(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_set_init_cmd_dev_param - Set init command params
+ * target_if_set_init_cmd_dev_param() - Set init command params
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  *
@@ -2117,7 +2122,7 @@ static inline void target_if_set_init_cmd_dev_param(
 }
 
 /**
- * target_if_alloc_pdevs - Allocate PDEVs
+ * target_if_alloc_pdevs() - Allocate PDEVs
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  *
@@ -2141,7 +2146,7 @@ static inline QDF_STATUS target_if_alloc_pdevs(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_update_pdev_tgt_info - Update PDEVs info
+ * target_if_update_pdev_tgt_info() - Update PDEVs info
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  *
@@ -2166,7 +2171,7 @@ static inline QDF_STATUS target_if_update_pdev_tgt_info(
 }
 
 /**
- * target_if_print_service_ready_ext_param - Print Service ready ext param
+ * target_if_print_service_ready_ext_param() - Print Service ready ext param
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  *
@@ -2185,7 +2190,7 @@ static inline void target_if_print_service_ready_ext_param(
 }
 
 /**
- * target_if_add_11ax_modes - Add 11ax modes explicitly
+ * target_if_add_11ax_modes() - Add 11ax modes explicitly
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  *
@@ -2210,7 +2215,7 @@ static inline void target_if_add_11ax_modes(struct wlan_objmgr_psoc *psoc,
 #endif
 
 /**
- * target_if_csa_switch_count_status - Calls a function to process CSA event
+ * target_if_csa_switch_count_status() - Calls a function to process CSA event
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @csa_status: CSA switch count status event param
@@ -2230,7 +2235,7 @@ static inline int target_if_csa_switch_count_status(
 }
 
 /**
- * target_if_set_default_config - Set default config in init command
+ * target_if_set_default_config() - Set default config in init command
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  *
@@ -2248,7 +2253,7 @@ static inline void target_if_set_default_config(struct wlan_objmgr_psoc *psoc,
 }
 
 /**
- * target_if_sw_version_check - SW version check
+ * target_if_sw_version_check() - SW version check
  * @psoc:  psoc object
  * @tgt_hdl: target_psoc_info pointer
  * @evt_buf: Event buffer received from FW
@@ -2275,7 +2280,7 @@ static inline QDF_STATUS target_if_sw_version_check(
 }
 
 /**
- * target_if_get_phy_capability  - get phy capability
+ * target_if_get_phy_capability()  - get phy capability
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get phy capability from the target caps
@@ -2292,9 +2297,9 @@ static inline int32_t target_if_get_phy_capability
 }
 
 /**
- * target_if_set_phy_capability  - set phy capability
+ * target_if_set_phy_capability()  - set phy capability
  * @target_psoc_info:  pointer to structure target_psoc_info
- * @phy_capab: PHY capabilities
+ * @phy_capability: PHY capabilities
  *
  * API to set phy capability in the target caps
  *
@@ -2310,7 +2315,7 @@ static inline void target_if_set_phy_capability
 }
 
 /**
- * target_if_set_max_frag_entry  - set Maximum frag entries
+ * target_if_set_max_frag_entry() - set Maximum frag entries
  * @target_psoc_info:  pointer to structure target_psoc_info
  * @max_frag_entry: Maximum frag entries
  *
@@ -2328,7 +2333,7 @@ static inline void target_if_set_max_frag_entry
 }
 
 /**
- * target_if_get_max_frag_entry  - get Maximum frag entries
+ * target_if_get_max_frag_entry() - get Maximum frag entries
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get Maximum frag entries from the target caps
@@ -2345,7 +2350,7 @@ static inline int32_t target_if_get_max_frag_entry
 }
 
 /**
- * target_if_get_ht_cap_info  - get ht capabilities info
+ * target_if_get_ht_cap_info() - get ht capabilities info
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get ht capabilities info from the target caps
@@ -2362,7 +2367,7 @@ static inline int32_t target_if_get_ht_cap_info
 }
 
 /**
- * target_if_get_vht_cap_info  - get vht capabilities info
+ * target_if_get_vht_cap_info() - get vht capabilities info
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get vht capabilities info from the target caps
@@ -2379,7 +2384,7 @@ static inline int32_t target_if_get_vht_cap_info
 }
 
 /**
- * target_if_get_num_rf_chains  - get Number of RF chains supported
+ * target_if_get_num_rf_chains() - get Number of RF chains supported
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get Number of RF chains supported from the target caps
@@ -2396,7 +2401,7 @@ static inline int32_t target_if_get_num_rf_chains
 }
 
 /**
- * target_if_get_fw_version  - get firmware version
+ * target_if_get_fw_version() - get firmware version
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get firmware version from the target caps
@@ -2413,7 +2418,7 @@ static inline int32_t target_if_get_fw_version
 }
 
 /**
- * target_if_get_wmi_fw_sub_feat_caps  - FW sub feature capabilities
+ * target_if_get_wmi_fw_sub_feat_caps() - FW sub feature capabilities
  * @target_psoc_info:  pointer to structure target_psoc_info
  *
  * API to get FW sub feature capabilities from the target caps
@@ -2430,7 +2435,7 @@ static inline int32_t target_if_get_wmi_fw_sub_feat_caps
 }
 
 /**
- * target_if_get_conc_scan_config_bits  - Default concurrenct scan config
+ * target_if_get_conc_scan_config_bits() - Default concurrenct scan config
  * @tgt_hdl:  pointer to structure target_psoc_info
  *
  * API to get Default concurrenct scan config from the target caps
@@ -2447,7 +2452,7 @@ static inline int32_t target_if_get_conc_scan_config_bits
 }
 
 /**
- * target_if_get_fw_config_bits  - Default HW config bits
+ * target_if_get_fw_config_bits() - Default HW config bits
  * @tgt_hdl:  pointer to structure target_psoc_info
  *
  * API to get Default HW config bits from the target caps
@@ -2464,7 +2469,7 @@ static inline int32_t target_if_get_fw_config_bits
 }
 
 /**
- * target_psoc_get_num_hw_modes  - get number of dbs hardware modes
+ * target_psoc_get_num_hw_modes() - get number of dbs hardware modes
  * @tgt_hdl:  pointer to structure target_psoc_info
  *
  * API to get Number of Dual Band Simultaneous (DBS) hardware modes
@@ -2575,7 +2580,7 @@ static inline uint32_t target_psoc_get_chan_width_switch_num_peers(
 }
 
 /**
- * target_if_is_scan_radio_supported() - API to check scan radio
+ * target_pdev_is_scan_radio_supported() - API to check scan radio
  * support for the given radio
  * @pdev: pointer to pdev
  * @is_scan_radio_supported: pointer to scan radio support flag
@@ -2797,13 +2802,13 @@ void target_psoc_get_twt_ack_cap(struct target_psoc_info *psoc_info, bool *val)
 }
 
 /**
- * target_psoc_target_cap_flags() - flags containing information about target
- * capabilities
+ * target_psoc_get_target_cap_flags() - get flags containing information
+ *                                      about target capabilities
  * @psoc_info:  pointer to structure target_psoc_info
  *
  * API to get flags containing information about target capabilities
  *
- * Return: no of target_cap_flags
+ * Return: target_cap_flags
  */
 static inline uint32_t target_psoc_get_target_cap_flags
 		(struct target_psoc_info *psoc_info)
@@ -2815,20 +2820,20 @@ static inline uint32_t target_psoc_get_target_cap_flags
 }
 
 #if defined(WLAN_FEATURE_11BE_MLO) && defined(WLAN_MLO_MULTI_CHIP)
+#define PDEV_INVALID_HW_LINK_ID 0xFFFF
+
 /**
- * target_pdev_get_hw_link_id  - get hw_link_id
+ * target_if_pdev_get_hw_link_id() - get hw_link_id
  * @pdev:  pointer to structure target_pdev_info
  *
  * API to get hw_link_id
  *
- * Return: uint16_t
+ * Return: hw link id if valid, otherwise %PDEV_INVALID_HW_LINK_ID
  */
-#define PDEV_INVALID_HW_LINK_ID 0xFFFF
-uint16_t  target_if_pdev_get_hw_link_id
-		(struct wlan_objmgr_pdev *pdev);
+uint16_t  target_if_pdev_get_hw_link_id(struct wlan_objmgr_pdev *pdev);
 
 /**
- * target_pdev_set_hw_link_id - set hw_link_id
+ * target_pdev_set_hw_link_id() - set hw_link_id
  * @pdev:  pointer to structure target_pdev_info
  * @hw_link_id: unique hw link id of pdev across psoc
  *
@@ -2836,11 +2841,11 @@ uint16_t  target_if_pdev_get_hw_link_id
  *
  * Return: void
  */
-void target_pdev_set_hw_link_id
-		(struct wlan_objmgr_pdev *pdev, uint16_t hw_link_id);
+void target_pdev_set_hw_link_id(struct wlan_objmgr_pdev *pdev,
+				uint16_t hw_link_id);
 
 /**
- * target_if_mlo_setup_req - API to trigger MLO setup sequence
+ * target_if_mlo_setup_req() - API to trigger MLO setup sequence
  * @pdev: Array of pointers to pdev object that are part of ML group
  * @num_pdevs: Number of pdevs in above array
  * @grp_id: ML Group ID
@@ -2851,7 +2856,7 @@ QDF_STATUS target_if_mlo_setup_req(struct wlan_objmgr_pdev **pdev,
 				   uint8_t num_pdevs, uint8_t grp_id);
 
 /**
- * target_if_mlo_ready - API to send MLO ready
+ * target_if_mlo_ready() - API to send MLO ready
  * @pdev: Array of pointers to pdev object that are part of ML group
  * @num_pdevs: Number of pdevs in above array
  *
@@ -2861,7 +2866,7 @@ QDF_STATUS target_if_mlo_ready(struct wlan_objmgr_pdev **pdev,
 			       uint8_t num_pdevs);
 
 /**
- * target_if_mlo_teardown_req - API to trigger MLO teardown sequence
+ * target_if_mlo_teardown_req() - API to trigger MLO teardown sequence
  * @pdev: Array of pointers to pdev object that are part of ML group
  * @num_pdevs: Number of pdevs in above array
  * @reason: Reason for triggering teardown
@@ -2873,9 +2878,10 @@ QDF_STATUS target_if_mlo_teardown_req(struct wlan_objmgr_pdev **pdev,
 #endif /*WLAN_FEATURE_11BE_MLO && WLAN_MLO_MULTI_CHIP*/
 
 /**
- * target_if_is_platform_eht_capable():
- * API to check if the platform is EHT capable
- * @pdev: pdev object
+ * target_if_is_platform_eht_capable() - API to check if the platform
+ *                                       is EHT capable
+ * @psoc: psoc object
+ * @pdev_id: pdev id
  *
  * Return: True if platform is 11BE capable; else False
  */