afs.c: Improve documentation of send_option_arg_callback_request().
authorAndre Noll <maan@tuebingen.mpg.de>
Sun, 11 Jan 2015 13:24:14 +0000 (14:24 +0100)
committerAndre Noll <maan@tuebingen.mpg.de>
Mon, 12 Jan 2015 22:29:07 +0000 (23:29 +0100)
The new text tries to emphasize that arbitrary structures may be
passed from the command handler to the callback (*not* the parent
process).

afs.c

diff --git a/afs.c b/afs.c
index 68afec6..ab2cc74 100644 (file)
--- a/afs.c
+++ b/afs.c
@@ -292,10 +292,10 @@ out:
  * \param result_handler See \ref send_callback_request.
  * \param private_result_data See \ref send_callback_request.
  *
- * Some commands have a couple of options that are parsed in child context for
- * syntactic correctness and are stored in a special options structure for that
- * command. This function allows to pass such a structure together with a list
- * of further arguments (often a list of audio files) to the parent process.
+ * Some command handlers pass command-specific options to a callback, together
+ * with a list of further arguments (often a list of audio files). This
+ * function allows to pass an arbitrary structure (given as an osl object) and
+ * a usual argument vector to the specified callback.
  *
  * \return The return value of the underlying call to \ref
  * send_callback_request().