compositor: Document refs for alternatives/assumptions for backend configs

1 files changed, 6 insertions, 0 deletions

diff --git a/src/compositor.h b/src/compositor.h
index f93d76a0..45ffb6c9 100644
--- a/src/compositor.h
+++ b/src/compositor.h
@@ -682,6 +682,12 @@ struct weston_backend_output_config {
  * passed to the backend's init entry point. The backend will
  * likely want to subclass this in order to handle backend specific
  * data.
+ *
+ * NOTE: Alternate designs were proposed (Feb 2016) for using opaque
+ * structures and for section+key/value getter/setters.  The rationale
+ * for selecting the transparent structure design is based on several
+ * assumptions which may require re-evaluating the design choice if they
+ * fail to hold.
  */
 struct weston_backend_config {
    /** Major version for the backend-specific config struct