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.

classification
Title: Boolean Logic Check - Built-in Types Documentation page
Type: Stage: resolved
Components: Documentation Versions:
process
Status: closed Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: abriabrisham, docs@python
Priority: normal Keywords:

Created on 2021-12-20 21:20 by abriabrisham, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Messages (2)
msg408972 - (view) Author: Abri Vincent (abriabrisham) Date: 2021-12-20 21:20
On the documentation page https://docs.python.org/3/library/stdtypes.html the header 'Boolean Operations — and, or, not' provides a table (attached as an image). 

It states: 

a.1) x OR y - if x is false, then y, else x **
a.2) x AND y - if x is false, then x, else y **

When I read this i intuit the following

b.1) x OR y - if x is false, then x, else y
b.2) x AND y - if x is false, then y, else x

Providing an example with a.1 which is currently listed in the documentation

If x is false -> else x = False (we don't check if Y=True which is the definition of an OR operator). 

** This is a short-circuit operator, so it only evaluates the second argument if the first one is false.

I would appreciate clarification on this and if others see an issue with the documentation after reading my description able then movement on consensus to correct the documentation
msg408973 - (view) Author: Abri Vincent (abriabrisham) Date: 2021-12-20 21:40
A short circuit operator. 

x OR y - if x is false, then y, else x (1). 

(1) This is a short-circuit operator, so it only evaluates the second argument if the first one is false.

The first argument is 'if'
The second argument is 'then'
The third argument is 'else'

Move to the second argument if the first is false. 
Evaluate the first argument 'if x is false' - look at the second argument if the first argument is false - 'then y'.
History
Date User Action Args
2022-04-11 14:59:53adminsetgithub: 90297
2021-12-20 21:40:15abriabrishamsetmessages: + msg408973
2021-12-20 21:35:28abriabrishamsetstatus: open -> closed
stage: resolved
2021-12-20 21:20:25abriabrishamcreate