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
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to