Using Ruby 1.9.3 p194
$ gem install octokit
Successfully installed octokit-1.0.4
1 gem installed
Installing ri documentation for octokit-1.0.4...
Building YARD (yri) index for octokit-1.0.4...
[error]: ParserSyntaxError: syntax error in `LICENSE`:(1,18): syntax error, unexpected tINTEGER, expecting $end
[error]: Stack trace:
Installing RDoc documentation for octokit-1.0.4...
May have something to do with how yard (0.7.5) is being called for the LICENSE file.
Seeing this issue on several projects on GitHub with no stated resolution. Maybe @lsegal might know?
YARD assumes all files in the .document file are ruby sources. You can add a "-" between the last ruby file and the non Ruby files to tell YARD that the rest are non-Ruby files. RDoc shouldn't mind this. Just as a sidenote, YARD isn't exactly "barfing" here, it's just notifying you of a parse error and continuing to document the rest of your source without issue.
@lsegal Apologies, I was using barf in the most liberal sense, as something was coming out that I wasn't expecting. Would shart be better?
Fix for #84, Yard documentation error
@miketheman I was just pointing out that it's purely visual noise. It doesn't affect the resulting docs.
Fixed with #85