Am 14.09.2011, 13:01 Uhr, schrieb David Nadlinger <[email protected]>:
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
Nah, that's fine. I just didn't track back the link to your documentation
to check how it looks right now, and it looks highlighted enough to me.
