From aa2b894f6a621cd5ab9d213049501b04360ccff6 Mon Sep 17 00:00:00 2001
From: Mariatta Wijaya <mariatta.wijaya@gmail.com>
Date: Thu, 9 Mar 2017 23:01:25 -0800
Subject: [PATCH] bpo-28739: Document that f-strings cannot be used as
 docstring

---
 Doc/reference/lexical_analysis.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
index da7017afff0a3d..7f9c66481785c1 100644
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -696,6 +696,17 @@ a temporary variable.
    >>> f"newline: {newline}"
    'newline: 10'
 
+Formatted string literals cannot be used as docstrings, even if they do not
+include expressions.
+
+::
+
+   >>> def foo():
+   ...     f"Not a docstring"
+   ...
+   >>> foo.__doc__ is None
+   True
+
 See also :pep:`498` for the proposal that added formatted string literals,
 and :meth:`str.format`, which uses a related format string mechanism.