summaryrefslogtreecommitdiffstats
path: root/src/bitvec.c
diff options
context:
space:
mode:
Diffstat (limited to 'src/bitvec.c')
-rw-r--r--src/bitvec.c17
1 files changed, 11 insertions, 6 deletions
diff --git a/src/bitvec.c b/src/bitvec.c
index 8ed7296a..f07b42c3 100644
--- a/src/bitvec.c
+++ b/src/bitvec.c
@@ -1,5 +1,3 @@
-/* bit vector utility routines */
-
/* (C) 2009 by Harald Welte <laforge@gnumonks.org>
* (C) 2012 Ivan Klyuchnikov
* (C) 2015 by Sysmocom s.f.m.c. GmbH
@@ -24,10 +22,17 @@
/*! \addtogroup bitvec
* @{
- * Osmocom bit vector abstraction
- */
-
-/*! \file bitvec.c */
+ * Osmocom bit vector abstraction utility routines.
+ *
+ * These functions assume a MSB (most significant bit) first layout of the
+ * bits, so that for instance the 5 bit number abcde (a is MSB) can be
+ * embedded into a byte sequence like in xxxxxxab cdexxxxx. The bit count
+ * starts with the MSB, so the bits in a byte are numbered (MSB) 01234567 (LSB).
+ * Note that there are other incompatible encodings, like it is used
+ * for the EGPRS RLC data block headers (there the bits are numbered from LSB
+ * to MSB).
+ *
+ * \file bitvec.c */
#include <errno.h>
#include <stdint.h>