X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/11bb2f21720c2af4b29732ca128963869e5c512c..19ecd04f37f68c0674f1194aa8d8a4fc94d6168b:/LUFA/Common/Common.h

diff --git a/LUFA/Common/Common.h b/LUFA/Common/Common.h
index 24ba1f68b..f64de8ff8 100644
--- a/LUFA/Common/Common.h
+++ b/LUFA/Common/Common.h
@@ -1,21 +1,21 @@
 /*
              LUFA Library
-     Copyright (C) Dean Camera, 2009.
+     Copyright (C) Dean Camera, 2010.
               
   dean [at] fourwalledcubicle [dot] com
       www.fourwalledcubicle.com
 */
 
 /*
-  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)
-
-  Permission to use, copy, modify, and distribute this software
-  and its documentation for any purpose and without fee is hereby
-  granted, provided that the above copyright notice appear in all
-  copies and that both that the copyright notice and this
-  permission notice and warranty disclaimer appear in supporting
-  documentation, and that the name of the author not be used in
-  advertising or publicity pertaining to distribution of the
+  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+  Permission to use, copy, modify, distribute, and sell this 
+  software and its documentation for any purpose is hereby granted
+  without fee, provided that the above copyright notice appear in 
+  all copies and that both that the copyright notice and this
+  permission notice and warranty disclaimer appear in supporting 
+  documentation, and that the name of the author not be used in 
+  advertising or publicity pertaining to distribution of the 
   software without specific, written prior permission.
 
   The author disclaim all warranties with regard to this
@@ -29,6 +29,7 @@
 */
 
 /** \file
+ *  \brief Common library convenience macros and functions.
  *
  *  This file contains macros which are common to all library elements, and which may be useful in user code. It
  *  also includes other common headers, such as Atomic.h, FunctionAttributes.h and BoardTypes.h.
@@ -57,13 +58,9 @@
 
 	/* Includes: */
 		#include <avr/io.h>
-		#include <stdio.h>
-		#include <avr/version.h>
-		
+	
 		#include "FunctionAttributes.h"
 		#include "BoardTypes.h"
-		
-		#include <alloca.h>
 
 	/* Public Interface - May be used in end-application: */
 		/* Macros: */		
@@ -121,7 +118,7 @@
 			 *
 			 *  \ingroup Group_BitManip
 			 *
-			 *  \param Byte   Byte of data whose bits are to be reversed
+			 *  \param[in] Byte   Byte of data whose bits are to be reversed
 			 */
 			static inline uint8_t BitReverse(uint8_t Byte) ATTR_WARN_UNUSED_RESULT ATTR_CONST;
 			static inline uint8_t BitReverse(uint8_t Byte)
@@ -137,7 +134,7 @@
 			 *
 			 *  \ingroup Group_BitManip
 			 *
-			 *  \param Word   Word of data whose bytes are to be swapped
+			 *  \param[in] Word   Word of data whose bytes are to be swapped
 			 */
 			static inline uint16_t SwapEndian_16(uint16_t Word) ATTR_WARN_UNUSED_RESULT ATTR_CONST;
 			static inline uint16_t SwapEndian_16(uint16_t Word)
@@ -149,7 +146,7 @@
 			 *
 			 *  \ingroup Group_BitManip
 			 *
-			 *  \param DWord   Double word of data whose bytes are to be swapped
+			 *  \param[in] DWord   Double word of data whose bytes are to be swapped
 			 */
 			static inline uint32_t SwapEndian_32(uint32_t DWord) ATTR_WARN_UNUSED_RESULT ATTR_CONST;
 			static inline uint32_t SwapEndian_32(uint32_t DWord)
@@ -164,8 +161,8 @@
 			 *
 			 *  \ingroup Group_BitManip
 			 *
-			 *  \param Data   Pointer to a number containing an even number of bytes to be reversed
-			 *  \param Bytes  Length of the data in bytes
+			 *  \param[in,out] Data  Pointer to a number containing an even number of bytes to be reversed
+			 *  \param[in] Bytes  Length of the data in bytes
 			 */
 			static inline void SwapEndian_n(uint8_t* Data, uint8_t Bytes);
 			static inline void SwapEndian_n(uint8_t* Data, uint8_t Bytes)
@@ -176,7 +173,7 @@
 				{
 					Temp = *Data;
 					*Data = *(Data + Bytes - 1);
-					*(Data + Bytes) = Temp;
+					*(Data + Bytes - 1) = Temp;
 
 					Data++;
 					Bytes -= 2;