DOC: Warning about ghost functions

Provide warnings in API documentation of functions with signatures
that are only acting as placeholders.  Note that invoking the function
will raise a NotImplementedError exception.