From 77177335f041c622df5afae79ae8670529c3341a Mon Sep 17 00:00:00 2001
From: Aurelien Jacobs <aurel@gnuage.org>
Date: Mon, 1 May 2006 00:27:24 +0000
Subject: [PATCH] document clip functions

Originally committed as revision 5338 to svn://svn.ffmpeg.org/ffmpeg/trunk
---
 libavutil/common.h | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/libavutil/common.h b/libavutil/common.h
index 92c0d08552..ae325122a5 100644
--- a/libavutil/common.h
+++ b/libavutil/common.h
@@ -427,6 +427,13 @@ static inline int mid_pred(int a, int b, int c)
 #endif
 }
 
+/**
+ * clip a signed integer value into the amin-amax range
+ * @param a value to clip
+ * @param amin minimum value of the clip range
+ * @param amax maximum value of the clip range
+ * @return cliped value
+ */
 static inline int clip(int a, int amin, int amax)
 {
     if (a < amin)
@@ -437,6 +444,11 @@ static inline int clip(int a, int amin, int amax)
         return a;
 }
 
+/**
+ * clip a signed integer value into the 0-255 range
+ * @param a value to clip
+ * @return cliped value
+ */
 static inline uint8_t clip_uint8(int a)
 {
     if (a&(~255)) return (-a)>>31;