From 79d54766ab42b62aa9dd4ef4f4b3268761b5d0d5 Mon Sep 17 00:00:00 2001
From: adigitoleo <adigitoleo@dissimulo.com>
Date: Thu, 13 Jan 2022 13:14:35 +1100
Subject: [PATCH] docs: Mention `import foo {.all.}` syntax

Mention the `import foo {.all.}` syntax in the manual,
with a caveat about private imports.
Also link to the experimental importutils module.
---
 doc/manual_experimental.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/manual_experimental.rst b/doc/manual_experimental.rst
index 4ed8439dffe63..0f82b99501f30 100644
--- a/doc/manual_experimental.rst
+++ b/doc/manual_experimental.rst
@@ -168,6 +168,17 @@ This feature will likely be superseded in the future by support for
 recursive module dependencies.
 
 
+Importing private symbols
+=========================
+
+In some situations, it may be useful to import all symbols (public or private)
+from a module. The syntax `import foo {.all.}` can be used to import all
+symbols from the module `foo`. Note that importing private symbols is
+generally not recommended.
+
+See also the experimental `importutils <importutils.html>`_ module.
+
+
 Code reordering
 ===============