MFC r312758: Add sys/capability.h deprecation warning

In r263232 sys/capability.h was renamed to sys/capsicum.h, to avoid
conflicts with a capability.h header found on other operating systems.

Reported by: antoine
Sponsored by: The FreeBSD Foundation