Which is expecially true when using IDEs with auto-completion.<br>Using
VisualStudio/MonoDevelop and C# I rarely need to look at the
documentation because I can quickly see what a method accept and
returns. And when I need to pass flags or options, enums are much more
neat and encapsulated.
<br><br>With Python I'm constantly looking at the documentation when
surfing a library. I personally like the terse code and abstraction
features of Python which is making me slowly writing more and more
tools in it. Still, I have to agree that there are edges (like these)
that must be sharpened out...<br><br><div><span class="gmail_quote">On 7/24/06, <b class="gmail_sendername">paul kölle</b> <<a href="mailto:paul@subsignal.org">paul@subsignal.org</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Marc 'BlackJack' Rintsch wrote:<br>> In <<a href="mailto:mailman.8423.1153605052.27775.python-list@python.org">mailman.8423.1153605052.27775.python-list@python.org</a>>, Yacao Wang<br>> wrote:<br>><br>>> However, type signatures are not only a kind of information provided for
<br>>> the compiler, but also for the programmer, or more important, for the<br>>> programmer. Without it, we have to "infer" the return type or required<br>>> agument types of a function, and this can't be done without seeing the
<br>>> implementation of it,<br>><br>> That's what documentation is meant for.  If you are forced to look at the<br>> implementation, the documentation is bad.<br>I think the OP refers to reading the *code*, the documentation might not
<br>exist (yet). Sometimes I feel python is easier to write than to read and<br> missing argument type declarations (just for documentation purposes)<br>are  IMHO one reason. Another are missing (optional) argument type<br>
checks at runtime. Something like WrongArgumentType exceptions instead<br>of rather unspecific AttributeError from deep inside the code would be<br>very convenient.<br><br>Yes docstrings are nice but sometimes a simple:<br>
<br>foo(int:param1, string:param2) is way better than:<br><br>foo(param1, param2):<br>  """<br>  @type param1: integer<br>  @type parame2: string<br>  """<br><br>cheers<br> Paul<br><br>--<br>
<a href="http://mail.python.org/mailman/listinfo/python-list">http://mail.python.org/mailman/listinfo/python-list</a><br></blockquote></div><br><br clear="all"><br>-- <br>GPG Fingerprint: B0D7 1249 447D F5BB 22C5  5B9B 078C 2615 504B 7B85