[SCM] libav/experimental: Doxygen example
siretart at users.alioth.debian.org
siretart at users.alioth.debian.org
Sun Jun 30 15:40:58 UTC 2013
The following commit has been merged in the experimental branch:
commit f4888b830f44349de0bb137bc913ea6193adbe9e
Author: Michael Niedermayer <michaelni at gmx.at>
Date: Thu Jul 15 12:54:38 2004 +0000
Doxygen example
Originally committed as revision 3316 to svn://svn.ffmpeg.org/ffmpeg/trunk
diff --git a/doc/ffmpeg-doc.texi b/doc/ffmpeg-doc.texi
index 4d21dd8..211e7dd 100644
--- a/doc/ffmpeg-doc.texi
+++ b/doc/ffmpeg-doc.texi
@@ -987,11 +987,39 @@ Main priority in ffmpeg is simplicity and small code size (=less
bugs).
Comments: use the JavaDoc/Doxygen
-format (see examples in @file{libavformat/utils.c}) so that a documentation
+format (see examples below) so that a documentation
can be generated automatically. All non trivial functions should have a comment
above it explaining what the function does, even if its just one sentance.
All Structures and their member variables should be documented too.
-
+ at example
+/**
+ * @file mpeg.c
+ * mpeg codec.
+ * @author ...
+ */
+
+/**
+ * Summary sentance.
+ * more text ...
+ * ...
+ */
+typedef struct Foobar{
+ int var1; /**< var1 description */
+ int var2; ///< var2 description
+ /** var3 description */
+ int var3;
+} Foobar;
+
+/**
+ * Summary sentance.
+ * more text ...
+ * ...
+ * @param my_parameter description of my_parameter
+ * @return return value description
+ */
+int myfunc(int my_parameter)
+...
+ at end example
fprintf and printf are forbidden in libavformat and libavcodec,
please use av_log() instead.
--
Libav/FFmpeg packaging
More information about the pkg-multimedia-commits
mailing list