some more doxygen stuff... still a LOT to go.

git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@252 d0543943-73ff-0310-b7d9-9358b9ac24b2

src/include/switch_channel.h

@@ -29,8 +29,8 @@
  * switch_channel.h -- Media Channel Interface
  *
  */
-/*! \file switch_channel.h
-    \brief Media Channel Interface
+/*! \file switch_channel.h
+    \brief Media Channel Interface
 */
 
 #ifndef SWITCH_CHANNEL_H
@@ -42,6 +42,10 @@ extern "C" {
 
 #include <switch.h>
 
+/*! \brief Get the current state of a channel in the state engine
+ * \param channel switch_channel object tot retreive state for
+ * \return state of a type in switch_channel_state enum
+ */
 SWITCH_DECLARE(switch_channel_state) switch_channel_get_state(switch_channel *channel);
 SWITCH_DECLARE(switch_channel_state) switch_channel_set_state(switch_channel *channel, switch_channel_state state);