insert deprecation warning for set_graylevel
add documentation of graylevel deprecation
Merge pull request #3812 from jbmohler/deprecate_graylevel

API : insert deprecation warning for set_graylevel