[sw] Update source documentation

Fixes mostly spelling errors and outdated parameters.
Based on the warnings generated by Doxygen.

Signed-off-by: Tobias Wölfel <tobias.woelfel@mailbox.org>
diff --git a/sw/device/lib/dif/dif_lc_ctrl.h b/sw/device/lib/dif/dif_lc_ctrl.h
index 6d9b89a..9156677 100644
--- a/sw/device/lib/dif/dif_lc_ctrl.h
+++ b/sw/device/lib/dif/dif_lc_ctrl.h
@@ -341,7 +341,7 @@
  * up to 16.
  *
  * @param lc A lifecycle handle.
- * @param[out] state Out-param for the controller's state.
+ * @param[out] count Out-param for the number of attempts.
  * @return The result of the operation.
  */
 DIF_WARN_UNUSED_RESULT