[issue12148] Clarify "or-ing together" doctest option flags

Roundup Robot added the comment: New changeset 1439619daf42 by Georg Brandl in branch '3.4': Closes #12148: clarify "or's together option flags" in doctest docs. https://hg.python.org/cpython/rev/1439619daf42 -- nosy: +python-dev resolution: -> fixed stage: -> resolved status: open ->

[issue12148] Clarify "or-ing together" doctest option flags

Changes by Terry J. Reedy : -- versions: +Python 3.4, Python 3.5 -Python 3.1, Python 3.2, Python 3.3 ___ Python tracker ___ ___ Python

[issue12148] Clarify "or-ing together" doctest option flags

Caelyn McAulay added the comment: I grepped for 's together' and found two instances of "or's together" in the docs which I reworded to use bitwise-or instead, in the attached patch. -- keywords: +patch nosy: +math_foo Added file: http://bugs.python.org/file34938/issue12148.patch _

[issue12148] Clarify "or-ing together" doctest option flags

R. David Murray added the comment: I like bitwise-or better than bitwise OR because 'bitwise-or' is a distinct operation from 'or', and making it hyphenated emphasizes that. -- ___ Python tracker

[issue12148] Clarify "or-ing together" doctest option flags

Éric Araujo added the comment: I found “bitwise OR-ed” in library/fcntl.rst library/functions.rst library/os.rst library/winsound.rst (using grep, not Sphinx :) -- ___ Python tracker _

[issue12148] Clarify "or-ing together" doctest option flags

Terry J. Reedy added the comment: The basic fix is to replace the fake verb 'to or', conjugated not really properly as "or's" or "or'ing", with the real noun 'bitwise-or'. help(doctest.testmod) ... Optional keyword arg "optionflags" or's together module constants, and defaults to 0. T

[issue12148] Clarify "or-ing together" doctest option flags

Éric Araujo added the comment: As a non-native speaker, I found constructs such as “OR-ed” or “syncing” a bit non-obvious when I started reading docs. +1 on adding “bitwise”, +1 on changing to “combined with the | operator”. (Yes, this is an or-ed vote.) -- nosy: +eric.araujo versio

[issue12148] Clarify "or-ing together" doctest option flags

R. David Murray added the comment: I think adding the word 'bitwise' in front of "or'ed" and linking it to that section would be sufficient. -- nosy: +r.david.murray versions: +Python 3.2, Python 3.3 ___ Python tracker

[issue12148] Clarify "or-ing together" doctest option flags

New submission from ekorn : Combining multiple option flags to doctest.testmod(optionflags=...) requires the bitwise or operator |, not plain "or". I therefore suggest rewording "or-ing together individual option flags." to "or-ing together individual option flags, using the 'bitwise or' opera