fix syntax error in spec tests
fix running with a directory as the first argument
add debug flag and hide tracebacks otherwise
fix NameError and enhance help on --readme option
add an option to allow writing the output to stdout
if a cookbook directory is given, read the README from there
remove superflous word 'should' from test description
handle empty comment lines

comment lines with just one '#' at the beginning of the line did not
have the # removed in the final output
use heredoc for test instead of comparing arrays
handle ignored inline comments
keep good inline comments in the code

closes #1
ignore comments tailing a code block
@code is always true (empty Array in ruby)
ignore inline comments on code with no leading comments