doc: improve documentation
System: improve signature of list_directory