This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Lucio Ricardo Montero Valenzuela
Recipients Lucio Ricardo Montero Valenzuela, docs@python
Date 2017-03-10.21:06:33
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1489179993.27.0.31165504732.issue29791@psf.upfronthosting.co.za>
In-reply-to
Content
In the print() function documentation (https://docs.python.org/3/library/functions.html#print), the first line says "Print objects to the text stream file, separated by sep and followed by end. sep, end and file, if present, must be given as keyword arguments.", but the function definition is said to be "print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)". Based on the Python user function definition grammar, the only way of passing an value to a non-star parameters that appear after a star-parameter is with the keyword (so the interpreter knows not to push the value into the star-parameter list/mapping). So the flush parameter can be set only naming explicitly the keyword 'flush' ¿Isn't it?. So the first line of the print() function documentation should say "Print objects to the text stream file, separated by sep and followed by end. sep, end, file and flush, if present, must be given as keyword arguments.". Flush is a new parameter, so maybe you forgot to update this line of the documentation to include it.
Best regards.
History
Date User Action Args
2017-03-10 21:06:33Lucio Ricardo Montero Valenzuelasetrecipients: + Lucio Ricardo Montero Valenzuela, docs@python
2017-03-10 21:06:33Lucio Ricardo Montero Valenzuelasetmessageid: <1489179993.27.0.31165504732.issue29791@psf.upfronthosting.co.za>
2017-03-10 21:06:33Lucio Ricardo Montero Valenzuelalinkissue29791 messages
2017-03-10 21:06:33Lucio Ricardo Montero Valenzuelacreate