Merge pull request #1146 from pietroalbini/use-nested-groups-book

Add use_nested_groups to the newest features appendix

second-edition/dictionary.txt

@@ -320,6 +320,7 @@ proc
 pthreads
 pushups
 QuitMessage
+quux
 RAII
 randcrate
 RangeFrom

second-edition/src/appendix-06-newest-features.md

@@ -57,3 +57,37 @@ fn main() {
     assert_eq!(result, 20);
 }
 ```
+
+
+## Nested groups in `use` declarations
+
+If you have a complex module tree with many different submodules and you need
+to import a few items from each one, it might be useful to group all the
+imports in the same declaration to keep your code clean and avoid repeating the
+base modules' name.
+
+The `use` declaration supports nesting to help you in those cases, both with
+simple imports and glob ones. For example this snippets imports `bar`, `Foo`,
+all the items in `baz` and `Bar`:
+
+```rust
+# #![allow(unused_imports, dead_code)]
+#
+# mod foo {
+#     pub mod bar {
+#         pub type Foo = ();
+#     }
+#     pub mod baz {
+#         pub mod quux {
+#             pub type Bar = ();
+#         }
+#     }
+# }
+#
+use foo::{
+    bar::{self, Foo},
+    baz::{*, quux::Bar},
+};
+#
+# fn main() {}
+```