summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-09-17 13:10:28 (GMT)
committerPablo Galindo <pablogsal@gmail.com>2021-09-29 11:34:49 (GMT)
commitc4e9ef1f1d3bb7aca09f3ac6691a78d1341d7fcb (patch)
tree4378e0326f6d3db0d0ea6a3287f93d1c77eac724
parent81c9aff19b9d6c7f388e1b46da468739a2830b95 (diff)
downloadcpython-c4e9ef1f1d3bb7aca09f3ac6691a78d1341d7fcb.zip
cpython-c4e9ef1f1d3bb7aca09f3ac6691a78d1341d7fcb.tar.gz
cpython-c4e9ef1f1d3bb7aca09f3ac6691a78d1341d7fcb.tar.bz2
bpo-45217: adds note that `allow_no_value` in `configparser` is optional (GH-28396) (GH-28418)
Co-authored-by: Ɓukasz Langa <lukasz@langa.pl> (cherry picked from commit cb07838ab756564988b1ffd23871f1222a832446) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
-rw-r--r--Doc/library/configparser.rst3
1 files changed, 2 insertions, 1 deletions
diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst
index 2bb4259..1ebda53 100644
--- a/Doc/library/configparser.rst
+++ b/Doc/library/configparser.rst
@@ -261,7 +261,8 @@ A configuration file consists of sections, each led by a ``[section]`` header,
followed by key/value entries separated by a specific string (``=`` or ``:`` by
default [1]_). By default, section names are case sensitive but keys are not
[1]_. Leading and trailing whitespace is removed from keys and values.
-Values can be omitted, in which case the key/value delimiter may also be left
+Values can be omitted if the parser is configured to allow it [1]_,
+in which case the key/value delimiter may also be left
out. Values can also span multiple lines, as long as they are indented deeper
than the first line of the value. Depending on the parser's mode, blank lines
may be treated as parts of multiline values or ignored.