From: Uwe Hermann <redacted>
Date: Thu, 25 Aug 2016 20:01:04 +0000 (+0200)
Subject: srd_inst_decode(): Improve comments and log messages.
X-Git-Tag: libsigrokdecode-0.4.1~12
X-Git-Url: https://sigrok.org/gitaction?a=commitdiff_plain;h=7b849244f6bc98e20281785b6b4842752e163e43;p=libsigrokdecode.git

srd_inst_decode(): Improve comments and log messages.

Also, drop @since tag (as the function is not public).
---

diff --git a/instance.c b/instance.c
index 53a8d92..b4f9cfd 100644
--- a/instance.c
+++ b/instance.c
@@ -522,7 +522,7 @@ SRD_PRIV int srd_inst_start(struct srd_decoder_inst *di)
 }
 
 /**
- * Run the specified decoder function.
+ * Decode a chunk of samples.
  *
  * @param di The decoder instance to call. Must not be NULL.
  * @param start_samplenum The starting sample number for the buffer's sample
@@ -531,13 +531,11 @@ SRD_PRIV int srd_inst_start(struct srd_decoder_inst *di)
  * 			  set, relative to the start of capture.
  * @param inbuf The buffer to decode. Must not be NULL.
  * @param inbuflen Length of the buffer. Must be > 0.
- * @param unitsize The number of bytes per sample.
+ * @param unitsize The number of bytes per sample. Must be > 0.
  *
  * @return SRD_OK upon success, a (negative) error code otherwise.
  *
  * @private
- *
- * @since 0.4.0
  */
 SRD_PRIV int srd_inst_decode(const struct srd_decoder_inst *di,
 		uint64_t start_samplenum, uint64_t end_samplenum,
@@ -562,7 +560,7 @@ SRD_PRIV int srd_inst_decode(const struct srd_decoder_inst *di,
 
 	((struct srd_decoder_inst *)di)->data_unitsize = unitsize;
 
-	srd_dbg("Calling decode(), start sample %" PRIu64 ", end sample %"
+	srd_dbg("Decoding: start sample %" PRIu64 ", end sample %"
 		PRIu64 " (%" PRIu64 " samples, %" PRIu64 " bytes, unitsize = "
 		"%d), instance %s.", start_samplenum, end_samplenum,
 		end_samplenum - start_samplenum, inbuflen, di->data_unitsize,