From 743a82148dd2ddfdbd0eba24b208f1249ab4065d Mon Sep 17 00:00:00 2001
From: don bright <hugh.m.bright@gmail.com>
Date: Sat, 26 Jan 2013 19:55:34 +0100
Subject: explain our unusual portability system


diff --git a/src/OffscreenContext.h b/src/OffscreenContext.h
index a32ea2c..0c700b6 100644
--- a/src/OffscreenContext.h
+++ b/src/OffscreenContext.h
@@ -1,6 +1,9 @@
 #ifndef OFFSCREENCONTEXT_H_
 #define OFFSCREENCONTEXT_H_
 
+// Here we implement a 'portability' pattern but since we are mixing
+// Objective-C with C++, it is a bit different than what's found in a textbook.
+
 #include <iostream>
 #include <fstream>
 #include <string>
diff --git a/src/OffscreenContextAll.hpp b/src/OffscreenContextAll.hpp
index 8ee7ebe..1c73b73 100644
--- a/src/OffscreenContextAll.hpp
+++ b/src/OffscreenContextAll.hpp
@@ -1,4 +1,5 @@
-// Functions shared by OffscreenContext[platform].cc
+// Functions shared by OffscreenContext[platform].cc (or .mm)
+// #include directly after definition of struct OffscreenContext.
 
 void bind_offscreen_context(OffscreenContext *ctx)
 {
-- 
cgit v0.10.1