Ask HN: How to issue API usage warnings via compiler?

What is the state of the art in giving library programmers the ability to generate heuristic compiler warnings for problematic code written using their APIs? Such a compiler warning would suggest a better way of coding something using the API. The compiler warnings would be about very specific issues that tend to come up a lot with people using their APIs.