From f0b97701d06a00cb7adba9dc329e474c2bf7b054 Mon Sep 17 00:00:00 2001
From: "tg(x)" <*@tg-x.net>
Date: Mon, 9 May 2011 14:37:57 +0200
Subject: [PATCH] doc

---
 include/psyc.h        | 14 ++++++--------
 include/psyc/packet.h | 17 +++++++++++++++++
 include/psyc/parse.h  |  5 ++---
 include/psyc/render.h |  5 ++---
 4 files changed, 27 insertions(+), 14 deletions(-)

diff --git a/include/psyc.h b/include/psyc.h
index 5bc0803..cafc026 100644
--- a/include/psyc.h
+++ b/include/psyc.h
@@ -1,20 +1,18 @@
-/** @file psyc.h
- *
+/**
+ * @file psyc.h
  * @brief Main PSYC interface providing crucial functionality.
-*/
+ */
 
-/** @mainpage PSYC Core Library
+/**
+ * @mainpage PSYC Core Library
  *
  * @section intro_sec Introduction
  *
  * Welcome to the libpsyc documentation!
  *
  * @section install_sec Installation
- *
- * @subsection step1 Step 1: Opening the box
- *
- * etc...
  */
+// * @subsection step1 Step 1: Opening the box
 
 #ifndef PSYC_H
 
diff --git a/include/psyc/packet.h b/include/psyc/packet.h
index becb0e4..ffb26a8 100644
--- a/include/psyc/packet.h
+++ b/include/psyc/packet.h
@@ -1,5 +1,20 @@
 #ifndef PSYC_PACKET_H
 
+/**
+ * @file psyc/packet.h
+ * @brief Interface for PSYC packet data structures.
+ *
+ * Packet data structures and functions for creating them are defined here.
+ */
+
+/**
+ * @defgroup packet Packet data structures
+ *
+ * This module contains definitions of packet data structures and functions for
+ * creating them.
+ * @{
+ */
+
 #include <psyc.h>
 #include <psyc/syntax.h>
 
@@ -142,5 +157,7 @@ psycPacket psyc_newRawPacket2 (psycModifier *routing, size_t routinglen,
                                const char *content, size_t contentlen,
                                psycPacketFlag flag);
 
+/** @} */ // end of packet group
+
 #define PSYC_PACKET_H
 #endif
diff --git a/include/psyc/parse.h b/include/psyc/parse.h
index 333f109..6628321 100644
--- a/include/psyc/parse.h
+++ b/include/psyc/parse.h
@@ -2,10 +2,9 @@
 
 /**
  * @file psyc/parse.h
- * @brief Interface for various PSYC parsing functions.
+ * @brief Interface for PSYC packet parsing.
  *
- * All parsing functions and the definitions they use are
- * defined in this file.
+ * All parsing functions and the definitions they use are defined here.
  */
 
 /**
diff --git a/include/psyc/render.h b/include/psyc/render.h
index e2620af..9f2bcd5 100644
--- a/include/psyc/render.h
+++ b/include/psyc/render.h
@@ -6,8 +6,7 @@
  * @file psyc/render.h
  * @brief Interface for PSYC packet rendering.
  *
- * All rendering functions and the definitions they use are
- * defined in this file.
+ * All rendering functions and the definitions they use are defined here.
  */
 
 /**
@@ -38,7 +37,7 @@ psycRenderRC psyc_render (psycPacket *packet, char *buffer, size_t buflen);
  */
 psycRenderRC psyc_renderList (psycList *list, char *buffer, size_t buflen);
 
-/** @} */ // end of renderer group
+/** @} */ // end of render group
 
 #define PSYC_RENDER_H
 #endif