vendor'd package in accordance with guidance from travis ci

added package level documentation

eliminated unused variables

comment formatting

refactored code to get name from syscall.Dirent

correctly determines entry name length

updated godoc docs

accepts optional scratch buffer to reduce GC

ReadDirents and ReadDirnames returns all entries

more simplified and extensible API