From 5c7b7bb0b1baea28020a55af95710371d571865c Mon Sep 17 00:00:00 2001
From: Frank Morgner <frankmorgner@gmail.com>
Date: Wed, 31 Oct 2018 12:59:00 +0100
Subject: [PATCH] fixed minor XCode documentation warnings

---
 src/common/simclist.h    |  2 +-
 src/libopensc/internal.h |  2 +-
 src/libopensc/log.h      |  2 +-
 src/libopensc/opensc.h   | 10 +++++-----
 src/libopensc/sm.h       |  2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/common/simclist.h b/src/common/simclist.h
index b6ef9f9d..1b8782bb 100644
--- a/src/common/simclist.h
+++ b/src/common/simclist.h
@@ -163,7 +163,7 @@ typedef list_hash_t (*element_hash_computer)(const void *el);
  * @param serialize_buffer  reference to fill with the length of the buffer
  * @return                  reference to the buffer with the serialized data
  */
-typedef void *(*element_serializer)(const void *simclist_restrict el, uint32_t *simclist_restrict serializ_len);
+typedef void *(*element_serializer)(const void *simclist_restrict el, uint32_t *simclist_restrict serialize_buffer);
 
 /**
  * a function for un-serializing an element.
diff --git a/src/libopensc/internal.h b/src/libopensc/internal.h
index 08d590f2..dd079aac 100644
--- a/src/libopensc/internal.h
+++ b/src/libopensc/internal.h
@@ -155,7 +155,7 @@ int sc_pkcs1_strip_digest_info_prefix(unsigned int *algorithm,
  * @param  inlen   IN  length of the input
  * @param  out     OUT output buffer (in == out is allowed)
  * @param  outlen  OUT length of the output buffer
- * @param  modlen  IN  length of the modulus in bytes
+ * @param  mod_bits IN  length of the modulus in bits
  * @return SC_SUCCESS on success and an error code otherwise
  */
 int sc_pkcs1_encode(sc_context_t *ctx, unsigned long flags,
diff --git a/src/libopensc/log.h b/src/libopensc/log.h
index a91d8646..ef98a076 100644
--- a/src/libopensc/log.h
+++ b/src/libopensc/log.h
@@ -93,7 +93,7 @@ void _sc_log(struct sc_context *ctx, const char *format, ...);
  * @brief Log binary data
  *
  * @param[in] ctx   Context for logging
- * @param[in] type  Debug level
+ * @param[in] level Debug level
  * @param[in] file  File name to be prepended
  * @param[in] line  Line to be prepended
  * @param[in] func  Function to be prepended
diff --git a/src/libopensc/opensc.h b/src/libopensc/opensc.h
index 0abbf6a9..18489a8a 100644
--- a/src/libopensc/opensc.h
+++ b/src/libopensc/opensc.h
@@ -767,7 +767,7 @@ typedef struct sc_context {
  *  @param  apdu  sc_apdu_t object of the APDU to be send
  *  @return SC_SUCCESS on success and an error code otherwise
  */
-int sc_transmit_apdu(struct sc_card *, struct sc_apdu *);
+int sc_transmit_apdu(struct sc_card *card, struct sc_apdu *apdu);
 
 void sc_format_apdu(struct sc_card *, struct sc_apdu *, int, int, int, int);
 
@@ -1040,7 +1040,7 @@ size_t sc_get_max_recv_size(const sc_card_t *card);
  * Takes card limitations into account such as extended length support as well
  * as the reader's limitation for data transfer.
  *
- * @param card
+ * @param card card
  *
  * @return maximum Nc
  */
@@ -1449,7 +1449,7 @@ extern sc_card_driver_t *sc_get_iso7816_driver(void);
 /** 
  * @brief Read a complete EF by short file identifier.
  *
- * @param[in]     card
+ * @param[in]     card   card
  * @param[in]     sfid   Short file identifier
  * @param[in,out] ef     Where to safe the file. the buffer will be allocated
  *                       using \c realloc() and should be set to NULL, if
@@ -1464,7 +1464,7 @@ int iso7816_read_binary_sfid(sc_card_t *card, unsigned char sfid,
 /**
  * @brief Write a complete EF by short file identifier.
  *
- * @param[in] card
+ * @param[in] card   card
  * @param[in] sfid   Short file identifier
  * @param[in] ef     Date to write
  * @param[in] ef_len Length of \a ef
@@ -1477,7 +1477,7 @@ int iso7816_write_binary_sfid(sc_card_t *card, unsigned char sfid,
 /**
  * @brief Set verification status of a specific PIN to “not verified”
  *
- * @param[in] card
+ * @param[in] card           card
  * @param[in] pin_reference  PIN reference written to P2
  *
  * @note The appropriate directory must be selected before calling this function.
diff --git a/src/libopensc/sm.h b/src/libopensc/sm.h
index 7e4250c6..b3b1ae48 100644
--- a/src/libopensc/sm.h
+++ b/src/libopensc/sm.h
@@ -362,7 +362,7 @@ int sc_sm_single_transmit(struct sc_card *, struct sc_apdu *);
  * Calls \a card->sm_ctx.ops.close() if available and \c card->sm_ctx.sm_mode
  * is \c SM_MODE_TRANSMIT
  *
- * @param[in] card
+ * @param[in] card card
  *
  * @return \c SC_SUCCESS or error code if an error occurred
  */