diff --git a/Doc/builtins/functions.rst b/Doc/builtins/functions.rst index 717efe50c13074..edd8b81257ad3e 100644 --- a/Doc/builtins/functions.rst +++ b/Doc/builtins/functions.rst @@ -1736,7 +1736,8 @@ are always available. They are listed here in alphabetical order. binary mode file objects. For these, use ``file.write(...)`` instead. Output buffering is usually determined by *file*. - However, if *flush* is true, the stream is forcibly flushed. + However, if *flush* is true, the stream is forcibly flushed after the *objects* + have been printed. .. versionchanged:: 3.3 diff --git a/Doc/c-api/bytearray.rst b/Doc/c-api/bytearray.rst index 8f3cb2d63cb3c8..a559d0ca23815f 100644 --- a/Doc/c-api/bytearray.rst +++ b/Doc/c-api/bytearray.rst @@ -58,6 +58,7 @@ Direct API functions .. c:function:: PyObject* PyByteArray_FromStringAndSize(const char *string, Py_ssize_t len) Create a new bytearray object from *string* and its length, *len*. + If *string* is ``NULL``, the contents of the bytearray object are uninitialized. On failure, return ``NULL`` with an exception set. diff --git a/Doc/library/__main__.rst b/Doc/library/__main__.rst index 36b884f975804f..ced619b2eec0b1 100644 --- a/Doc/library/__main__.rst +++ b/Doc/library/__main__.rst @@ -241,7 +241,7 @@ Idiomatic Usage ^^^^^^^^^^^^^^^ The content of ``__main__.py`` typically isn't fenced with an -``if __name__ == '__main__'`` block. Instead, those files are kept +``if __name__ == '__main__'`` block. Instead, these files are kept short and import functions to execute from other modules. Those other modules can then be easily unit-tested and are properly reusable. diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst index 6f7f352db3c438..9a06a4f6f7e8bb 100644 --- a/Doc/reference/lexical_analysis.rst +++ b/Doc/reference/lexical_analysis.rst @@ -278,7 +278,7 @@ backslashes; the whitespace up to the first backslash determines the indentation. Indentation is rejected as inconsistent if a source file mixes tabs and spaces -in a way that makes the meaning dependent on the worth of a tab in spaces; a +in a way that makes the meaning dependent on the width of a tab in spaces; a :exc:`TabError` is raised in that case. **Cross-platform compatibility note:** because of the nature of text editors on