Add pocketbus protocol.

[bertos.git] / kern / msg.h

diff --git a/kern/msg.h b/kern/msg.h
old mode 100755 (executable)
new mode 100644 (file)
index eb67b2e..3fa6a14
--- a/kern/msg.h
+++ b/kern/msg.h
@@ -1,9 +1,34 @@
-/*!
+/**
  * \file
  * <!--
+ * This file is part of BeRTOS.
+ *
+ * Bertos is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * As a special exception, you may use this file as part of a free software
+ * library without restriction.  Specifically, if other files instantiate
+ * templates or use macros or inline functions from this file, or you compile
+ * this file and link it with other files to produce an executable, this
+ * file does not by itself cause the resulting executable to be covered by
+ * the GNU General Public License.  This exception does not however
+ * invalidate any other reasons why the executable file might be covered by
+ * the GNU General Public License.
+ *
  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
  * Copyright 1999,2001 Bernardo Innocenti <bernie@develer.com>
- * This file is part of DevLib - See devlib/README for information.
+ *
  * -->
  *
  * \brief Simple inter-process messaging system
@@ -18,6 +43,15 @@
 
 /*#*
  *#* $Log$
+ *#* Revision 1.9  2006/07/19 12:56:27  bernie
+ *#* Convert to new Doxygen style.
+ *#*
+ *#* Revision 1.8  2005/11/04 16:20:02  bernie
+ *#* Fix reference to README.devlib in header.
+ *#*
+ *#* Revision 1.7  2005/02/09 21:48:30  bernie
+ *#* Doxygen fixes.
+ *#*
  *#* Revision 1.6  2005/01/22 04:20:26  bernie
  *#* Write extensive documentation; Add simple locking.
  *#*
@@ -44,7 +78,7 @@
 #include <mware/list.h>
 
 
-/*!
+/**
  * Handle queues of messages associated an action.
  *
  * A message port is an abstraction used to exchange information
@@ -176,24 +210,24 @@
  *                     }
  *             }
  *     }
- * \end code
+ * \endcode
  */
 typedef struct MsgPort
 {
-       List  queue;   /*!< Messages queued at this port. */
-       Event event;   /*!< Event to trigger when a message arrives. */
+       List  queue;   /**< Messages queued at this port. */
+       Event event;   /**< Event to trigger when a message arrives. */
 } MsgPort;
 
 
 typedef struct Msg
 {
-       Node     link;      /*!< Link into message port queue. */
-       MsgPort *replyPort; /*!< Port to which the msg is to be replied. */
+       Node     link;      /**< Link into message port queue. */
+       MsgPort *replyPort; /**< Port to which the msg is to be replied. */
        /* User data may follow */
 } Msg;
 
 
-/*!
+/**
  * Lock a message port.
  *
  * This is required before reading or manipulating
@@ -213,7 +247,7 @@ INLINE void msg_lockPort(MsgPort *port)
        proc_forbid();
 }
 
-/*!
+/**
  * Unlock a message port.
  *
  * \see msg_lockPort()
@@ -224,14 +258,14 @@ INLINE void msg_unlockPort(MsgPort *port)
 }
 
 
-/*! Initialize a message port */
+/** Initialize a message port */
 INLINE void msg_initPort(MsgPort *port, Event event)
 {
        LIST_INIT(&port->queue);
        port->event = event;
 }
 
-/*! Queue \a msg into \a port, triggering the associated event */
+/** Queue \a msg into \a port, triggering the associated event */
 INLINE void msg_put(MsgPort *port, Msg *msg)
 {
        msg_portLock(port);
@@ -241,7 +275,7 @@ INLINE void msg_put(MsgPort *port, Msg *msg)
        event_do(&port->event);
 }
 
-/*!
+/**
  * Get the first message from the queue of \a port.
  *
  * \return Pointer to the message or NULL if the port was empty.
@@ -257,7 +291,7 @@ INLINE Msg *msg_get(MsgPort *port)
        return msg;
 }
 
-/* Peek the first message in the queue of \a port, or NULL if the port is empty */
+/** Peek the first message in the queue of \a port, or NULL if the port is empty. */
 INLINE Msg *msg_peek(MsgPort *port)
 {
        Msg *msg;
@@ -271,7 +305,7 @@ INLINE Msg *msg_peek(MsgPort *port)
        return msg;
 }
 
-/*! Send back (reply) \a msg to its sender. */
+/** Send back (reply) \a msg to its sender. */
 INLINE void msg_reply(Msg *msg)
 {
        msg_put(msg->replyPort, msg);