...

2 files changed, 11 insertions, 0 deletions

diff --git a/include/cru/common/event.hpp b/include/cru/common/event.hpp
index af282c30..144513b6 100644
--- a/include/cru/common/event.hpp
+++ b/include/cru/common/event.hpp
@@ -79,6 +79,9 @@ inline EventRevoker details::EventBase::CreateRevoker(EventHandlerToken token) {
   return EventRevoker(resolver_, token);
 }
 
+// int -> int
+// Point -> const Point&
+// int& -> int&
 template <typename TRaw>
 using DeducedEventArgs = std::conditional_t<
     std::is_lvalue_reference_v<TRaw>, TRaw,
diff --git a/include/cru/platform/native/native_window.hpp b/include/cru/platform/native/native_window.hpp
index 3e83a531..bb97ef21 100644
--- a/include/cru/platform/native/native_window.hpp
+++ b/include/cru/platform/native/native_window.hpp
@@ -11,6 +11,14 @@ struct IPainter;
 }
 
 namespace cru::platform::native {
+// Represents a native window, which exposes some low-level events and
+// operations.
+//
+// Although you can always retain an instance of this class, the real window
+// associated with it might be have already been destroyed by explicitly calling
+// Close or closed by the user, which leads to an invalid instance. You can
+// check the validity by IsValid. When you call perform native operations on the
+// invalid instance, there is no effect.
 struct INativeWindow : public virtual Interface {
   // Return if the window is still valid, that is, hasn't been closed or
   // destroyed.