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.

Author terry.reedy
Recipients docs@python, ekorn, eric.araujo, r.david.murray, terry.reedy
Date 2011-05-28.20:38:15
SpamBayes Score 5.362113e-08
Marked as misclassified No
Message-id <1306615096.2.0.700504575494.issue12148@psf.upfronthosting.co.za>
In-reply-to
Content
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.  This is new in 2.3.  Possible values (see the
    docs for details):

Eliminate 'this is new...' here and above. Suggested replacement:

    Optional keyword arg "optionflags" (default 0) is the bitwise-or
    of the following module constants (see the docs for details):

help(doctest.testfile)
...
    Optional keyword arg "optionflags" or's together module constants,
    and defaults to 0.  Possible values (see the docs for details):

Same replacement (whatever we decide on).

Lib 25.2.4. Basic API
doctest.testfile entry:
...
Optional argument optionflags or’s together option flags. See section Option Flags and Directives.

->
Optional argument optionflags is the bitwise-or of options flags. See section Option Flags and Directives.

doctest.testmode entry refers back to above.

25.2.3.5. Option Flags and Directives

doctest.COMPARISON_FLAGS 
A bitmask or’ing together all the comparison flags above.
doctest.REPORTING_FLAGS 
A bitmask or’ing together all the reporting flags above.

A bitmask that is the bitwise-or of all the comparison flags above.
ditto with 'reporting' instead.

-or-
A bitmask -- the bitwise-or of ...

I think this is all. Searching on "or'" does not work because sphinx nicely replaces "'" with a non-ascii unicode char ;-).
History
Date User Action Args
2011-05-28 20:38:16terry.reedysetrecipients: + terry.reedy, eric.araujo, r.david.murray, ekorn, docs@python
2011-05-28 20:38:16terry.reedysetmessageid: <1306615096.2.0.700504575494.issue12148@psf.upfronthosting.co.za>
2011-05-28 20:38:15terry.reedylinkissue12148 messages
2011-05-28 20:38:15terry.reedycreate