--- OpenCL/OpenCL.pm	2012/05/04 14:49:42	1.72
+++ OpenCL/OpenCL.pm	2012/05/05 02:45:38	1.76
@@ -436,13 +436,20 @@
 perhaps most important, to signal completion of queued jobs (by setting
 callbacks on OpenCL::Event objects).
 
+The OpenCL module converts all these callbacks into events - you can
+still register callbacks, but they are not executed when your OpenCL
+implementation calls the actual callback, but only later. Therefore, none
+of the limitations of OpenCL callbacks apply to the perl implementation:
+it is perfectly safe to make blocking operations from event callbacks, and
+enqueued operations don't need to be flushed.
+
 To facilitate this, this module maintains an event queue - each
 time an asynchronous event happens, it is queued, and perl will be
 interrupted. This is implemented via the L<Async::Interrupt> module. In
 addition, this module has L<AnyEvent> support, so it can seamlessly
 integrate itself into many event loops.
 
-Since this module is a bit hard to understand, here are some case examples:
+Since L<Async::Interrupt> is a bit hard to understand, here are some case examples:
 
 =head3 Don't use callbacks.
 
@@ -615,6 +622,7 @@
 =item $ctx = OpenCL::context_from_type $properties, $type = OpenCL::DEVICE_TYPE_DEFAULT, $callback->($err, $pvt) = $print_stderr
 
 Tries to create a context from a default device and platform type - never worked for me.
+Consider using C<< $platform->context_from_type >> instead.
 
 type: OpenCL::DEVICE_TYPE_DEFAULT, OpenCL::DEVICE_TYPE_CPU, OpenCL::DEVICE_TYPE_GPU,
 OpenCL::DEVICE_TYPE_ACCELERATOR, OpenCL::DEVICE_TYPE_CUSTOM, OpenCL::DEVICE_TYPE_ALL.
@@ -623,8 +631,8 @@
 
 =item $ctx = OpenCL::context $properties, \@devices, $callback->($err, $pvt) = $print_stderr)
 
-Create a new OpenCL::Context object using the given device object(s). This
-function isn't implemented yet, use C<< $platform->context >> instead.
+Create a new OpenCL::Context object using the given device object(s).
+Consider using C<< $platform->context >> instead.
 
 L<http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clCreateContext.html>
 
@@ -1266,6 +1274,13 @@
 
 L<http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateProgramWithBuiltInKernels.html>
 
+=item $program = $ctx->link_program (\@devices, $options, \@programs, $cb->($program) = undef)
+
+Links all (already compiled) program objects specified in C<@programs>
+together and returns a new OpenCL::Program object with the result.
+
+L<http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clLinkProgram.html>
+
 =item $packed_value = $ctx->info ($name)
 
 See C<< $platform->info >> for details.
@@ -1768,6 +1783,9 @@
 C<-w>, C<-Werror>, C<-cl-std=CL1.1/CL1.2>, C<-cl-kernel-arg-info>,
 C<-create-library>, C<-enable-link-options>.
 
+build_status: OpenCL::BUILD_SUCCESS, OpenCL::BUILD_NONE,
+OpenCL::BUILD_ERROR, OpenCL::BUILD_IN_PROGRESS.
+
 L<http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clBuildProgram.html>
 
 =item $program->build_async (\@devices = undef, $options = "", $cb->($program) = undef)
@@ -1775,8 +1793,13 @@
 Similar to C<< ->build >>, except it starts a thread, and never fails (you
 need to check the compilation status form the callback, or by polling).
 
-build_status: OpenCL::BUILD_SUCCESS, OpenCL::BUILD_NONE,
-OpenCL::BUILD_ERROR, OpenCL::BUILD_IN_PROGRESS.
+=item $program->compile (\@devices = undef, $options = "", \%headers = undef, $cb->($program) = undef)
+
+Compiles the given program for the given devices (or all devices if
+undef). If C<$headers> is given, it must be a hashref with include name =>
+OpenCL::Program pairs.
+
+L<http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCompileProgram.html>
 
 =item $packed_value = $program->build_info ($device, $name)
 
@@ -1899,9 +1922,6 @@
 
 See C<< $platform->info >> for details.
 
-The reason this method is not called C<info> is that there already is an
-C<< ->info >> method.
-
 L<http://www.khronos.org/registry/cl/sdk/1.1/docs/man/xhtml/clGetKernelWorkGroupInfo.html>
 
 =for gengetinfo begin kernel_work_group
@@ -1928,9 +1948,35 @@
 
 =for gengetinfo end kernel_work_group
 
-=for gengetinfo begin kernel_arg_info
+=item $packed_value = $kernel->arg_info ($idx, $name)
+
+See C<< $platform->info >> for details.
+
+L<http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetKernelArgInfo.html>
+
+=for gengetinfo begin kernel_arg
+
+=item $kernel_arg_address_qualifier = $kernel->arg_address_qualifier ($idx)
+
+Calls C<clGetKernelArgInfo> with C<OpenCL::KERNEL_ARG_ADDRESS_QUALIFIER> and returns the result.
+
+=item $kernel_arg_access_qualifier = $kernel->arg_access_qualifier ($idx)
+
+Calls C<clGetKernelArgInfo> with C<OpenCL::KERNEL_ARG_ACCESS_QUALIFIER> and returns the result.
+
+=item $string = $kernel->arg_type_name ($idx)
+
+Calls C<clGetKernelArgInfo> with C<OpenCL::KERNEL_ARG_TYPE_NAME> and returns the result.
+
+=item $kernel_arg_type_qualifier = $kernel->arg_type_qualifier ($idx)
+
+Calls C<clGetKernelArgInfo> with C<OpenCL::KERNEL_ARG_TYPE_QUALIFIER> and returns the result.
+
+=item $string = $kernel->arg_name ($idx)
+
+Calls C<clGetKernelArgInfo> with C<OpenCL::KERNEL_ARG_NAME> and returns the result.
 
-=for gengetinfo end kernel_arg_info
+=for gengetinfo end kernel_arg
 
 =item $kernel->setf ($format, ...)