cbor.h, cborencoder.c: Migrate documentation for encoder functions

Author: sjlongland

src/cbor.h

@@ -212,19 +212,6 @@ typedef enum CborEncoderAppendType
     CborEncoderApendRawData = 2
 } CborEncoderAppendType;
 
-/**
- * Writer interface call-back function.  When there is data to be written to
- * the CBOR document, this routine will be called.  The \a token parameter is
- * taken from the \a token argument provided to \ref cbor_encoder_init_writer
- * and may be used in any way the writer function sees fit.
- *
- * The \a data parameter contains a pointer to the raw bytes to be copied to
- * the output buffer, with \a len specifying how long the payload is, which
- * can be as small as a single byte or an entire (byte or text) string.
- *
- * The \a append parameter informs the writer function whether it is writing
- * a string or general CBOR data.
- */
 typedef CborError (*CborEncoderWriteFunction)(void *token, const void *data, size_t len, CborEncoderAppendType append);
 
 enum CborEncoderFlags

src/cborencoder.c

@@ -195,6 +195,23 @@
  * Structure used to encode to CBOR.
  */
 
+/**
+ * \file cbor.h
+ * \typedef CborEncoderWriteFunction
+ *
+ * Writer interface call-back function.  When there is data to be written to
+ * the CBOR document, this routine will be called.  The \a token parameter is
+ * taken from the \a token argument provided to \ref cbor_encoder_init_writer
+ * and may be used in any way the writer function sees fit.
+ *
+ * The \a data parameter contains a pointer to the raw bytes to be copied to
+ * the output buffer, with \a len specifying how long the payload is, which
+ * can be as small as a single byte or an entire (byte or text) string.
+ *
+ * The \a append parameter informs the writer function whether it is writing
+ * a string or general CBOR data.
+ */
+
 /**
  * Initializes a CborEncoder structure \a encoder by pointing it to buffer \a
  * buffer of size \a size. The \a flags field is currently unused and must be