[FFmpeg-cvslog] doc: developer: Fix wording in "naming conventions" section

Diego Biurrun git at videolan.org
Tue Feb 12 14:05:02 CET 2013


ffmpeg | branch: master | Diego Biurrun <diego at biurrun.de> | Mon Feb 11 18:39:12 2013 +0100| [56dea32f09e71460add14a1b6d0fbe6eb16f02a4] | committer: Diego Biurrun

doc: developer: Fix wording in "naming conventions" section

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=56dea32f09e71460add14a1b6d0fbe6eb16f02a4
---

 doc/developer.texi |   21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/doc/developer.texi b/doc/developer.texi
index a377ed1..b3e1513 100644
--- a/doc/developer.texi
+++ b/doc/developer.texi
@@ -178,27 +178,26 @@ GCC statement expressions (@samp{(x = (@{ int y = 4; y; @})}).
 @end itemize
 
 @subsection Naming conventions
-All names are using underscores (_), not CamelCase. For example,
- at samp{avfilter_get_video_buffer} is a valid function name and
- at samp{AVFilterGetVideo} is not. The only exception from this are structure
-names; they should always be in the CamelCase
+All names should be composed with underscores (_), not CamelCase. For example,
+ at samp{avfilter_get_video_buffer} is an acceptable function name and
+ at samp{AVFilterGetVideo} is not. The only exception are structure
+names; they should always be CamelCase.
 
-There are following conventions for naming variables and functions:
+There are the following conventions for naming variables and functions:
 @itemize @bullet
 @item
 For local variables no prefix is required.
 @item
-For variables and functions declared as @code{static} no prefixes are required.
+For variables and functions declared as @code{static} no prefix is required.
 @item
-For variables and functions used internally by the library, @code{ff_} prefix
-should be used.
-For example, @samp{ff_w64_demuxer}.
+For variables and functions used internally by a library an @code{ff_}
+prefix should be used, e.g. @samp{ff_w64_demuxer}.
 @item
 For variables and functions used internally across multiple libraries, use
 @code{avpriv_}. For example, @samp{avpriv_aac_parse_header}.
 @item
-For exported names, each library has its own prefixes. Just check the existing
-code and name accordingly.
+For externally visible symbols, each library has its own prefix. Check
+the existing code and choose names accordingly.
 @end itemize
 
 @subsection Miscellaneous conventions



More information about the ffmpeg-cvslog mailing list