Skip to content
Snippets Groups Projects
Commit 3658d2df authored by Diego Biurrun's avatar Diego Biurrun
Browse files

doc: developer: Add a note about reserved system name space

parent 56dea32f
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 8 additions and 0 deletions
doc/developer.texi
+ 8
− 0
View file @ 3658d2df
...@@ -200,6 +200,14 @@ For externally visible symbols, each library has its own prefix. Check ...@@ -200,6 +200,14 @@ For externally visible symbols, each library has its own prefix. Check
the existing code and choose names accordingly. the existing code and choose names accordingly.
@end itemize @end itemize
Furthermore, name space reserved for the system should not be invaded.
Identifiers ending in @code{_t} are reserved by
@url{http://pubs.opengroup.org/onlinepubs/007904975/functions/xsh_chap02_02.html#tag_02_02_02, POSIX}.
Also avoid names starting with @code{__} or @code{_} followed by an uppercase
letter as they are reserved by the C standard. Names starting with @code{_}
are reserved at the file level and may not be used for externally visible
symbols. If in doubt, just avoid names starting with @code{_} altogether.
@subsection Miscellaneous conventions @subsection Miscellaneous conventions
@itemize @bullet @itemize @bullet
@item @item
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment