From: Kevin Day Date: Wed, 22 Apr 2020 03:58:08 +0000 (-0500) Subject: Update: add simple documentation about private functions X-Git-Tag: 0.5.0~348 X-Git-Url: https://git.kevux.org/?a=commitdiff_plain;h=8a169bc88e10af1612b63ce9edfb7bad49cf32f7;p=fll Update: add simple documentation about private functions --- diff --git a/documents/private_functions.txt b/documents/private_functions.txt new file mode 100644 index 0000000..aca0586 --- /dev/null +++ b/documents/private_functions.txt @@ -0,0 +1,17 @@ +One of the objectives of this project is to make as much, if not all, of the functions available for use. + +Another of the objectives is to design each function to operate in isolation to another function. +There is some flexibility in regards to this when it comes to individual projects. + +Such a design has advantages and disadvantages. + +One of those disadvantages is possible redundant code. +The c-programming language does not have private functions by any normal means. +The use of the f_gcc_attribute_visibility_internal helps simulate private functions. +Such functionality only works in supporting GCC compilers. + +These synthetic private functions are implemented as an exception to the objectives for maintainability and redundancy purposes. +Such implementations should be kept to a bare minimum. + +Functions defined as private will not be normally exposed through the public headers files. +Such functions will be prefixed with 'private_'.