[feat] add exclude-deprecated option

[correaa]

I would like to request a exclude-deprecated configuration option.

This will omit [[deprecated]] objects from the documentation.

[alandefreitas]

A small extension for that is quite straightforward. And let's keep the issue as representing a more built-in and generic feature.