--- OpenCL/OpenCL.pm	2011/11/17 02:56:47	1.12
+++ OpenCL/OpenCL.pm	2011/11/17 03:02:25	1.14
@@ -203,8 +203,8 @@
 
 =head2 BASIC CONVENTIONS
 
-This is not a 1:1 C-style translation of OpenCL to Perl - instead I
-attempted to make the interface as type-safe as possible and introducing
+This is not a one-to-one C-style translation of OpenCL to Perl - instead
+I attempted to make the interface as type-safe as possible by introducing
 object syntax where it makes sense. There are a number of important
 differences between the OpenCL C API and this module:
 
@@ -222,6 +222,9 @@
 arrays (C<size_t origin[3]>), while this module explicitly expects the
 components as separate arguments-
 
+=item * Structures are often specified with their components, and returned
+as arrayrefs.
+
 =item * Where possible, one of the pitch values is calculated from the
 perl scalar length and need not be specified.