Doc: libstonithd: Flag stonith API methods for later removal

These can't go away as long as stonith_api_operations_t is public, but
perhaps they can eventually.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>