summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-09-17 06:10:28 -0700
committerGitHub <noreply@github.com>2021-09-17 15:10:28 +0200
commita10726d3141d8f52a108c4daf70eefa29401e2fc (patch)
tree14e35ba82cc63fdd789dae37b7b1bff611013319
parent5a5684a14b1417fea27af6b6a89eb7faec7fb80a (diff)
downloadcpython-git-a10726d3141d8f52a108c4daf70eefa29401e2fc.tar.gz
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 2bb425930b..1ebda53ecd 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.