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

[3.10] bpo-45584: Clarify math.trunc documentation (GH-29183)#32273
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 Alex.Waygood@Gmail.com
Co-authored-by: Éric Araujo merwok@netwok.org
Co-authored-by: Terry Jan Reedy tjreedy@udel.edu
Co-authored-by: Jelle Zijlstra jelle.zijlstra@gmail.com
(cherry picked from commit ebbdbbf)

Co-authored-by: Arthur Milchior arthur@milchior.fr

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 <Alex.Waygood@Gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit ebbdbbf)

Co-authored-by: Arthur Milchior <arthur@milchior.fr>
@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