Document limitations on block doc comments#1602

ehuss merged 2 commits intorust-lang:masterrust-lang/reference:masterfrom

GKFX:invalid-block-docsGKFX/reference:invalid-block-docsCopy head branch name to clipboard