<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi,<div class=""><br class=""></div><div class="">On <a href="https://docs.python.org/3.6/tutorial/introduction.html" class="">https://docs.python.org/3.6/tutorial/introduction.html</a></div><div class="">I think this wording is misleading:</div><blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;" class=""><div class=""><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class="">To do </span><a class="internal reference" href="https://docs.python.org/3.6/glossary.html#term-floor-division" style="color: rgb(99, 99, 187); text-decoration: none; font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);"><span class="std std-term xref">floor division</span></a><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class=""> and get an integer result (discarding any fractional result) you can use the </span><code class="literal docutils" style="background-color: rgb(236, 240, 243); padding: 0px 1px; font-size: 15.44px; font-family: monospace, sans-serif; border-top-left-radius: 3px; border-top-right-radius: 3px; border-bottom-right-radius: 3px; border-bottom-left-radius: 3px; color: rgb(34, 34, 34); font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2;"><span class="pre">//</span></code><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class=""> operator;</span></div><div class=""><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class=""><br class=""></span></div></blockquote><div class="">Considering negative numbers (where -4 // 3 gives -2, which is clearly not "discarding the fraction" from -1.333), this would be better:</div><blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;" class=""><div class=""><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class="">To do </span><a class="internal reference" href="https://docs.python.org/3.6/glossary.html#term-floor-division" style="color: rgb(99, 99, 187); text-decoration: none; font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);"><span class="std std-term xref">floor division</span></a><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class=""> and get an integer result (rounding down to next lower integer) you can use the </span><code class="literal docutils" style="background-color: rgb(236, 240, 243); padding: 0px 1px; font-size: 15.44px; font-family: monospace, sans-serif; border-top-left-radius: 3px; border-top-right-radius: 3px; border-bottom-right-radius: 3px; border-bottom-left-radius: 3px; color: rgb(34, 34, 34); font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2;"><span class="pre">//</span></code><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class=""> operator;</span></div></blockquote><div class=""><div class=""><br class="webkit-block-placeholder"></div><div class="">Actually, I'd say the glossary definition of "floor division" could be improved as well, at <a href="https://docs.python.org/3.6/glossary.html#term-floor-division" class="">https://docs.python.org/3.6/glossary.html#term-floor-division</a> :</div></div><blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;" class=""><div class=""><div class=""><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; font-variant-ligatures: normal; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class="">Mathematical division that rounds down to nearest integer.</span></div></div></blockquote>… might be better as:<blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;" class=""><div class=""><span style="color: rgb(34, 34, 34); font-family: 'Lucida Grande', Arial, sans-serif; font-size: 16px; orphans: 2; text-align: justify; widows: 2; background-color: rgb(255, 255, 255);" class="">Mathematical division that rounds down to the next lower integer.</span></div></blockquote><div class=""><blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;" class=""><div class=""><br class=""></div></blockquote><div class=""><div class="">The idea of "rounding" to the "nearest integer" might make a lot of people think of normal rounding, even though the word "down" is there. I think my phrasing is less ambiguous. Thanks for considering these changes!</div><div class="">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div class="" style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;"><div class="" style="color: rgb(0, 0, 0); font-variant: normal; letter-spacing: normal; line-height: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; orphans: 2; widows: 2;"><font face="Arial" class=""><font class="Apple-style-span"><br class="Apple-interchange-newline">Cheers,<br class="">-Dick</font></font></div><div align="left" class="" style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; orphans: 2; widows: 2;"><table width="100%" class=""><tbody class=""><tr class=""><td class=""><hr class=""><table border="0" width="100%" class=""><tbody class=""><tr class=""><td class=""><font face="Arial Rounded MT Bold" class=""><font size="3" class="Apple-style-span"><span class="Apple-style-span" style="font-size: 12px;">Dick Jackson Software Consulting Inc.<br class="">Victoria, BC, Canada +1-250-220-6117</span></font></font></td><td class=""><p align="right" class=""><a title="mailto:dick@d-jackson.com" href="mailto:dick@d-jackson.com" class=""><font title="mailto:dick@d-jackson.com" face="Arial Rounded MT Bold" class=""><font size="3" class="Apple-style-span"><span class="Apple-style-span" style="font-size: 12px;">dick@d-jackson.com</span></font></font></a><font face="Arial Rounded MT Bold" class=""><font size="3" class="Apple-style-span"><span class="Apple-style-span" style="font-size: 12px;"><br class=""></span></font><a title="http://www.d-jackson.com/" href="http://www.d-jackson.com/" class=""><font size="3" class="Apple-style-span"><span class="Apple-style-span" style="font-size: 12px;">http://www.d-jackson.com</span></font></a></font></p></td></tr></tbody></table></td></tr></tbody></table></div><div class="" style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 14px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><br class=""></div></div></div></div></div></div><br class="Apple-interchange-newline">
</div>
<br class=""></div></div></body></html>