More documentation changes (rawmidi, timer)

src/control/control.c

@@ -5,6 +5,7 @@
  * \date 2000
  *
  * CTL interface is designed to access primitive controls.
+ * See \ref control page for more details.
  */
 /*
  *  Control Interface - main file
@@ -27,6 +28,18 @@
  *
  */
 
+/*! \page control Control interface
+
+<P>Control interface is designed to access primitive controls. There is
+also interface notifying about control and structure changes.
+
+\section control_general_overview General overview
+
+The primitive controls can be integer, boolean, enumerators, bytes
+and IEC958 structure.
+
+*/
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <stdarg.h>

src/control/hcontrol.c

@@ -7,6 +7,7 @@
  *
  * HCTL interface is designed to access preloaded and sorted primitive controls.
  * Callbacks may be used for event handling.
+ * See \ref hcontrol page for more details.
  */
 /*
  *  Control Interface - highlevel API
@@ -30,6 +31,17 @@
  *
  */
 
+/*! \page hcontrol High level control interface
+
+<P> High level control interface is designed to access preloaded and sorted primitive controls.
+
+\section hcontrol_general_overview General overview
+
+<P> High level control interface caches the accesses to primitive controls
+to reduce overhead accessing the real controls in kernel drivers.
+
+*/
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <unistd.h>