diff options
author | Diego Biurrun <diego@biurrun.de> | 2013-03-17 00:57:12 +0100 |
---|---|---|
committer | Diego Biurrun <diego@biurrun.de> | 2013-03-21 14:17:37 +0100 |
commit | 72ad96c8544cff11b66fa3412023c6c535703f74 (patch) | |
tree | 3183d961e19c3851b22af01db91a78aac6d5f7a9 | |
parent | fcf75022d72e2bcda3918e3cef8fc10457cd357a (diff) | |
download | ffmpeg-72ad96c8544cff11b66fa3412023c6c535703f74.tar.gz |
doc/developer: Clarify symbol naming prefixes section.
-rw-r--r-- | doc/developer.texi | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/doc/developer.texi b/doc/developer.texi index 1a87859530..cde87f1e5d 100644 --- a/doc/developer.texi +++ b/doc/developer.texi @@ -188,13 +188,16 @@ There are the following conventions for naming variables and functions: @item For local variables no prefix is required. @item -For variables and functions declared as @code{static} no prefix is required. +For file-scope variables and functions declared as @code{static}, no prefix +is required. @item -For variables and functions used internally by a library an @code{ff_} -prefix should be used, e.g. @samp{ff_w64_demuxer}. +For variables and functions visible outside of file scope, but only 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}. +For variables and functions visible outside of file scope, used internally +across multiple libraries, use @code{avpriv_} as prefix, for example, +@samp{avpriv_aac_parse_header}. @item For externally visible symbols, each library has its own prefix. Check the existing code and choose names accordingly. |