Improve comment

cpp/include/kvikio/file_handle.hpp

@@ -247,9 +247,10 @@ class FileHandle {
    * in the null stream. When in KvikIO's compatibility mode or when accessing host memory, the
    * operation is always default stream ordered like the rest of the non-async CUDA API. In this
    * case, the value of `sync_default_stream` is ignored.
-   * @return Future that on completion returns the size of bytes that were successfully read. The
-   * future object's wait() or get() should not be called after the lifetime of the FileHandle
-   * object. Otherwise, the behavior is undefined.
+   * @return Future that on completion returns the size of bytes that were successfully read.
+   *
+   * @note The `std::future` object's `wait()` or `get()` should not be called after the lifetime of
+   * the FileHandle object. Otherwise, the behavior is undefined.
    */
   std::future<std::size_t> pread(void* buf,
                                  std::size_t size,
@@ -283,9 +284,10 @@ class FileHandle {
    * in the null stream. When in KvikIO's compatibility mode or when accessing host memory, the
    * operation is always default stream ordered like the rest of the non-async CUDA API. In this
    * case, the value of `sync_default_stream` is ignored.
-   * @return Future that on completion returns the size of bytes that were successfully written. The
-   * future object's wait() or get() should not be called after the lifetime of the FileHandle
-   * object. Otherwise, the behavior is undefined.
+   * @return Future that on completion returns the size of bytes that were successfully written.
+   *
+   * @note The `std::future` object's `wait()` or `get()` should not be called after the lifetime of
+   * the FileHandle object. Otherwise, the behavior is undefined.
    */
   std::future<std::size_t> pwrite(const void* buf,
                                   std::size_t size,