Improvements to code in include files

• A comment block per function has been added to describe the functionality, return value and usage.
• Small fixes and suggestions which has been made by the ShellCheck.
• Unneeded lines have been removed.