Difference between --no-api and --hide-api?

[thomthom]

What is the difference between using --no-api and --hide-api?

[lsegal]

1. --no-api does not take a TAG argument (optparse makes this hard to show) and will ignore objects that do not have an @api tag attached. It's equivalent to --api every --api other --api api --api used. See specs for examples.
2. --hide-api TAG will hide objects for a particular API tag.

Unfortunately using the --[no-] prefix in optparse does not allow you to take an argument afterward, hence the use of --hide-api for that behavior.