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