Issue #690358 by sbrattla, jhodgdon, nenne: overhaul file_check_directory() documentation due to various issues