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

The original comments weren't rendered correctly by Markdown.