jashkenas/docco — pull request #296 by redders6600 (2014-07-25 12:31:19+00:00)
Title: Keep inline comments for literate languages inline.

Because literate languages specifically separate code comments from prose, pulling those comments out makes the resulting document disjointed and harder to read.

As such, we should leave them where they are. Because of the way docco preprocesses literate files, we can separate the prose simply by only using lines that *start* with the comment symbol.

This fixes #262