@api aware comparison

[tomzx]

Use a command line flag to determine whether the source code should be checked using @api docblock tags or consider that everything is part of the api.

[vancoz]

May I ask you how would you like to implement this enhancement?
Asking because nikic/php-parser has no feature to parse annotations, just comments.

[vancoz]

BTW I would like to add that it's very important feature as parse and analyze whole codebase probably not the best idea, especially in case if it contains tons of libs and is big sized.

[tomzx]

@vancoz If the only case we have to deal with is @api, then reading the docComment is probably the easiest way.

If you can try it out on your side and let me know how it works, we can try to get this issue going forward.

[alfredbez]

My colleague @shas2023 created a PR to add this in #181