Add pub(restricted) docs

[cramertj]

See rust-lang/rust#32409
cc @steveklabnik

[steveklabnik]

This text looks good to me! I'm going to have to think about CI....

[petrochenkov]

Could you add three more details

• path in pub(in path) item must be some parent module of the item.
• pub(super) and pub(self) are shortcuts for pub(in super) and pub(in self) respectively
• pub(self) is the same thing as private

[cramertj]

@petrochenkov Is there some reason to use pub(self) that I should mention? It doesn't seem well-motivate to me.

[petrochenkov]

@cramertj
Not yet (but see rust-lang/rust#32770), but it's useful for understanding the model.

[steveklabnik]

blocked on #14

[steveklabnik]

Update: this is now unblocked, but we need the feature to stabilize to land.

[petrochenkov]

@steveklabnik
Everything is stabilized already, these docs are the only missing part.

[steveklabnik]

@petrochenkov running in nightly still requires the flag. Maybe my nightly was out of date?

[steveklabnik]

Ah, it was. My bad!

[steveklabnik]

@cramertj can you rebase this please? We can then get it in.

[cramertj]

Something weird is going on with the tests-- Travis is complaining that it can't find outer_mod in the crate root, but it works just fine when I run it on the playground or using rustc locally. Any ideas?

[matthewjasper]

You need to add # fn main() {} to the example otherwise everything gets wrapped in main.

[cramertj]

@matthewjasper lol ty

[steveklabnik]

Thanks!