Document pub(restricted)

[cramertj]

RFC
Tracking issue

[steveklabnik]

@carols10cents we should discuss how we want to address this...

[steveklabnik]

@cramertj

so, @carols10cents and I talked about this, and she remembered something we had talked about, but had not yet done: an appendix called "newest features". The idea is that this is where you could send PRs with the basics, and then we can asynchronously work them into the main text later.

How does that sound? I'll send in a PR setting up the section, you'd fill it out.

[cramertj]

Sure! Sounds fine.

[carols10cents]

Related: #478

[carols10cents]

Also add this usage of pub to the keywords appendix.

[carols10cents]

Looking at this again, it appears that pub(stuff) was documented in the reference in rust-lang/reference#12 rather than in the newest features appendix. I also think the current short definition of the pub keyword is still accurate and sufficient:

• pub - denotes public visibility in struct fields, impl blocks, and modules

so I'm going to close this. Thanks!