document exported functions
fix typo in linux's get