Apply suggestions from code review

Co-authored-by: Boris Zbarsky <[email protected]>

src/protocols/bdx/BdxTransferSession.h

@@ -169,10 +169,10 @@ class DLL_EXPORT TransferSession
      * @brief
      *   Gets the pending output event from the transfer session in the event param passed in by the caller.
      *   The output event may contain some data for the caller to act upon. If there is no pending output event,
-     *   the caller will get an event of type - OutputEventType::kNone.
+     *   the caller will get an event of type OutputEventType::kNone.
      *
      *   It is possible that consecutive calls to this method may emit different outputs depending on the state of the
-     *   TransferSession object and the caller needs to call this until we get an event of type - OutputEventType::kNone
+     *   TransferSession object.  The caller is generally expected to keep calling this method until it gets an event of type OutputEventType::kNone.
      *
      *   If the output event type is kMsgToSend, the caller is expected to send the message immediately on the
      *   relevant exchange.  In this case the BDX session timeout timer will start when GetNextAction is called.