Rollup merge of #30224 - matklad:super-docs, r=steveklabnik

Make clear that `super` may be included in the path several times.

r? @steveklabnik

1 files changed, 19 insertions, 0 deletions

diff --git a/src/doc/reference.md b/src/doc/reference.md
index 98074f09441..0262ff5a71a 100644
--- a/src/doc/reference.md
+++ b/src/doc/reference.md
@@ -515,6 +515,25 @@ fn bar() {
 # fn main() {}
 ```
 
+Additionally keyword `super` may be repeated several times after the first
+`super` or `self` to refer to ancestor modules.
+
+```rust
+mod a {
+    fn foo() {}
+
+    mod b {
+        mod c {
+            fn foo() {
+                super::super::foo(); // call a's foo function
+                self::super::super::foo(); // call a's foo function
+            }
+        }
+    }
+}
+# fn main() {}
+```
+
 # Syntax extensions
 
 A number of minor features of Rust are not central enough to have their own