fixed documentation and the file_descriptor now uses its write method