History

spelling/grammar/consistency review part I

Originally committed as revision 16840 to svn://svn.ffmpeg.org/ffmpeg/trunk

Diego Biurrun committed 17 years ago

Commit 89c9ff51 parent d972e5627 files · +175 −178Browse files

Unified · Split

27 files
  1. libavutil/avstring.h +2 −2
  2. libavutil/avutil.h +38 −38
  3. libavutil/bswap.h +2 −2
  4. libavutil/common.h +12 −12
  5. libavutil/crc.c +3 −3
  6. libavutil/crc.h +1 −1
  7. libavutil/fifo.c +2 −2
  8. libavutil/fifo.h +7 −7
  9. libavutil/integer.c +1 −1
  10. libavutil/integer.h +8 −7
  11. libavutil/internal.h +1 −1
  12. libavutil/intfloat_readwrite.c +2 −2
  13. libavutil/lfg.h +3 −3
  14. libavutil/lzo.c +10 −10
  15. libavutil/mathematics.c +1 −1
  16. libavutil/mathematics.h +10 −10
  17. libavutil/md5.c +8 −8
  18. libavutil/mem.c +8 −8
  19. libavutil/mem.h +18 −19
  20. libavutil/pca.c +3 −3
  21. libavutil/pca.h +2 −2
  22. libavutil/random.c +3 −3
  23. libavutil/rational.c +2 −2
  24. libavutil/rational.h +20 −20
  25. libavutil/sha1.c +1 −1
  26. libavutil/softfloat.h +6 −9
  27. libavutil/tree.c +1 −1
libavutil/avstring.h+2−2
@@ -48,7 +48,7 @@ int av_stristart(const char *str, const char *pfx, const char **ptr); · 47 unmodified lines
4848
4949 /**
5050 * Copy the string src to dst, but no more than size - 1 bytes, and
51− * null terminate dst.
51+ * null-terminate dst.
5252 *
5353 * This function is the same as BSD strlcpy().
5454 *
@@ -61,7 +61,7 @@ size_t av_strlcpy(char *dst, const char *src, size_t size); · 6 unmodified lines
6161
6262 /**
6363 * Append the string src to the string dst, but to a total length of
64− * no more than size - 1 bytes, and null terminate dst.
64+ * no more than size - 1 bytes, and null-terminate dst.
6565 *
6666 * This function is similar to BSD strlcat(), but differs when
6767 * size <= strlen(dst).
libavutil/avutil.h+38−38
@@ -62,11 +62,11 @@ unsigned avutil_version(void); · 61 unmodified lines
6262 /**
6363 * Pixel format. Notes:
6464 *
65− * PIX_FMT_RGB32 is handled in an endian-specific manner. A RGBA
65+ * PIX_FMT_RGB32 is handled in an endian-specific manner. An RGBA
6666 * color is put together as:
6767 * (A << 24) | (R << 16) | (G << 8) | B
68− * This is stored as BGRA on little endian CPU architectures and ARGB on
69− * big endian CPUs.
68+ * This is stored as BGRA on little-endian CPU architectures and ARGB on
69+ * big-endian CPUs.
7070 *
7171 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
7272 * image data is stored in AVFrame.data[0]. The palette is transported in
@@ -79,53 +79,53 @@ unsigned avutil_version(void); · 6 unmodified lines
7979 */
8080 enum PixelFormat {
8181 PIX_FMT_NONE= -1,
82− PIX_FMT_YUV420P, ///< Planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
83− PIX_FMT_YUYV422, ///< Packed YUV 4:2:2, 16bpp, Y0 Cb Y1 Cr
84− PIX_FMT_RGB24, ///< Packed RGB 8:8:8, 24bpp, RGBRGB...
85− PIX_FMT_BGR24, ///< Packed RGB 8:8:8, 24bpp, BGRBGR...
86− PIX_FMT_YUV422P, ///< Planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
87− PIX_FMT_YUV444P, ///< Planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
88− PIX_FMT_RGB32, ///< Packed RGB 8:8:8, 32bpp, (msb)8A 8R 8G 8B(lsb), in cpu endianness
89− PIX_FMT_YUV410P, ///< Planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
90− PIX_FMT_YUV411P, ///< Planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples)
91− PIX_FMT_RGB565, ///< Packed RGB 5:6:5, 16bpp, (msb) 5R 6G 5B(lsb), in cpu endianness
92− PIX_FMT_RGB555, ///< Packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), in cpu endianness most significant bit to 0
82+ PIX_FMT_YUV420P, ///< planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
83+ PIX_FMT_YUYV422, ///< packed YUV 4:2:2, 16bpp, Y0 Cb Y1 Cr
84+ PIX_FMT_RGB24, ///< packed RGB 8:8:8, 24bpp, RGBRGB...
85+ PIX_FMT_BGR24, ///< packed RGB 8:8:8, 24bpp, BGRBGR...
86+ PIX_FMT_YUV422P, ///< planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
87+ PIX_FMT_YUV444P, ///< planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
88+ PIX_FMT_RGB32, ///< packed RGB 8:8:8, 32bpp, (msb)8A 8R 8G 8B(lsb), in CPU endianness
89+ PIX_FMT_YUV410P, ///< planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
90+ PIX_FMT_YUV411P, ///< planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples)
91+ PIX_FMT_RGB565, ///< packed RGB 5:6:5, 16bpp, (msb) 5R 6G 5B(lsb), in CPU endianness
92+ PIX_FMT_RGB555, ///< packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), in CPU endianness, most significant bit to 0
9393 PIX_FMT_GRAY8, ///< Y , 8bpp
9494 PIX_FMT_MONOWHITE, ///< Y , 1bpp, 0 is white, 1 is black
9595 PIX_FMT_MONOBLACK, ///< Y , 1bpp, 0 is black, 1 is white
9696 PIX_FMT_PAL8, ///< 8 bit with PIX_FMT_RGB32 palette
97− PIX_FMT_YUVJ420P, ///< Planar YUV 4:2:0, 12bpp, full scale (jpeg)
98− PIX_FMT_YUVJ422P, ///< Planar YUV 4:2:2, 16bpp, full scale (jpeg)
99− PIX_FMT_YUVJ444P, ///< Planar YUV 4:4:4, 24bpp, full scale (jpeg)
97+ PIX_FMT_YUVJ420P, ///< planar YUV 4:2:0, 12bpp, full scale (JPEG)
98+ PIX_FMT_YUVJ422P, ///< planar YUV 4:2:2, 16bpp, full scale (JPEG)
99+ PIX_FMT_YUVJ444P, ///< planar YUV 4:4:4, 24bpp, full scale (JPEG)
100100 PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
101101 PIX_FMT_XVMC_MPEG2_IDCT,
102− PIX_FMT_UYVY422, ///< Packed YUV 4:2:2, 16bpp, Cb Y0 Cr Y1
103− PIX_FMT_UYYVYY411, ///< Packed YUV 4:1:1, 12bpp, Cb Y0 Y1 Cr Y2 Y3
104− PIX_FMT_BGR32, ///< Packed RGB 8:8:8, 32bpp, (msb)8A 8B 8G 8R(lsb), in cpu endianness
105− PIX_FMT_BGR565, ///< Packed RGB 5:6:5, 16bpp, (msb) 5B 6G 5R(lsb), in cpu endianness
106− PIX_FMT_BGR555, ///< Packed RGB 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), in cpu endianness most significant bit to 1
107− PIX_FMT_BGR8, ///< Packed RGB 3:3:2, 8bpp, (msb)2B 3G 3R(lsb)
108− PIX_FMT_BGR4, ///< Packed RGB 1:2:1, 4bpp, (msb)1B 2G 1R(lsb)
109− PIX_FMT_BGR4_BYTE, ///< Packed RGB 1:2:1, 8bpp, (msb)1B 2G 1R(lsb)
110− PIX_FMT_RGB8, ///< Packed RGB 3:3:2, 8bpp, (msb)2R 3G 3B(lsb)
111− PIX_FMT_RGB4, ///< Packed RGB 1:2:1, 4bpp, (msb)1R 2G 1B(lsb)
112− PIX_FMT_RGB4_BYTE, ///< Packed RGB 1:2:1, 8bpp, (msb)1R 2G 1B(lsb)
113− PIX_FMT_NV12, ///< Planar YUV 4:2:0, 12bpp, 1 plane for Y and 1 for UV
102+ PIX_FMT_UYVY422, ///< packed YUV 4:2:2, 16bpp, Cb Y0 Cr Y1
103+ PIX_FMT_UYYVYY411, ///< packed YUV 4:1:1, 12bpp, Cb Y0 Y1 Cr Y2 Y3
104+ PIX_FMT_BGR32, ///< packed RGB 8:8:8, 32bpp, (msb)8A 8B 8G 8R(lsb), in CPU endianness
105+ PIX_FMT_BGR565, ///< packed RGB 5:6:5, 16bpp, (msb) 5B 6G 5R(lsb), in CPU endianness
106+ PIX_FMT_BGR555, ///< packed RGB 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), in CPU endianness, most significant bit to 1
107+ PIX_FMT_BGR8, ///< packed RGB 3:3:2, 8bpp, (msb)2B 3G 3R(lsb)
108+ PIX_FMT_BGR4, ///< packed RGB 1:2:1, 4bpp, (msb)1B 2G 1R(lsb)
109+ PIX_FMT_BGR4_BYTE, ///< packed RGB 1:2:1, 8bpp, (msb)1B 2G 1R(lsb)
110+ PIX_FMT_RGB8, ///< packed RGB 3:3:2, 8bpp, (msb)2R 3G 3B(lsb)
111+ PIX_FMT_RGB4, ///< packed RGB 1:2:1, 4bpp, (msb)1R 2G 1B(lsb)
112+ PIX_FMT_RGB4_BYTE, ///< packed RGB 1:2:1, 8bpp, (msb)1R 2G 1B(lsb)
113+ PIX_FMT_NV12, ///< planar YUV 4:2:0, 12bpp, 1 plane for Y and 1 for UV
114114 PIX_FMT_NV21, ///< as above, but U and V bytes are swapped
115115
116− PIX_FMT_RGB32_1, ///< Packed RGB 8:8:8, 32bpp, (msb)8R 8G 8B 8A(lsb), in cpu endianness
117− PIX_FMT_BGR32_1, ///< Packed RGB 8:8:8, 32bpp, (msb)8B 8G 8R 8A(lsb), in cpu endianness
116+ PIX_FMT_RGB32_1, ///< packed RGB 8:8:8, 32bpp, (msb)8R 8G 8B 8A(lsb), in CPU endianness
117+ PIX_FMT_BGR32_1, ///< packed RGB 8:8:8, 32bpp, (msb)8B 8G 8R 8A(lsb), in CPU endianness
118118
119119 PIX_FMT_GRAY16BE, ///< Y , 16bpp, big-endian
120120 PIX_FMT_GRAY16LE, ///< Y , 16bpp, little-endian
121− PIX_FMT_YUV440P, ///< Planar YUV 4:4:0 (1 Cr & Cb sample per 1x2 Y samples)
122− PIX_FMT_YUVJ440P, ///< Planar YUV 4:4:0 full scale (jpeg)
123− PIX_FMT_YUVA420P, ///< Planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
124− PIX_FMT_VDPAU_H264,///< H264 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
125− PIX_FMT_VDPAU_MPEG1,///< MPEG1 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
126− PIX_FMT_VDPAU_MPEG2,///< MPEG2 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
121+ PIX_FMT_YUV440P, ///< planar YUV 4:4:0 (1 Cr & Cb sample per 1x2 Y samples)
122+ PIX_FMT_YUVJ440P, ///< planar YUV 4:4:0 full scale (JPEG)
123+ PIX_FMT_YUVA420P, ///< planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
124+ PIX_FMT_VDPAU_H264,///< H.264 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
125+ PIX_FMT_VDPAU_MPEG1,///< MPEG-1 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
126+ PIX_FMT_VDPAU_MPEG2,///< MPEG-2 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
127127 PIX_FMT_VDPAU_WMV3,///< WMV3 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
128− PIX_FMT_VDPAU_VC1, ///< VC1 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
128+ PIX_FMT_VDPAU_VC1, ///< VC-1 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
129129 PIX_FMT_NB, ///< number of pixel formats, DO NOT USE THIS if you want to link with shared libav* because the number of formats might differ between versions
130130 };
131131
libavutil/bswap.h+2−2
@@ -77,8 +77,8 @@ static inline uint64_t av_const bswap_64(uint64_t x) · 76 unmodified lines
7777 }
7878 #endif
7979
80−// be2me ... BigEndian to MachineEndian
81−// le2me ... LittleEndian to MachineEndian
80+// be2me ... big-endian to machine-endian
81+// le2me ... little-endian to machine-endian
8282
8383 #ifdef WORDS_BIGENDIAN
8484 #define be2me_16(x) (x)
libavutil/common.h+12−12
@@ -93,7 +93,7 @@ · 92 unmodified lines
9393 #endif
9494 #endif
9595
96−//rounded divison & shift
96+//rounded division & shift
9797 #define RSHIFT(a,b) ((a) > 0 ? ((a) + ((1<<(b))>>1))>>(b) : ((a) + ((1<<(b))>>1)-1)>>(b))
9898 /* assume b>0 */
9999 #define ROUNDED_DIV(a,b) (((a)>0 ? (a) + ((b)>>1) : (a) - ((b)>>1))/(b))
@@ -140,7 +140,7 @@ static inline av_const int av_log2_16bit(unsigned int v) · 40 unmodified lines
140140 }
141141
142142 /**
143− * clip a signed integer value into the amin-amax range
143+ * Clips a signed integer value into the amin-amax range.
144144 * @param a value to clip
145145 * @param amin minimum value of the clip range
146146 * @param amax maximum value of the clip range
@@ -154,7 +154,7 @@ static inline av_const int av_clip(int a, int amin, int amax) · 7 unmodified lines
154154 }
155155
156156 /**
157− * clip a signed integer value into the 0-255 range
157+ * Clips a signed integer value into the 0-255 range.
158158 * @param a value to clip
159159 * @return clipped value
160160 */
@@ -165,7 +165,7 @@ static inline av_const uint8_t av_clip_uint8(int a) · 4 unmodified lines
165165 }
166166
167167 /**
168− * clip a signed integer value into the -32768,32767 range
168+ * Clips a signed integer value into the -32768,32767 range.
169169 * @param a value to clip
170170 * @return clipped value
171171 */
@@ -176,7 +176,7 @@ static inline av_const int16_t av_clip_int16(int a) · 4 unmodified lines
176176 }
177177
178178 /**
179− * clip a float value into the amin-amax range
179+ * Clips a float value into the amin-amax range.
180180 * @param a value to clip
181181 * @param amin minimum value of the clip range
182182 * @param amax maximum value of the clip range
@@ -194,7 +194,7 @@ static inline av_const float av_clipf(float a, float amin, float amax) · 11 unmodified lines
194194
195195 /*!
196196 * \def GET_UTF8(val, GET_BYTE, ERROR)
197− * converts a UTF-8 character (up to 4 bytes long) to its 32-bit UCS-4 encoded form
197+ * Converts a UTF-8 character (up to 4 bytes long) to its 32-bit UCS-4 encoded form
198198 * \param val is the output and should be of type uint32_t. It holds the converted
199199 * UCS-4 character and should be a left value.
200200 * \param GET_BYTE gets UTF-8 encoded bytes from any proper source. It can be
@@ -222,19 +222,19 @@ static inline av_const float av_clipf(float a, float amin, float amax) · 21 unmodified lines
222222
223223 /*!
224224 * \def PUT_UTF8(val, tmp, PUT_BYTE)
225− * converts a 32-bit unicode character to its UTF-8 encoded form (up to 4 bytes long).
226− * \param val is an input only argument and should be of type uint32_t. It holds
227− * a ucs4 encoded unicode character that is to be converted to UTF-8. If
228− * val is given as a function it's executed only once.
225+ * Converts a 32-bit Unicode character to its UTF-8 encoded form (up to 4 bytes long).
226+ * \param val is an input-only argument and should be of type uint32_t. It holds
227+ * a UCS-4 encoded Unicode character that is to be converted to UTF-8. If
228+ * val is given as a function it is executed only once.
229229 * \param tmp is a temporary variable and should be of type uint8_t. It
230230 * represents an intermediate value during conversion that is to be
231− * outputted by PUT_BYTE.
231+ * output by PUT_BYTE.
232232 * \param PUT_BYTE writes the converted UTF-8 bytes to any proper destination.
233233 * It could be a function or a statement, and uses tmp as the input byte.
234234 * For example, PUT_BYTE could be "*output++ = tmp;" PUT_BYTE will be
235235 * executed up to 4 times for values in the valid UTF-8 range and up to
236236 * 7 times in the general case, depending on the length of the converted
237− * unicode character.
237+ * Unicode character.
238238 */
239239 #define PUT_UTF8(val, tmp, PUT_BYTE)\
240240 {\
libavutil/crc.c+3−3
@@ -86,7 +86,7 @@ int av_crc_init(AVCRC *ctx, int le, int bits, uint32_t poly, int ctx_size){ · 85 unmodified lines
8686 }
8787
8888 /**
89− * Get an initialized standard CRC table.
89+ * Gets an initialized standard CRC table.
9090 * @param crc_id ID of a standard CRC
9191 * @return a pointer to the CRC table or NULL on failure
9292 */
@@ -104,8 +104,8 @@ const AVCRC *av_crc_get_table(AVCRCId crc_id){ · 11 unmodified lines
104104 }
105105
106106 /**
107− * Calculate the CRC of a block
108− * @param crc CRC of previous blocks if any or initial value for CRC.
107+ * Calculates the CRC of a block.
108+ * @param crc CRC of previous blocks if any or initial value for CRC
109109 * @return CRC updated with the data from the given block
110110 *
111111 * @see av_crc_init() "le" parameter
libavutil/crc.h+1−1
@@ -33,7 +33,7 @@ typedef enum { · 32 unmodified lines
3333 AV_CRC_16_CCITT,
3434 AV_CRC_32_IEEE,
3535 AV_CRC_32_IEEE_LE, /*< reversed bitorder version of AV_CRC_32_IEEE */
36− AV_CRC_MAX, /*< not part of public API! don't use outside lavu */
36+ AV_CRC_MAX, /*< Not part of public API! Do not use outside libavutil. */
3737 }AVCRCId;
3838
3939 int av_crc_init(AVCRC *ctx, int le, int bits, uint32_t poly, int ctx_size);
libavutil/fifo.c+2−2
@@ -1,5 +1,5 @@
11 /*
2− * A very simple circular buffer FIFO implementation
2+ * a very simple circular buffer FIFO implementation
33 * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
44 * Copyright (c) 2006 Roman Shaposhnik
55 *
@@ -117,7 +117,7 @@ int av_fifo_generic_read(AVFifoBuffer *f, int buf_size, void (*func)(void*, void · 111 unmodified lines
117117 return 0;
118118 }
119119
120−/** discard data from the fifo */
120+/** Discard data from the FIFO. */
121121 void av_fifo_drain(AVFifoBuffer *f, int size)
122122 {
123123 f->rptr += size;
libavutil/fifo.h+7−7
@@ -18,7 +18,7 @@ · 17 unmodified lines
1818
1919 /**
2020 * @file fifo.h
21− * A very simple circular buffer FIFO implementation.
21+ * a very simple circular buffer FIFO implementation
2222 */
2323
2424 #ifndef AVUTIL_FIFO_H
@@ -64,7 +64,7 @@ int av_fifo_size(AVFifoBuffer *f); · 39 unmodified lines
6464 int av_fifo_read(AVFifoBuffer *f, uint8_t *buf, int buf_size);
6565
6666 /**
67− * Feeds data from an AVFifoBuffer to a user supplied callback.
67+ * Feeds data from an AVFifoBuffer to a user-supplied callback.
6868 * @param *f AVFifoBuffer to read from
6969 * @param buf_size number of bytes to read
7070 * @param *func generic read function
@@ -83,16 +83,16 @@ attribute_deprecated void av_fifo_write(AVFifoBuffer *f, const uint8_t *buf, int · 12 unmodified lines
8383 #endif
8484
8585 /**
86− * Feeds data from a user supplied callback to an AVFifoBuffer.
86+ * Feeds data from a user-supplied callback to an AVFifoBuffer.
8787 * @param *f AVFifoBuffer to write to
8888 * @param *src data source
8989 * @param size number of bytes to write
90− * @param *func generic write function. First parameter is src,
91− * second is dest_buf, third is dest_buf_size.
90+ * @param *func generic write function; the first parameter is src,
91+ * the second is dest_buf, the third is dest_buf_size.
9292 * func must return the number of bytes written to dest_buf, or <= 0 to
9393 * indicate no more data available to write.
9494 * If func is NULL, src is interpreted as a simple byte array for source data.
95− * @return the number of bytes written to the fifo.
95+ * @return the number of bytes written to the FIFO
9696 */
9797 int av_fifo_generic_write(AVFifoBuffer *f, void *src, int size, int (*func)(void*, void*, int));
9898
@@ -110,7 +110,7 @@ attribute_deprecated void av_fifo_realloc(AVFifoBuffer *f, unsigned int size); · 11 unmodified lines
110110 * Resizes an AVFifoBuffer.
111111 * @param *f AVFifoBuffer to resize
112112 * @param size new AVFifoBuffer size in bytes
113− * @return <0 for failure >=0 otherwise
113+ * @return <0 for failure, >=0 otherwise
114114 */
115115 int av_fifo_realloc2(AVFifoBuffer *f, unsigned int size);
116116
libavutil/integer.c+1−1
@@ -21,7 +21,7 @@ · 20 unmodified lines
2121
2222 /**
2323 * @file integer.c
24− * arbitrary precision integers.
24+ * arbitrary precision integers
2525 * @author Michael Niedermayer <michaelni@gmx.at>
2626 */
2727
libavutil/integer.h+8−7
@@ -48,29 +48,30 @@ int av_log2_i(AVInteger a) av_const; · 47 unmodified lines
4848 AVInteger av_mul_i(AVInteger a, AVInteger b) av_const;
4949
5050 /**
51− * returns 0 if a==b, 1 if a>b and -1 if a<b.
51+ * Returns 0 if a==b, 1 if a>b and -1 if a<b.
5252 */
5353 int av_cmp_i(AVInteger a, AVInteger b) av_const;
5454
5555 /**
56− * bitwise shift.
57− * @param s the number of bits by which the value should be shifted right, may be negative for shifting left
56+ * bitwise shift
57+ * @param s the number of bits by which the value should be shifted right,
58+ may be negative for shifting left
5859 */
5960 AVInteger av_shr_i(AVInteger a, int s) av_const;
6061
6162 /**
62− * returns a % b.
63− * @param quot a/b will be stored here
63+ * Returns a % b.
64+ * @param quot a/b will be stored here.
6465 */
6566 AVInteger av_mod_i(AVInteger *quot, AVInteger a, AVInteger b);
6667
6768 /**
68− * returns a/b.
69+ * Returns a/b.
6970 */
7071 AVInteger av_div_i(AVInteger a, AVInteger b) av_const;
7172
7273 /**
73− * converts the given int64_t to an AVInteger.
74+ * Converts the given int64_t to an AVInteger.
7475 */
7576 AVInteger av_int2i(int64_t a) av_const;
7677
libavutil/internal.h+1−1
@@ -20,7 +20,7 @@ · 19 unmodified lines
2020
2121 /**
2222 * @file internal.h
23− * common internal api header.
23+ * common internal API header
2424 */
2525
2626 #ifndef AVUTIL_INTERNAL_H
libavutil/intfloat_readwrite.c+2−2
@@ -22,7 +22,7 @@ · 21 unmodified lines
2222
2323 /**
2424 * @file intfloat_readwrite.c
25− * Portable IEEE float/double read/write functions.
25+ * portable IEEE float/double read/write functions
2626 */
2727
2828 #include "common.h"
@@ -51,7 +51,7 @@ double av_ext2dbl(const AVExtFloat ext){ · 22 unmodified lines
5151 return 0.0/0.0;
5252 e -= 16383 + 63; /* In IEEE 80 bits, the whole (i.e. 1.xxxx)
5353 * mantissa bit is written as opposed to the
54− * single and double precision formats */
54+ * single and double precision formats. */
5555 if (ext.exponent[0]&0x80)
5656 m= -m;
5757 return ldexp(m, e);
libavutil/lfg.h+3−3
@@ -30,7 +30,7 @@ typedef struct { · 29 unmodified lines
3030 void av_lfg_init(AVLFG *c, unsigned int seed);
3131
3232 /**
33− * Gets the next random unsigned 32bit number using a ALFG.
33+ * Gets the next random unsigned 32-bit number using an ALFG.
3434 *
3535 * Please also consider a simple LCG like state= state*1664525+1013904223,
3636 * it may be good enough and faster for your specific use case.
@@ -41,9 +41,9 @@ static inline unsigned int av_lfg_get(AVLFG *c){ · 4 unmodified lines
4141 }
4242
4343 /**
44− * Gets the next random unsigned 32bit number using a MLFG.
44+ * Gets the next random unsigned 32-bit number using a MLFG.
4545 *
46− * Please also consider the av_lfg_get() above, it is faster.
46+ * Please also consider av_lfg_get() above, it is faster.
4747 */
4848 static inline unsigned int av_mlfg_get(AVLFG *c){
4949 unsigned int a= c->state[(c->index-55) & 63];
libavutil/lzo.c+10−10
@@ -19,14 +19,14 @@ · 18 unmodified lines
1919 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
2020 */
2121 #include "common.h"
22−//! avoid e.g. MPlayers fast_memcpy, it slows things down here
22+//! Avoid e.g. MPlayers fast_memcpy, it slows things down here.
2323 #undef memcpy
2424 #include <string.h>
2525 #include "lzo.h"
2626
27−//! define if we may write up to 12 bytes beyond the output buffer
27+//! Define if we may write up to 12 bytes beyond the output buffer.
2828 #define OUTBUF_PADDED 1
29−//! define if we may read up to 8 bytes beyond the input buffer
29+//! Define if we may read up to 8 bytes beyond the input buffer.
3030 #define INBUF_PADDED 1
3131 typedef struct LZOContext {
3232 const uint8_t *in, *in_end;
@@ -52,7 +52,7 @@ static inline int get_byte(LZOContext *c) { · 19 unmodified lines
5252 #endif
5353
5454 /**
55− * \brief decode a length value in the coding used by lzo
55+ * \brief Decodes a length value in the coding used by lzo.
5656 * \param x previous byte value
5757 * \param mask bits used from x
5858 * \return decoded length value
@@ -80,7 +80,7 @@ static inline int get_len(LZOContext *c, int x, int mask) { · 21 unmodified lines
8080 #endif
8181
8282 /**
83− * \brief copy bytes from input to output buffer with checking
83+ * \brief Copies bytes from input to output buffer with checking.
8484 * \param cnt number of bytes to copy, must be >= 0
8585 */
8686 static inline void copy(LZOContext *c, int cnt) {
@@ -109,7 +109,7 @@ static inline void copy(LZOContext *c, int cnt) { · 22 unmodified lines
109109 static inline void memcpy_backptr(uint8_t *dst, int back, int cnt);
110110
111111 /**
112− * \brief copy previously decoded bytes to current position
112+ * \brief Copies previously decoded bytes to current position.
113113 * \param back how many bytes back we start
114114 * \param cnt number of bytes to copy, must be >= 0
115115 *
@@ -179,15 +179,15 @@ void av_memcpy_backptr(uint8_t *dst, int back, int cnt) { · 63 unmodified lines
179179 }
180180
181181 /**
182− * \brief decode LZO 1x compressed data
182+ * \brief Decodes LZO 1x compressed data.
183183 * \param out output buffer
184184 * \param outlen size of output buffer, number of bytes left are returned here
185185 * \param in input buffer
186186 * \param inlen size of input buffer, number of bytes left are returned here
187187 * \return 0 on success, otherwise error flags, see lzo.h
188188 *
189− * make sure all buffers are appropriately padded, in must provide
190− * LZO_INPUT_PADDING, out must provide LZO_OUTPUT_PADDING additional bytes
189+ * Make sure all buffers are appropriately padded, in must provide
190+ * LZO_INPUT_PADDING, out must provide LZO_OUTPUT_PADDING additional bytes.
191191 */
192192 int lzo1x_decode(void *out, int *outlen, const void *in, int *inlen) {
193193 int state= 0;
@@ -285,7 +285,7 @@ STOP_TIMER("lzod") · 91 unmodified lines
285285 if (memcmp(orig, decomp, s))
286286 av_log(NULL, AV_LOG_ERROR, "decompression incorrect\n");
287287 else
288− av_log(NULL, AV_LOG_ERROR, "decompression ok\n");
288+ av_log(NULL, AV_LOG_ERROR, "decompression OK\n");
289289 return 0;
290290 }
291291 #endif
libavutil/mathematics.c+1−1
@@ -20,7 +20,7 @@ · 19 unmodified lines
2020
2121 /**
2222 * @file mathematics.c
23− * Miscellaneous math routines and tables.
23+ * miscellaneous math routines and tables
2424 */
2525
2626 #include <assert.h>
libavutil/mathematics.h+10−10
@@ -42,29 +42,29 @@ · 41 unmodified lines
4242 #endif
4343
4444 enum AVRounding {
45− AV_ROUND_ZERO = 0, ///< round toward zero
46− AV_ROUND_INF = 1, ///< round away from zero
47− AV_ROUND_DOWN = 2, ///< round toward -infinity
48− AV_ROUND_UP = 3, ///< round toward +infinity
49− AV_ROUND_NEAR_INF = 5, ///< round to nearest and halfway cases away from zero
45+ AV_ROUND_ZERO = 0, ///< Round toward zero.
46+ AV_ROUND_INF = 1, ///< Round away from zero.
47+ AV_ROUND_DOWN = 2, ///< Round toward -infinity.
48+ AV_ROUND_UP = 3, ///< Round toward +infinity.
49+ AV_ROUND_NEAR_INF = 5, ///< Round to nearest and halfway cases away from zero.
5050 };
5151
5252 int64_t av_const av_gcd(int64_t a, int64_t b);
5353
5454 /**
55− * rescale a 64bit integer with rounding to nearest.
56− * a simple a*b/c isn't possible as it can overflow
55+ * Rescales a 64-bit integer with rounding to nearest.
56+ * A simple a*b/c isn't possible as it can overflow.
5757 */
5858 int64_t av_rescale(int64_t a, int64_t b, int64_t c) av_const;
5959
6060 /**
61− * rescale a 64bit integer with specified rounding.
62− * a simple a*b/c isn't possible as it can overflow
61+ * Rescales a 64-bit integer with specified rounding.
62+ * A simple a*b/c isn't possible as it can overflow.
6363 */
6464 int64_t av_rescale_rnd(int64_t a, int64_t b, int64_t c, enum AVRounding) av_const;
6565
6666 /**
67− * rescale a 64bit integer by 2 rational numbers.
67+ * Rescales a 64-bit integer by 2 rational numbers.
6868 */
6969 int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq) av_const;
7070
libavutil/md5.c+8−8
@@ -43,29 +43,29 @@ typedef struct AVMD5{ · 42 unmodified lines
4343 const int av_md5_size= sizeof(AVMD5);
4444
4545 static const uint8_t S[4][4] = {
46− { 7, 12, 17, 22 }, /* Round 1 */
47− { 5, 9, 14, 20 }, /* Round 2 */
48− { 4, 11, 16, 23 }, /* Round 3 */
49− { 6, 10, 15, 21 } /* Round 4 */
46+ { 7, 12, 17, 22 }, /* round 1 */
47+ { 5, 9, 14, 20 }, /* round 2 */
48+ { 4, 11, 16, 23 }, /* round 3 */
49+ { 6, 10, 15, 21 } /* round 4 */
5050 };
5151
5252 static const uint32_t T[64] = { // T[i]= fabs(sin(i+1)<<32)
53− 0xd76aa478, 0xe8c7b756, 0x242070db, 0xc1bdceee, /* Round 1 */
53+ 0xd76aa478, 0xe8c7b756, 0x242070db, 0xc1bdceee, /* round 1 */
5454 0xf57c0faf, 0x4787c62a, 0xa8304613, 0xfd469501,
5555 0x698098d8, 0x8b44f7af, 0xffff5bb1, 0x895cd7be,
5656 0x6b901122, 0xfd987193, 0xa679438e, 0x49b40821,
5757
58− 0xf61e2562, 0xc040b340, 0x265e5a51, 0xe9b6c7aa, /* Round 2 */
58+ 0xf61e2562, 0xc040b340, 0x265e5a51, 0xe9b6c7aa, /* round 2 */
5959 0xd62f105d, 0x02441453, 0xd8a1e681, 0xe7d3fbc8,
6060 0x21e1cde6, 0xc33707d6, 0xf4d50d87, 0x455a14ed,
6161 0xa9e3e905, 0xfcefa3f8, 0x676f02d9, 0x8d2a4c8a,
6262
63− 0xfffa3942, 0x8771f681, 0x6d9d6122, 0xfde5380c, /* Round 3 */
63+ 0xfffa3942, 0x8771f681, 0x6d9d6122, 0xfde5380c, /* round 3 */
6464 0xa4beea44, 0x4bdecfa9, 0xf6bb4b60, 0xbebfbc70,
6565 0x289b7ec6, 0xeaa127fa, 0xd4ef3085, 0x04881d05,
6666 0xd9d4d039, 0xe6db99e5, 0x1fa27cf8, 0xc4ac5665,
6767
68− 0xf4292244, 0x432aff97, 0xab9423a7, 0xfc93a039, /* Round 4 */
68+ 0xf4292244, 0x432aff97, 0xab9423a7, 0xfc93a039, /* round 4 */
6969 0x655b59c3, 0x8f0ccc92, 0xffeff47d, 0x85845dd1,
7070 0x6fa87e4f, 0xfe2ce6e0, 0xa3014314, 0x4e0811a1,
7171 0xf7537e82, 0xbd3af235, 0x2ad7d2bb, 0xeb86d391,
libavutil/mem.c+8−8
@@ -21,7 +21,7 @@ · 20 unmodified lines
2121
2222 /**
2323 * @file mem.c
24− * default memory allocator for libavutil.
24+ * default memory allocator for libavutil
2525 */
2626
2727 #include "config.h"
@@ -35,14 +35,14 @@ · 7 unmodified lines
3535
3636 #include "mem.h"
3737
38−/* here we can use OS dependent allocation functions */
38+/* here we can use OS-dependent allocation functions */
3939 #undef free
4040 #undef malloc
4141 #undef realloc
4242
43−/* you can redefine av_malloc and av_free in your project to use your
43+/* You can redefine av_malloc and av_free in your project to use your
4444 memory allocator. You do not need to suppress this file because the
45− linker will do it automatically */
45+ linker will do it automatically. */
4646
4747 void *av_malloc(unsigned int size)
4848 {
@@ -70,7 +70,7 @@ void *av_malloc(unsigned int size) · 21 unmodified lines
7070 Indeed, we should align it:
7171 on 4 for 386
7272 on 16 for 486
73− on 32 for 586, PPro - k6-III
73+ on 32 for 586, PPro - K6-III
7474 on 64 for K7 (maybe for P3 too).
7575 Because L1 and L2 caches are aligned on those values.
7676 But I don't want to code such logic here!
@@ -78,10 +78,10 @@ void *av_malloc(unsigned int size) · 1 unmodified line
7878 /* Why 16?
7979 Because some CPUs need alignment, for example SSE2 on P4, & most RISC CPUs
8080 it will just trigger an exception and the unaligned load will be done in the
81− exception handler or it will just segfault (SSE2 on P4)
81+ exception handler or it will just segfault (SSE2 on P4).
8282 Why not larger? Because I did not see a difference in benchmarks ...
8383 */
84− /* benchmarks with p3
84+ /* benchmarks with P3
8585 memalign(64)+1 3071,3051,3032
8686 memalign(64)+2 3051,3032,3041
8787 memalign(64)+4 2911,2896,2915
@@ -90,7 +90,7 @@ void *av_malloc(unsigned int size) · 2 unmodified lines
9090 memalign(64)+32 2546,2545,2571
9191 memalign(64)+64 2570,2533,2558
9292
93− btw, malloc seems to do 8 byte alignment by default here
93+ BTW, malloc seems to do 8-byte alignment by default here.
9494 */
9595 #else
9696 ptr = malloc(size);
libavutil/mem.h+18−19
@@ -20,7 +20,7 @@ · 19 unmodified lines
2020
2121 /**
2222 * @file mem.h
23− * Memory handling functions.
23+ * memory handling functions
2424 */
2525
2626 #ifndef AVUTIL_MEM_H
@@ -41,31 +41,31 @@ · 14 unmodified lines
4141 #endif
4242
4343 /**
44− * Allocate a block of \p size bytes with alignment suitable for all
44+ * Allocates a block of \p size bytes with alignment suitable for all
4545 * memory accesses (including vectors if available on the CPU).
4646 * @param size Size in bytes for the memory block to be allocated.
47− * @return Pointer to the allocated block, NULL if it cannot allocate
48− * it.
47+ * @return Pointer to the allocated block, NULL if the block cannot
48+ * be allocated.
4949 * @see av_mallocz()
5050 */
5151 void *av_malloc(unsigned int size) av_malloc_attrib av_alloc_size(1);
5252
5353 /**
54− * Allocate or reallocate a block of memory.
55− * If \p ptr is NULL and \p size > 0, allocate a new block. If \p
56− * size is zero, free the memory block pointed by \p ptr.
54+ * Allocates or reallocates a block of memory.
55+ * If \p ptr is NULL and \p size > 0, allocates a new block. If \p
56+ * size is zero, frees the memory block pointed to by \p ptr.
5757 * @param size Size in bytes for the memory block to be allocated or
5858 * reallocated.
5959 * @param ptr Pointer to a memory block already allocated with
6060 * av_malloc(z)() or av_realloc() or NULL.
61− * @return Pointer to a newly reallocated block or NULL if it cannot
62− * reallocate or the function is used to free the memory block.
61+ * @return Pointer to a newly reallocated block or NULL if the block
62+ * cannot be reallocated or the function is used to free the memory block.
6363 * @see av_fast_realloc()
6464 */
6565 void *av_realloc(void *ptr, unsigned int size) av_alloc_size(2);
6666
6767 /**
68− * Free a memory block which has been allocated with av_malloc(z)() or
68+ * Frees a memory block which has been allocated with av_malloc(z)() or
6969 * av_realloc().
7070 * @param ptr Pointer to the memory block which should be freed.
7171 * @note ptr = NULL is explicitly allowed.
@@ -75,27 +75,26 @@ void *av_realloc(void *ptr, unsigned int size) av_alloc_size(2); · 3 unmodified lines
7575 void av_free(void *ptr);
7676
7777 /**
78− * Allocate a block of \p size bytes with alignment suitable for all
78+ * Allocates a block of \p size bytes with alignment suitable for all
7979 * memory accesses (including vectors if available on the CPU) and
80− * set to zeroes all the bytes of the block.
80+ * zeroes all the bytes of the block.
8181 * @param size Size in bytes for the memory block to be allocated.
82− * @return Pointer to the allocated block, NULL if it cannot allocate
83− * it.
82+ * @return Pointer to the allocated block, NULL if it cannot be allocated.
8483 * @see av_malloc()
8584 */
8685 void *av_mallocz(unsigned int size) av_malloc_attrib av_alloc_size(1);
8786
8887 /**
89− * Duplicate the string \p s.
90− * @param s String to be duplicated.
88+ * Duplicates the string \p s.
89+ * @param s string to be duplicated
9190 * @return Pointer to a newly allocated string containing a
92− * copy of \p s or NULL if it cannot be allocated.
91+ * copy of \p s or NULL if the string cannot be allocated.
9392 */
9493 char *av_strdup(const char *s) av_malloc_attrib;
9594
9695 /**
97− * Free a memory block which has been allocated with av_malloc(z)() or
98− * av_realloc() and set to NULL the pointer to it.
96+ * Frees a memory block which has been allocated with av_malloc(z)() or
97+ * av_realloc() and set the pointer pointing to it to NULL.
9998 * @param ptr Pointer to the pointer to the memory block which should
10099 * be freed.
101100 * @see av_free()
libavutil/pca.c+3−3
@@ -1,5 +1,5 @@
11 /*
2− * Principal component analysis
2+ * principal component analysis (PCA)
33 * Copyright (c) 2004 Michael Niedermayer <michaelni@gmx.at>
44 *
55 * This file is part of FFmpeg.
@@ -21,7 +21,7 @@ · 15 unmodified lines
2121
2222 /**
2323 * @file pca.c
24− * Principal component analysis
24+ * principal component analysis (PCA)
2525 */
2626
2727 #include "common.h"
@@ -120,7 +120,7 @@ int ff_pca(PCA *pca, double *eigenvector, double *eigenvalue){ · 92 unmodified lines
120120
121121 if(pass < 3 && fabs(covar) < sum / (5*n*n)) //FIXME why pass < 3
122122 continue;
123− if(fabs(covar) == 0.0) //FIXME shouldnt be needed
123+ if(fabs(covar) == 0.0) //FIXME should not be needed
124124 continue;
125125 if(pass >=3 && fabs((eigenvalue[j]+z[j])/covar) > (1LL<<32) && fabs((eigenvalue[i]+z[i])/covar) > (1LL<<32)){
126126 pca->covariance[j + i*n]=0.0;
libavutil/pca.h+2−2
@@ -1,5 +1,5 @@
11 /*
2− * Principal component analysis
2+ * principal component analysis (PCA)
33 * Copyright (c) 2004 Michael Niedermayer <michaelni@gmx.at>
44 *
55 * This file is part of FFmpeg.
@@ -21,7 +21,7 @@ · 15 unmodified lines
2121
2222 /**
2323 * @file pca.h
24− * Principal component analysis
24+ * principal component analysis (PCA)
2525 */
2626
2727 #ifndef AVUTIL_PCA_H
libavutil/random.c+3−3
@@ -29,19 +29,19 @@ see http://en.wikipedia.org/wiki/Mersenne_twister for an explanation of this alg · 28 unmodified lines
2929 #include "random.h"
3030
3131
32−/* Period parameters */
32+/* period parameters */
3333 #define M 397
3434 #define A 0x9908b0df /* constant vector a */
3535 #define UPPER_MASK 0x80000000 /* most significant w-r bits */
3636 #define LOWER_MASK 0x7fffffff /* least significant r bits */
3737
38−/** initializes mt[AV_RANDOM_N] with a seed */
38+/** Initializes mt[AV_RANDOM_N] with a seed. */
3939 void av_random_init(AVRandomState *state, unsigned int seed)
4040 {
4141 int index;
4242
4343 /*
44− This differs from the wikipedia article. Source is from the
44+ This differs from the Wikipedia article. Source is from the
4545 Makoto Matsumoto and Takuji Nishimura code, with the following comment:
4646 */
4747 /* See Knuth TAOCP Vol2. 3rd Ed. P.106 for multiplier. */
libavutil/rational.c+2−2
@@ -1,5 +1,5 @@
11 /*
2− * Rational numbers
2+ * rational numbers
33 * Copyright (c) 2003 Michael Niedermayer <michaelni@gmx.at>
44 *
55 * This file is part of FFmpeg.
@@ -21,7 +21,7 @@ · 15 unmodified lines
2121
2222 /**
2323 * @file rational.c
24− * Rational numbers
24+ * rational numbers
2525 * @author Michael Niedermayer <michaelni@gmx.at>
2626 */
2727
libavutil/rational.h+20−20
@@ -1,5 +1,5 @@
11 /*
2− * Rational numbers
2+ * rational numbers
33 * Copyright (c) 2003 Michael Niedermayer <michaelni@gmx.at>
44 *
55 * This file is part of FFmpeg.
@@ -21,7 +21,7 @@ · 15 unmodified lines
2121
2222 /**
2323 * @file rational.h
24− * Rational numbers.
24+ * rational numbers
2525 * @author Michael Niedermayer <michaelni@gmx.at>
2626 */
2727
@@ -32,7 +32,7 @@ · 4 unmodified lines
3232 #include "common.h"
3333
3434 /**
35− * Rational number num/den.
35+ * rational number numerator/denominator
3636 */
3737 typedef struct AVRational{
3838 int num; ///< numerator
@@ -40,10 +40,10 @@ typedef struct AVRational{ · 1 unmodified line
4040 } AVRational;
4141
4242 /**
43− * Compare two rationals.
43+ * Compares two rationals.
4444 * @param a first rational
4545 * @param b second rational
46− * @return 0 if a==b, 1 if a>b and -1 if a<b.
46+ * @return 0 if a==b, 1 if a>b and -1 if a<b
4747 */
4848 static inline int av_cmp_q(AVRational a, AVRational b){
4949 const int64_t tmp= a.num * (int64_t)b.den - b.num * (int64_t)a.den;
@@ -53,7 +53,7 @@ static inline int av_cmp_q(AVRational a, AVRational b){ · 3 unmodified lines
5353 }
5454
5555 /**
56− * Rational to double conversion.
56+ * Converts rational to double.
5757 * @param a rational to convert
5858 * @return (double) a
5959 */
@@ -62,7 +62,7 @@ static inline double av_q2d(AVRational a){ · 2 unmodified lines
6262 }
6363
6464 /**
65− * Reduce a fraction.
65+ * Reduces a fraction.
6666 * This is useful for framerate calculations.
6767 * @param dst_nom destination numerator
6868 * @param dst_den destination denominator
@@ -75,33 +75,33 @@ int av_reduce(int *dst_nom, int *dst_den, int64_t nom, int64_t den, int64_t max) · 6 unmodified lines
7575
7676 /**
7777 * Multiplies two rationals.
78− * @param b first rational.
79− * @param c second rational.
80− * @return b*c.
78+ * @param b first rational
79+ * @param c second rational
80+ * @return b*c
8181 */
8282 AVRational av_mul_q(AVRational b, AVRational c) av_const;
8383
8484 /**
8585 * Divides one rational by another.
86− * @param b first rational.
87− * @param c second rational.
88− * @return b/c.
86+ * @param b first rational
87+ * @param c second rational
88+ * @return b/c
8989 */
9090 AVRational av_div_q(AVRational b, AVRational c) av_const;
9191
9292 /**
9393 * Adds two rationals.
94− * @param b first rational.
95− * @param c second rational.
96− * @return b+c.
94+ * @param b first rational
95+ * @param c second rational
96+ * @return b+c
9797 */
9898 AVRational av_add_q(AVRational b, AVRational c) av_const;
9999
100100 /**
101101 * Subtracts one rational from another.
102− * @param b first rational.
103− * @param c second rational.
104− * @return b-c.
102+ * @param b first rational
103+ * @param c second rational
104+ * @return b-c
105105 */
106106 AVRational av_sub_q(AVRational b, AVRational c) av_const;
107107
@@ -109,7 +109,7 @@ AVRational av_sub_q(AVRational b, AVRational c) av_const; · 1 unmodified line
109109 * Converts a double precision floating point number to a rational.
110110 * @param d double to convert
111111 * @param max the maximum allowed numerator and denominator
112− * @return (AVRational) d.
112+ * @return (AVRational) d
113113 */
114114 AVRational av_d2q(double d, int max) av_const;
115115
libavutil/sha1.c+1−1
@@ -168,7 +168,7 @@ int main(void){ · 167 unmodified lines
168168 printf("%02X", digest[i]);
169169 putchar('\n');
170170 }
171− //Test Vectors (from FIPS PUB 180-1)
171+ //test vectors (from FIPS PUB 180-1)
172172 printf("A9993E36 4706816A BA3E2571 7850C26C 9CD0D89D\n"
173173 "84983E44 1C3BD26E BAAE4AA1 F95129E5 E54670F1\n"
174174 "34AA973C D4C4DAA4 F61EEB2B DBAD2731 6534016F\n");
libavutil/softfloat.h+6−9
@@ -72,10 +72,9 @@ static inline av_const SoftFloat av_normalize1_sf(SoftFloat a){ · 71 unmodified lines
7272 }
7373
7474 /**
75− *
76− * @return will not be more denormalized then a+b, so if either input is
77− * normalized then the output will not be worse then the other input
78− * if both are normalized then the output will be normalized
75+ * @return Will not be more denormalized than a+b. So if either input is
76+ * normalized, then the output will not be worse then the other input.
77+ * If both are normalized, then the output will be normalized.
7978 */
8079 static inline av_const SoftFloat av_mul_sf(SoftFloat a, SoftFloat b){
8180 a.exp += b.exp;
@@ -84,9 +83,8 @@ static inline av_const SoftFloat av_mul_sf(SoftFloat a, SoftFloat b){ · 2 unmodified lines
8483 }
8584
8685 /**
87− *
88− * b has to be normalized and not zero
89− * @return will not be more denormalized then a
86+ * b has to be normalized and not zero.
87+ * @return Will not be more denormalized than a.
9088 */
9189 static av_const SoftFloat av_div_sf(SoftFloat a, SoftFloat b){
9290 a.exp -= b.exp+1;
@@ -117,8 +115,7 @@ static inline av_const SoftFloat av_int2sf(int v, int frac_bits){ · 24 unmodified lines
117115 }
118116
119117 /**
120− *
121− * rounding is to -inf
118+ * Rounding is to -inf.
122119 */
123120 static inline av_const int av_sf2int(SoftFloat v, int frac_bits){
124121 v.exp += frac_bits - ONE_BITS;
libavutil/tree.c+1−1
@@ -199,7 +199,7 @@ int main(void){ · 198 unmodified lines
199199 av_tree_insert(&root, (void*)(j+1), cmp, &node2);
200200 k= av_tree_find(root, (void*)(j+1), cmp, NULL);
201201 if(k)
202− av_log(NULL, AV_LOG_ERROR, "removial failure %d\n", i);
202+ av_log(NULL, AV_LOG_ERROR, "removal failure %d\n", i);
203203 }
204204 }
205205 return 0;

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t