Index: third_party/mojo/src/mojo/public/cpp/system/handle.h |
diff --git a/third_party/mojo/src/mojo/public/cpp/system/handle.h b/third_party/mojo/src/mojo/public/cpp/system/handle.h |
index 0c5adc77aa1f02825ace5845274597130b1387a0..45624bc66d80c2170637c7e86d4a21b4dc0a3487 100644 |
--- a/third_party/mojo/src/mojo/public/cpp/system/handle.h |
+++ b/third_party/mojo/src/mojo/public/cpp/system/handle.h |
@@ -61,23 +61,8 @@ namespace mojo { |
// |ScopedHandleBase<SharedBufferHandle>|) as an "out" parameter. |
// |
// An exception are some of the |...Raw()| functions. E.g., |CloseRaw()| takes a |
-// |Handle|, leaving the user to discard the handle. |
+// |Handle|, leaving the user to discard the wrapper. |
// |
-// More significantly, |WriteMessageRaw()| exposes the full API complexity of |
-// |MojoWriteMessage()| (but doesn't require any extra overhead). It takes a raw |
-// array of |Handle|s as input, and takes ownership of them (i.e., invalidates |
-// them) on *success* (but not on failure). There are a number of reasons for |
-// this. First, C++03 |std::vector|s cannot contain the move-only |
-// |Scoped...Handle|s. Second, |std::vector|s impose extra overhead |
-// (necessitating heap-allocation of the buffer). Third, |std::vector|s wouldn't |
-// provide the desired level of flexibility/safety: a vector of handles would |
-// have to be all of the same type (probably |Handle|/|ScopedHandle|). Fourth, |
-// it's expected to not be used directly, but instead be used by generated |
-// bindings. |
-// |
-// Other |...Raw()| functions expose similar rough edges, e.g., dealing with raw |
-// pointers (and lengths) instead of taking |std::vector|s or similar. |
- |
// ScopedHandleBase ------------------------------------------------------------ |
// Scoper for the actual handle types defined further below. It's move-only, |