-struct check_wav_task *check_wav_init(struct sched *s, struct btr_node *parent,
- struct wav_params *params, struct btr_node **cwt_btrn)
+/**
+ * Allocate and set up a new check_wav instance.
+ *
+ * \param parent This buffer tree node will be the parent of the new node.
+ * \param child The child of the new node.
+ * \param params Default values and options.
+ * \param cw_btrn A pointer to the check wav node is returned here.
+ *
+ * This function also sets up the ->execute handler of the btrn so that all
+ * children of this node can figure out channel count, sample rate, etc.
+ *
+ * \return The (opaque) handle of the newly created check_wav instance. It is
+ * supposed to be passed to \ref check_wav_pre_select() and \ref
+ * check_wav_post_select().
+ *
+ * \sa \ref btr_new_node.
+ */
+struct check_wav_context *check_wav_init(struct btr_node *parent,
+ struct btr_node *child, struct wav_params *params,
+ struct btr_node **cw_btrn)