Improve/add the use_item documentation

1 files changed, 105 insertions, 0 deletions

diff --git a/crates/ra_syntax/tests/data/parser/inline/0114_use_path.txt b/crates/ra_syntax/tests/data/parser/inline/0114_use_path.txt
new file mode 100644
index 000000000..4dc68c3b1
--- /dev/null
+++ b/crates/ra_syntax/tests/data/parser/inline/0114_use_path.txt
@@ -0,0 +1,105 @@
+SOURCE_FILE@[0; 247)
+  USE_ITEM@[0; 17)
+    USE_KW@[0; 3)
+    WHITESPACE@[3; 4)
+    USE_TREE@[4; 16)
+      PATH@[4; 16)
+        PATH_SEGMENT@[4; 16)
+          COLONCOLON@[4; 6)
+          NAME_REF@[6; 16)
+            IDENT@[6; 16) "crate_name"
+    SEMI@[16; 17)
+  WHITESPACE@[17; 18)
+  COMMENT@[18; 45)
+  WHITESPACE@[45; 46)
+  USE_ITEM@[46; 61)
+    USE_KW@[46; 49)
+    WHITESPACE@[49; 50)
+    USE_TREE@[50; 60)
+      PATH@[50; 60)
+        PATH_SEGMENT@[50; 60)
+          NAME_REF@[50; 60)
+            IDENT@[50; 60) "crate_name"
+    SEMI@[60; 61)
+  WHITESPACE@[61; 62)
+  COMMENT@[62; 91)
+  WHITESPACE@[91; 92)
+  USE_ITEM@[92; 124)
+    USE_KW@[92; 95)
+    WHITESPACE@[95; 96)
+    USE_TREE@[96; 123)
+      PATH@[96; 123)
+        PATH_SEGMENT@[96; 123)
+          NAME_REF@[96; 123)
+            IDENT@[96; 123) "item_in_scope_or_crate_name"
+    SEMI@[123; 124)
+  WHITESPACE@[124; 125)
+  COMMENT@[125; 153)
+  WHITESPACE@[153; 155)
+  USE_ITEM@[155; 178)
+    USE_KW@[155; 158)
+    WHITESPACE@[158; 159)
+    USE_TREE@[159; 177)
+      PATH@[159; 177)
+        PATH@[159; 171)
+          PATH@[159; 163)
+            PATH_SEGMENT@[159; 163)
+              SELF_KW@[159; 163)
+          COLONCOLON@[163; 165)
+          PATH_SEGMENT@[165; 171)
+            NAME_REF@[165; 171)
+              IDENT@[165; 171) "module"
+        COLONCOLON@[171; 173)
+        PATH_SEGMENT@[173; 177)
+          NAME_REF@[173; 177)
+            IDENT@[173; 177) "Item"
+    SEMI@[177; 178)
+  WHITESPACE@[178; 179)
+  USE_ITEM@[179; 195)
+    USE_KW@[179; 182)
+    WHITESPACE@[182; 183)
+    USE_TREE@[183; 194)
+      PATH@[183; 194)
+        PATH@[183; 188)
+          PATH_SEGMENT@[183; 188)
+            CRATE_KW@[183; 188)
+        COLONCOLON@[188; 190)
+        PATH_SEGMENT@[190; 194)
+          NAME_REF@[190; 194)
+            IDENT@[190; 194) "Item"
+    SEMI@[194; 195)
+  WHITESPACE@[195; 196)
+  USE_ITEM@[196; 219)
+    USE_KW@[196; 199)
+    WHITESPACE@[199; 200)
+    USE_TREE@[200; 218)
+      PATH@[200; 218)
+        PATH@[200; 210)
+          PATH@[200; 204)
+            PATH_SEGMENT@[200; 204)
+              SELF_KW@[200; 204)
+          COLONCOLON@[204; 206)
+          PATH_SEGMENT@[206; 210)
+            NAME_REF@[206; 210)
+              IDENT@[206; 210) "some"
+        COLONCOLON@[210; 212)
+        PATH_SEGMENT@[212; 218)
+          NAME_REF@[212; 218)
+            IDENT@[212; 218) "Struct"
+    SEMI@[218; 219)
+  WHITESPACE@[219; 220)
+  USE_ITEM@[220; 246)
+    USE_KW@[220; 223)
+    WHITESPACE@[223; 224)
+    USE_TREE@[224; 245)
+      PATH@[224; 245)
+        PATH@[224; 234)
+          PATH_SEGMENT@[224; 234)
+            NAME_REF@[224; 234)
+              IDENT@[224; 234) "crate_name"
+        COLONCOLON@[234; 236)
+        PATH_SEGMENT@[236; 245)
+          NAME_REF@[236; 245)
+            IDENT@[236; 245) "some_item"
+    SEMI@[245; 246)
+  WHITESPACE@[246; 247)