Skip to content

[3.10] bpo-45584: Clarify math.trunc documentation (GH-29183) - #32273

Merged
miss-islington merged 1 commit into
python:3.10from
miss-islington:backport-ebbdbbf-3.10
Apr 2, 2022
Merged

miss-islington merged 1 commit into
python:3.10from
miss-islington:backport-ebbdbbf-3.10

Conversation

@miss-islington

@miss-islington miss-islington commented Apr 2, 2022 •

Copy link
Copy Markdown
Contributor

While floor/ceil 's documentation are very precise, truncate was not explained. I actually had to search online to understand the difference between truncate and floor (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious)

Co-authored-by: Alex Waygood [email protected]
Co-authored-by: Éric Araujo [email protected]
Co-authored-by: Terry Jan Reedy [email protected]
Co-authored-by: Jelle Zijlstra [email protected]
(cherry picked from commit ebbdbbf)

Co-authored-by: Arthur Milchior [email protected]

https://bugs.python.org/issue45584

While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious)

Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Éric Araujo <[email protected]>
Co-authored-by: Terry Jan Reedy <[email protected]>
Co-authored-by: Jelle Zijlstra <[email protected]>
(cherry picked from commit ebbdbbf)

Co-authored-by: Arthur Milchior <[email protected]>
@miss-islington

Copy link
Copy Markdown
Contributor Author

@Arthur-Milchior and @JelleZijlstra: Status check is done, and it's a success ✅ .

@miss-islington
miss-islington merged commit 3031b86 into python:3.10 Apr 2, 2022
@miss-islington
miss-islington deleted the backport-ebbdbbf-3.10 branch April 2, 2022 22:31
@miss-islington

Copy link
Copy Markdown
Contributor Author

@Arthur-Milchior and @JelleZijlstra: Status check is done, and it's a failure ❌ .

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants