[Python-Dev] PEP 484

[Mario Figueiredo]

Please don't clutter executable code. We need to read it without growing an
headache.

Much better is:

      def myfunction(arg1, arg2):
      """
      Normal docstring...
      @hint: (str, int) -> bool
      """
          return True

While I agree type hinting, for the purposes of static analysis, has no
place in __doc__, I think that we could live with that. Otherwise:

      def myfunction(arg1, arg2):
      """
      Normal docstring...
      """
      "@hint: (str, int) -> bool"
          return True
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-dev/attachments/20150124/3a71b09b/attachment.html>