bash_scripting_conventions:
 * added usability section
 * multiple variables returned from function
 * private/public functions