[doc] Clarify client callback API comments (#37805)

Comments say users "should not" call Start* methods after notification callbacks are called with false, but users may still call so it's close to 'not recommended'. But it's less confusing to remove it altogether.

<!--

If you know who should review your pull request, please assign it to that
person, otherwise the pull request would get assigned randomly.

If your pull request is for a specific language, please add the appropriate
lang label.

-->

Closes #37805

COPYBARA_INTEGRATE_REVIEW=https://github.com/grpc/grpc/pull/37805 from yousukseung:client_callback_doc_clarify 38b9371f79
PiperOrigin-RevId: 679709417
pull/37584/head
Yousuk Seung 2 months ago committed by Copybara-Service
parent e56d766a45
commit f1df0f2b5f
  1. 7
      include/grpcpp/support/client_callback.h

@ -325,21 +325,20 @@ class ClientBidiReactor : public internal::ClientReactor {
/// call of OnReadDone or OnDone. /// call of OnReadDone or OnDone.
/// ///
/// \param[in] ok Was the initial metadata read successfully? If false, no /// \param[in] ok Was the initial metadata read successfully? If false, no
/// new read/write operation will succeed, and any further /// new read/write operation will succeed.
/// Start* operations should not be called.
virtual void OnReadInitialMetadataDone(bool /*ok*/) {} virtual void OnReadInitialMetadataDone(bool /*ok*/) {}
/// Notifies the application that a StartRead operation completed. /// Notifies the application that a StartRead operation completed.
/// ///
/// \param[in] ok Was it successful? If false, no new read/write operation /// \param[in] ok Was it successful? If false, no new read/write operation
/// will succeed, and any further Start* should not be called. /// will succeed.
virtual void OnReadDone(bool /*ok*/) {} virtual void OnReadDone(bool /*ok*/) {}
/// Notifies the application that a StartWrite or StartWriteLast operation /// Notifies the application that a StartWrite or StartWriteLast operation
/// completed. /// completed.
/// ///
/// \param[in] ok Was it successful? If false, no new read/write operation /// \param[in] ok Was it successful? If false, no new read/write operation
/// will succeed, and any further Start* should not be called. /// will succeed.
virtual void OnWriteDone(bool /*ok*/) {} virtual void OnWriteDone(bool /*ok*/) {}
/// Notifies the application that a StartWritesDone operation completed. Note /// Notifies the application that a StartWritesDone operation completed. Note

Loading…
Cancel
Save