Add support for parsing documentation comments on declarations

[cobbal]

As mentioned in #766

[krzysztofzablocki]

I'll do a proper review on the weekend but I imagine this can have pretty significant impact on performance of tens of thousands of apps that don't really use this feature, I'm ok including this if we make it opt-in behind configuration flag but off by default

would you mind adding that? If its not enabled just default to empty comment info

[cobbal]

I put the flag in. It touched a lot of places though; there might be a cleaner way to do it.

[cobbal]

@krzysztofzablocki Any update on this?

[krzysztofzablocki]

I'll get on this soon, started new job last week so been quite busy

[cobbal]

I'll get on this soon, started new job last week so been quite busy

Congrats! I understand that. It's not a rush, but I just wanted to make sure it was moving along :) And thank you for all you do for this project :)

[mhdhejazi]

Thank you @cobbal and @krzysztofzablocki for this great feature!

I'm not able to get Sourcery to parse documentation unless I pass --disableCache. I just wanted to confirm that this is the expected behaviour.

Also, it'd be great if Sourcery docs are also updated to mention the new documentation property.

[krzysztofzablocki]

@mhdhejazi have you tried nuking old cache manually? try removing the cache and then it will re-create it on next run, let me know if you are still running into issue without disableCache after doing so

Cache is under ~/Library/Caches/Sourcery