5 files changed, 38 insertions, 47 deletions
diff --git a/src/coding/gsm0503_coding.c b/src/coding/gsm0503_coding.c
index bb86b2c7..5213dc5f 100644
--- a/src/coding/gsm0503_coding.c
+++ b/src/coding/gsm0503_coding.c
@@ -100,9 +100,8 @@
  *  various other modules (mapping, parity, interleaving) in order to
  *  implement the complete channel coding (and decoding) chain for the
  *  various channel types as defined in TS 05.03 / 45.003.
- */
-
-/*! \file gsm0503_coding.c */
+ *
+ * \file gsm0503_coding.c */
 
 /*
  * EGPRS coding limits
diff --git a/src/coding/gsm0503_interleaving.c b/src/coding/gsm0503_interleaving.c
index 19e68474..b42f242d 100644
--- a/src/coding/gsm0503_interleaving.c
+++ b/src/coding/gsm0503_interleaving.c
@@ -29,16 +29,12 @@
 
 /*! \addtogroup interleaving
  *  @{
- *  GSM TS 05.03 interleaving
+ * GSM TS 05.03 interleaving
  *
- *  This module contains interleaving / de-interleaving routines for
- *  various channel types, as defined in 3GPP TS 05.03 / 45.003
- */
-
-/*! \file gsm0503_interleaving.c */
-
-/*
- * GSM xCCH interleaving and burst mapping
+ * This module contains interleaving / de-interleaving routines for
+ * various channel types, as defined in 3GPP TS 05.03 / 45.003.
+ *
+ * GSM xCCH interleaving and burst mapping:
  *
  * Interleaving:
  *
@@ -57,7 +53,30 @@
  *      e(B, 58) = h_n(B)
  *
  * Where hl(B) and hn(B) are bits in burst B indicating flags.
- */
+ *
+ * GSM TCH HR/AHS interleaving and burst mapping:
+ *
+ * Interleaving:
+ *
+ * Given 288 coded input bits, form 4 blocks of 114 bits,
+ * where even bits of the first 2 blocks and odd bits of the last 2 blocks
+ * are used:
+ *
+ *      i(B, j) = c(n, k)       k = 0, ..., 227
+ *                              n = 0, ..., N, N + 1, ...
+ *                              B = B_0 + 2n + b
+ *                              j, b = table[k];
+ *
+ * Mapping on Burst:
+ *
+ *      e(B, j) = i(B, j)
+ *      e(B, 59 + j) = i(B, 57 + j)     j = 0, ..., 56
+ *      e(B, 57) = h_l(B)
+ *      e(B, 58) = h_n(B)
+ *
+ * Where hl(B) and hn(B) are bits in burst B indicating flags.
+ *
+ * \file gsm0503_interleaving.c */
 
 /*! De-Interleave burst bits according to TS 05.03 4.1.4
  *  \param[out] cB caller-allocated output buffer for 456 soft coded bits
@@ -633,30 +652,6 @@ void gsm0503_tch_fr_interleave(const ubit_t *cB, ubit_t *iB)
 	}
 }
 
-/*
- * GSM TCH HR/AHS interleaving and burst mapping
- *
- * Interleaving:
- *
- * Given 288 coded input bits, form 4 blocks of 114 bits,
- * where even bits of the first 2 blocks and odd bits of the last 2 blocks
- * are used:
- *
- *      i(B, j) = c(n, k)       k = 0, ..., 227
- *                              n = 0, ..., N, N + 1, ...
- *                              B = B_0 + 2n + b
- *                              j, b = table[k];
- *
- * Mapping on Burst:
- *
- *      e(B, j) = i(B, j)
- *      e(B, 59 + j) = i(B, 57 + j)     j = 0, ..., 56
- *      e(B, 57) = h_l(B)
- *      e(B, 58) = h_n(B)
- *
- * Where hl(B) and hn(B) are bits in burst B indicating flags.
- */
-
 /*! GSM TCH HR/AHS De-Interleaving and burst mapping
  *  \param[out] cB caller-allocated buffer for 228 unpacked output bits
  *  \param[in] iB 228 unpacked interleaved input bits */
diff --git a/src/coding/gsm0503_mapping.c b/src/coding/gsm0503_mapping.c
index 15fd1b6e..d414769f 100644
--- a/src/coding/gsm0503_mapping.c
+++ b/src/coding/gsm0503_mapping.c
@@ -32,9 +32,8 @@
  *
  *  This module contains burst mapping routines as specified in 3GPP TS
  *  05.03 / 45.003.
- */
-
-/*! \file gsm0503_mapping.c */
+ *
+ * \file gsm0503_mapping.c */
 
 void gsm0503_xcch_burst_unmap(sbit_t *iB, const sbit_t *eB,
 	sbit_t *hl, sbit_t *hn)
diff --git a/src/coding/gsm0503_parity.c b/src/coding/gsm0503_parity.c
index cc817024..b57caa30 100644
--- a/src/coding/gsm0503_parity.c
+++ b/src/coding/gsm0503_parity.c
@@ -31,9 +31,8 @@
  *
  *  This module contains parity/crc code definitions for the various
  *  parity/crc schemes as defined in 3GPP TS 05.03 / 45.003
- */
-
-/*! \file gsm0503_parity.c */
+ *
+ * \file gsm0503_parity.c */
 
 /*! GSM (SACCH) parity (FIRE code)
  *
diff --git a/src/coding/gsm0503_tables.c b/src/coding/gsm0503_tables.c
index 32d12eae..dda8cad1 100644
--- a/src/coding/gsm0503_tables.c
+++ b/src/coding/gsm0503_tables.c
@@ -27,14 +27,13 @@
 /*! \addtogroup tables
  *  @{
  *
- *  GSM TS 05.03 tables
+ *  GSM TS 05.03 tables.
  *
  *  This module contains various tables defining parts of 3GPP TS 05.03
  *  / 45.003, primarily for the purpose of (de)puncturing, interleaving,
  *  etc.
- */
-
-/*! \file gsm0503_tables.c */
+ *
+ * \file gsm0503_tables.c */
 
 const ubit_t gsm0503_pdtch_hl_hn_ubit[4][8] = {
 	{ 1,1, 1,1, 1,1, 1,1 },