Docco ignore blocks of comments

Question

I am using docco as a tool for creating coffeescript documentation.

By default, every comment I make in coffeescript source is treated as documentation and moved to the left (explainatory) column. The problem is, in my source there are some lines of code commented out, left as alternate options, which I want to remain in the right (code) column.

Is there a way to tell docco- "do not touch that, leave this like it is a normal code"? "#!" or "#ignore" maybe? Thanks in advance.

Answer 1

Have you tried it? It will ignore #! hashbang lines.

Ignore hashbangs and interpolations...

        l.commentFilter = /(^#![/]|^\s*#\{)/
      languages
    languages = buildMatchers languages

From the source, line 277 https://github.com/jashkenas/docco/blob/master/docco.litcoffee

If nothing else, you should be able to edit the source to add whatever opt out you would like there.