DOCS: update reference about paths

[matklad]

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

r? @steveklabnik

[matklad]

wait, the rules are different: you can have any number of supers, but only at the beginning of the path

[matklad]

Should be correct now, but it's better to double check: the only thing worse than a missing reference is an incorrect reference :)

[apasel422]

This should have one space after the period.

[matklad]

Yes, thanks. Fixed.

[matklad]

Hm, self::super prefix is also allowed: https://github.com/rust-lang/rust/blob/master/src/librustc_resolve/lib.rs#L1639-L1642

[matklad]

I hope this is correct and complete now ;)

[tshepang]

Can you extend example by inserting foo() in all modules and calling them, so that it's more clear how this works.

[matklad]

Can you extend example by inserting foo() in all modules and calling them, so that it's more clear how this works.

Are you sure this is necessary? There are such examples just before this point. My idea is that in previous bullets we discuss simple common cases, and that then we give a separate more complicated example with several supers.

[tshepang]

Sorry, I didn't read the context. Ignore my comment.

[steveklabnik]

@bors: r+ rollup

[bors]

📌 Commit c8b7e24 has been approved by steveklabnik