diff rational.h @ 254:77e39bbb7219 libavutil

move doxy comments from rational.c to rational.h and add some new comments patch by Dujardin Bernard %dujardin P iut A numericable P fr%

--- a/rational.h	Mon Feb 26 08:52:21 2007 +0000
+++ b/rational.h	Mon Feb 26 14:27:29 2007 +0000
@@ -51,7 +51,7 @@
 }
 
 /**
- * Rational to double conversion
+ * Rational to double conversion.
  * @param a rational to convert
  * @return (double) a
  */
@@ -71,10 +71,44 @@
  */
 int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max);
 
+/**
+ * Multiplies two rationals.
+ * @param b first rational.
+ * @param c second rational.
+ * @return b*c.
+ */
 AVRational av_mul_q(AVRational b, AVRational c);
+
+/**
+ * Divides two rationals.
+ * @param b first rational.
+ * @param c second rational.
+ * @return b/c.
+ */
 AVRational av_div_q(AVRational b, AVRational c);
+
+/**
+ * Adds two rationals.
+ * @param b first rational.
+ * @param c second rational.
+ * @return b+c.
+ */
 AVRational av_add_q(AVRational b, AVRational c);
+
+/**
+ * Substracts two rationals.
+ * @param b first rational.
+ * @param c second rational.
+ * returns b-c.
+ */
 AVRational av_sub_q(AVRational b, AVRational c);
+
+/**
+ * Converts a double precision floating point number to a rational.
+ * @param d double to convert
+ * @param max the maximum allowed numerator and denominator
+ * @return (AVRational) d.
+ */
 AVRational av_d2q(double d, int max);
 
 #endif // RATIONAL_H