14 Jan
2002
14 Jan
'02
10:47 a.m.
Well, can't speak for PythonLabs, but I don't see any benefit from making doc-string complicated by introducing #ifdefs. It doesn't buy us anything, IMHO. Even worse: it makes translating the doc-strings harder.
If there is platform-specific functionality, the docstring should document that only on the platform where it applies. --Guido van Rossum (home page: http://www.python.org/~guido/)