Documenting the Source


As you maybe know I have a new job since last December and I'm working on Samba4 now. Samba4 is a monster so I've asked for some simple tasks to get started. The task was to migrate some code to a new Samba library called tsocket. The problem was I didn't know what to do and how. Some functions of the API were documented but not all. So I had to guess from the names what the function is doing and read the code to understand it. Then I've started to work with the interface and I had to look again the the code to find out possible return values. In the end I spent a lot of time jumping…