--- OpenCL/OpenCL.pm	2011/11/17 06:22:29	1.18
+++ OpenCL/OpenCL.pm	2011/11/19 19:54:04	1.19
@@ -228,19 +228,17 @@
 to free objects explicitly (C<clReleaseXXX>), the release function
 is called automatically once all Perl references to it go away.
 
-=item * OpenCL uses CamelCase for function names (C<clGetPlatformInfo>),
+=item * OpenCL uses CamelCase for function names (e.g. C<clGetPlatformIDs>, C<clGetPlatformInfo>),
 while this module uses underscores as word separator and often leaves out
-prefixes (C<< $platform->info >>).
+prefixes (C<OpenCL::platforms>, C<< $platform->info >>).
 
 =item * OpenCL often specifies fixed vector function arguments as short
-arrays (C<$origin[3]>), while this module explicitly expects the
-components as separate arguments-
+arrays (C<size_t origin[3]>), while this module explicitly expects the
+components as separate arguments (C<$orig_x, $orig_y, $orig_z>) in
+function calls.
 
-=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.
+=item * Structures are often specified by flattening out their components
+as with short vectors, and returned as arrayrefs.
 
 =item * When enqueuing commands, the wait list is specified by adding
 extra arguments to the function - anywhere a C<$wait_events...> argument