From 263178fbb653703273ca3684f16de0ee185f0ae1 Mon Sep 17 00:00:00 2001
From: Dean Camera <dean@fourwalledcubicle.com>
Date: Sun, 29 Aug 2010 07:49:36 +0000
Subject: [PATCH] Add better description of the Ultra-Lightweight Ring Buffer
 header files.

---
 LUFA/ManPages/FutureChanges.txt                 | 2 ++
 Projects/Benito/Lib/LightweightRingBuff.h       | 9 ++++++++-
 Projects/USBtoSerial/Lib/LightweightRingBuff.h  | 9 ++++++++-
 Projects/XPLAINBridge/Lib/LightweightRingBuff.h | 9 ++++++++-
 4 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/LUFA/ManPages/FutureChanges.txt b/LUFA/ManPages/FutureChanges.txt
index 020779b97..d30d45d9a 100644
--- a/LUFA/ManPages/FutureChanges.txt
+++ b/LUFA/ManPages/FutureChanges.txt
@@ -17,10 +17,12 @@
   *      -# Add ability to get number of bytes not written with pipe/endpoint write routines after an error
   *      -# Add standardized descriptor names to class driver structures
   *      -# Change makefiles to allow for absolute LUFA location to be used
+  *      -# Re-add interrupt Pipe/Endpoint support
   *  - Documentation/Support
   *      -# Add detailed overviews of how each demo works
   *      -# Add board overviews
   *      -# Write LUFA tutorials
+  *      -# Add makefile template
   *  - Demos/Projects
   *      -# Multiple-Report HID device
   *      -# Device/Host USB bridge
diff --git a/Projects/Benito/Lib/LightweightRingBuff.h b/Projects/Benito/Lib/LightweightRingBuff.h
index cb0f6112a..768e49a50 100644
--- a/Projects/Benito/Lib/LightweightRingBuff.h
+++ b/Projects/Benito/Lib/LightweightRingBuff.h
@@ -30,7 +30,14 @@
 
 /** \file
  *
- *  Ultra lightweight ring buffer, for fast insertion/deletion.
+ *  Ultra lightweight ring buffer, for fast insertion/deletion. This uses inlined functions
+ *  for maximum speed. All buffers created with this library must be of the same size, however
+ *  multiple independant buffers can be created.
+ *
+ *  Note that for each buffer, insertion and removal operations may occur at the same time (via
+ *  a multithreaded ISR based system) however the same kind of operation (two or more insertions
+ *  or deletions) must not overlap. If there is possibility of two or more of the same kind of
+ *  operating occuring at the same point in time, atomic (mutex) locking should be used.
  */
  
 #ifndef _ULW_RING_BUFF_H_
diff --git a/Projects/USBtoSerial/Lib/LightweightRingBuff.h b/Projects/USBtoSerial/Lib/LightweightRingBuff.h
index cb0f6112a..768e49a50 100644
--- a/Projects/USBtoSerial/Lib/LightweightRingBuff.h
+++ b/Projects/USBtoSerial/Lib/LightweightRingBuff.h
@@ -30,7 +30,14 @@
 
 /** \file
  *
- *  Ultra lightweight ring buffer, for fast insertion/deletion.
+ *  Ultra lightweight ring buffer, for fast insertion/deletion. This uses inlined functions
+ *  for maximum speed. All buffers created with this library must be of the same size, however
+ *  multiple independant buffers can be created.
+ *
+ *  Note that for each buffer, insertion and removal operations may occur at the same time (via
+ *  a multithreaded ISR based system) however the same kind of operation (two or more insertions
+ *  or deletions) must not overlap. If there is possibility of two or more of the same kind of
+ *  operating occuring at the same point in time, atomic (mutex) locking should be used.
  */
  
 #ifndef _ULW_RING_BUFF_H_
diff --git a/Projects/XPLAINBridge/Lib/LightweightRingBuff.h b/Projects/XPLAINBridge/Lib/LightweightRingBuff.h
index cb0f6112a..768e49a50 100644
--- a/Projects/XPLAINBridge/Lib/LightweightRingBuff.h
+++ b/Projects/XPLAINBridge/Lib/LightweightRingBuff.h
@@ -30,7 +30,14 @@
 
 /** \file
  *
- *  Ultra lightweight ring buffer, for fast insertion/deletion.
+ *  Ultra lightweight ring buffer, for fast insertion/deletion. This uses inlined functions
+ *  for maximum speed. All buffers created with this library must be of the same size, however
+ *  multiple independant buffers can be created.
+ *
+ *  Note that for each buffer, insertion and removal operations may occur at the same time (via
+ *  a multithreaded ISR based system) however the same kind of operation (two or more insertions
+ *  or deletions) must not overlap. If there is possibility of two or more of the same kind of
+ *  operating occuring at the same point in time, atomic (mutex) locking should be used.
  */
  
 #ifndef _ULW_RING_BUFF_H_
-- 
GitLab