// $Id$
-/* tab:4
+/*
* "Copyright (c) 2004-5 The Regents of the University of California.
* All rights reserved.
*
* Clear out this packet. Note that this is a deep operation and
* total operation: calling clear() on any layer will completely
* clear the packet for reuse.
- * @param msg the packet to clear
+ * @param 'message_t* ONE msg' the packet to clear
*/
command void clear(message_t* msg);
* sized data regions, then payloadLength() will always return
* the same value as maxPayloadLength().
*
- * @param msg the packet to examine
+ * @param 'message_t* ONE msg' the packet to examine
* @return the length of its current payload
*/
* specified in the request and later recover it when actually
* sending.
*
- * @param msg the packet
+ * @param 'message_t* ONE msg' the packet
* @param len the value to set its length field to
*/
* a given <tt>msg</tt> this command will always return the same
* pointer or NULL.
*
- * @param msg the packet
+ * @param 'message_t* ONE msg' the packet
* @param len the length of payload required
- * @return a pointer to the packet's data payload for this layer
+ * @return 'void* COUNT_NOK(len)' a pointer to the packet's data payload for this layer
* or NULL if <tt>len</tt> is too big
*/
command void* getPayload(message_t* msg, uint8_t len);