On 9/14/11 5:16 AM, Marco Leise wrote:
Especially if the involved call looks suspiciously low-level, a user will often assume that it is a direct wrapper of the native API. So +1 in such cases on good documentation. Inspired by other language documents, a 'caveats' section or other highlighting will do, because socket experts will skip the text they think they know already.
Currently, it is covered in a »Note« section (http://d-programming-language.org/phobos/std_socket.html#setOption), but feel free to convert it into a big red warning or whatever, I am not emotionally attached to neither my workaround/kludge/hack nor the docs for it.
David
