commit c38992fe636af5b42a1089a0c260633f629e1f84
author Fabien Sanglard <sanglardf@google.com> Thu Oct 27 19:05:29 2016 -0700
committer Fabien Sanglard <sanglardf@google.com> Mon Oct 31 11:04:22 2016 -0700
tree de81777d298debc7ed2a2ed6fbb693add740dc93
parent 8e7b508b53271fbc69f26119e55d8174dfb743d5

Document FlattenableHelper design decision

Change-Id: I163979c7b1b868e4396a9c70b262d0c4815f4e40

include/binder/Parcel.h

diff --git a/include/binder/Parcel.h b/include/binder/Parcel.h
index 954b976..39deb64 100644
--- a/include/binder/Parcel.h
+++ b/include/binder/Parcel.h
@@ -479,6 +479,8 @@
     #pragma clang diagnostic ignored "-Wweak-vtables"
     #endif
 
+    // FlattenableHelperInterface and FlattenableHelper avoid generating a vtable entry in objects
+    // following Flattenable template/protocol.
     class FlattenableHelperInterface {
     protected:
         ~FlattenableHelperInterface() { }
@@ -493,6 +495,9 @@
     #pragma clang diagnostic pop
     #endif
 
+    // Concrete implementation of FlattenableHelperInterface that delegates virtual calls to the
+    // specified class T implementing the Flattenable protocol. It "virtualizes" a compile-time
+    // protocol.
     template<typename T>
     class FlattenableHelper : public FlattenableHelperInterface {
         friend class Parcel;