From 8cc2767891cfae7543e384d0dfb5286b33b1b42f Mon Sep 17 00:00:00 2001
From: Harald Welte <laforge@gnumonks.org>
Date: Mon, 16 Oct 2017 16:00:36 +0200
Subject: [PATCH] [doc] gea has separate group; A5 is not part of crypto but a5
 group

Change-Id: I2fd24c86f9b52244073ec800a3287e3d38e660d9
---
 include/osmocom/gsm/a5.h  |  2 --
 include/osmocom/gsm/gea.h |  9 +++++++--
 src/gsm/a5.c              | 18 ++++++++----------
 src/gsm/gea.c             |  7 +++----
 4 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/include/osmocom/gsm/a5.h b/include/osmocom/gsm/a5.h
index fae3fdd49..fa63246da 100644
--- a/include/osmocom/gsm/a5.h
+++ b/include/osmocom/gsm/a5.h
@@ -1,5 +1,3 @@
-/*! \file gsm/a5.h
- *  Osmocom GSM A5 ciphering algorithm header. */
 /*
  * Copyright (C) 2011  Sylvain Munaut <tnt@246tNt.com>
  *
diff --git a/include/osmocom/gsm/gea.h b/include/osmocom/gsm/gea.h
index 5c23d2ac0..fff9baa1d 100644
--- a/include/osmocom/gsm/gea.h
+++ b/include/osmocom/gsm/gea.h
@@ -1,5 +1,8 @@
-/*! \file gea.h
- * GEA3 header.
+/*! \defgroup gea GPRS GEA3/GEA4 ciphering algorithm
+ *  @{
+ *  \file gea.h
+ *
+ * GEA3/GEA4 header.
  *
  * See gea.c for details
  */
@@ -15,3 +18,5 @@ int gea3(uint8_t *out, uint16_t len, uint8_t *kc, uint32_t iv,
 
 int gea4(uint8_t *out, uint16_t len, uint8_t *kc, uint32_t iv,
 	 enum gprs_cipher_direction direct);
+
+/*! @} */
diff --git a/src/gsm/a5.c b/src/gsm/a5.c
index e906b6d9c..ea09e172f 100644
--- a/src/gsm/a5.c
+++ b/src/gsm/a5.c
@@ -1,10 +1,3 @@
-/*! \file a5.c
- * Full reimplementation of A5/1,2 (split and threadsafe).
- *
- * The logic behind the algorithm is taken from "A pedagogical implementation
- * of the GSM A5/1 and A5/2 "voice privacy" encryption algorithms." by
- * Marc Briceno, Ian Goldberg, and David Wagner.
- */
 /*
  * Copyright (C) 2011  Sylvain Munaut <tnt@246tNt.com>
  *
@@ -25,11 +18,16 @@
  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
-/*! \addtogroup crypto
+/*! \addtogroup a5
  *  @{
- *  Osmocom GSM/GPRS ciphering algorithm implementation
+ *  Osmocom GSM ciphering algorithm implementation
  *
- * \file gsm/a5.c */
+ *  Full reimplementation of A5/1,2,3,4 (split and threadsafe).
+ *
+ *  The logic behind the algorithm is taken from "A pedagogical implementation
+ *  of the GSM A5/1 and A5/2 "voice privacy" encryption algorithms." by
+ *  Marc Briceno, Ian Goldberg, and David Wagner.
+ */
 
 #include <errno.h>
 #include <string.h>
diff --git a/src/gsm/gea.c b/src/gsm/gea.c
index d95c03e89..70f08ada7 100644
--- a/src/gsm/gea.c
+++ b/src/gsm/gea.c
@@ -1,5 +1,3 @@
-/*! \file gea.c
- * Implementation of GEA3 and GEA4. */
 /*
  * Copyright (C) 2016 by Sysmocom s.f.m.c. GmbH
  *
@@ -28,9 +26,10 @@
 #include <stdint.h>
 #include <string.h>
 
-/*! \addtogroup crypto
+/*! \addtogroup gea
  *  @{
- * \file gsm/gea.c */
+ *  Implementation of GPRS Ciphers GEA3 and GEA4.
+ * \file gea.c */
 
 /*! Performs the GEA4 algorithm as in 3GPP TS 55.226 V9.0.0
  *  \param[in,out] out Buffer for gamma for encrypted/decrypted