qcacmn: Fix WMI documentation

The kernel-doc script identified many documentation issues in
the wmi folder, so fix them.

Note that in quite a few cases there is duplicate documentation in .h
and .c files, and in those cases remove the documentation from the .c
files since the interface should be documented, not the
implementation.

Change-Id: I097d5b8e8f0ba09046b7b8abe338d05a00f8cc7e
CRs-Fixed: 3372831

wmi/inc/wmi_unified_dcs_api.h

@@ -1,5 +1,6 @@
 /*
  * Copyright (c) 2020-2021, 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 any
  * purpose with or without fee is hereby granted, provided that the above
@@ -29,7 +30,7 @@
 
 /**
  * wmi_extract_dcs_interference_type() - extract dcs interference type
- * @wmi_handle: wmi handle
+ * @wmi_hdl: wmi handle
  * @evt_buf: pointer to event buffer
  * @param: Pointer to hold dcs interference param
  *
@@ -44,7 +45,7 @@ QDF_STATUS wmi_extract_dcs_interference_type(
 
 /**
  * wmi_extract_dcs_im_tgt_stats() - extract dcs im target stats
- * @wmi_handle: wmi handle
+ * @wmi_hdl: wmi handle
  * @evt_buf: pointer to event buffer
  * @wlan_stat: Pointer to hold wlan stats
  *
@@ -57,9 +58,9 @@ QDF_STATUS wmi_extract_dcs_im_tgt_stats(
 	void *evt_buf,
 	struct wlan_host_dcs_im_tgt_stats *wlan_stat);
 
-/*
+/**
  * wmi_extract_dcs_awgn_info() - extract DCS AWGN interference info from event
- * @wmi_handle: WMI handle
+ * @wmi_hdl: WMI handle
  * @evt_buf: Pointer to event buffer
  * @awgn_info: Pointer to hold AWGN interference info
  *