Fix barrier docs
auto merge of #11823 : derekchiang/rust/fix-barrier-doc, r=alexcrichton

The original comments weren't rendered correctly by Markdown.
As Either no longer exists, remove Either, Left, and Right from syntax files
auto merge of #11822 : bytbox/rust/master, r=huonw

Changes only to src/etc.