summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-09-17 04:41:25 -0700
committerGitHub <noreply@github.com>2021-09-17 13:41:25 +0200
commit3ea1c4b66887e7ca920db487f6ffc5f1db3c873f (patch)
treeb58df8bb1d90cfd4e182a2d3701dbae69a019f1f
parent9f64b1a44b59e31661e33ab68d69b5d4a3b8cf92 (diff)
downloadcpython-git-3ea1c4b66887e7ca920db487f6ffc5f1db3c873f.tar.gz
bpo-45217: adds note that `allow_no_value` in `configparser` is optional (GH-28396) (GH-28416)
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 3de5918367..60d33f5927 100644
--- a/Doc/library/configparser.rst
+++ b/Doc/library/configparser.rst
@@ -237,7 +237,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.