various improvements to c_parser

[tobijk]

Hi,

while generating documentation for libarchive-rs.rubyforge.org, I found the following issues:

• Some C return types, such as (un)signed short|int|... were not mapped as I would have expected.
• Override comments for constructors in C were not recognized.
• The parser couldn't handle nested braces while scanning for the function body.

It would be nice if these patches could make their way into Yard.

Thanks for a great doc tool. The HTML generated by Yard looks awesome.

Cheers,
Tobias

[tobijk]

Btw, 50d3546 will make yard slower, especially with Ruby 1.9, due to expensive use of string indexes. I tried another solution that collected parts of the function piece by piece using regular expressions and stitching those back together with a join at the end. But it required a copy of 'content' to be made upfront, which is just as expensive, since content contains always the rest of the source file.

So you might not want to merge this, even though the problem persists.

[lsegal]

I've merged the 2 other commits not including the nested braces issue. Unless there is someone having this specific problem with C docs, I'd rather not drop perf. Until then, maybe we can find a better way to solve the problem.

Thanks!

[tobijk]

Awesome. Thanks!