- update to version 3.6.0
* libcw no longer uses signals (and SIGALRM in particular) for any
internal purpose. Internal communication between generator and
queue has been re-implemented using other mechanism:
pthread_cond_wait() and pthread_cond_broadcast().
* in relation to the above, in order to avoid calling of
pthread_cond_wait() and pthread_cond_broadcast() in signal
handlers, the SIG_IGN and SIG_DFL values registered with
cw_register_signal_handler() are completely ignored. It is
strongly advised to avoid any libcw cleanup or calls to exit() in
signal handlers (registered with either with
cw_register_signal_handler() or with more direct methods).
* enabling ALSA's configuration of HW period size.
* ALSA period size (in samples) used by applications (cw, cwcp,
xcwcp) can be specified in command line through --alsa-period-size
command line arg.
* modifying PulseAudio parameters to decrease XRUNS and improve
behaviour of callback registered by client code in library.
* Behaviour of cw_lookup_phonetic() library function has been modified: the
function now accepts NULL as a second argument (output buffer).
* Several items in libcw_debug.h are marked as deprecated. These items
should be used only internally, during development of libcw, and should
not be used by client code. They will be removed from the header in the
future.
* Declaration of cw_debug_print_flags() has been removed from libcw_debug.h
header. The function was not defined in the library, so no one could have
used the function.
* Function cw_generator_set_tone_slope() from libcw.h is now marked as
deprecated. The function was/is unusable because there is no way that
client code can pass a cw_gen_t variable as first argument.
* Replacing some usages of double type with float type. There is very
little (or maybe even nothing) in the library that would require
precision or range of double.
* Adding new function: cw_generator_remove_last_character(). The function
removes last character enqueued to generator, it can be called multiple
times to remove a group of characters. The function can be used e.g. in
reaction to Backspace character pressed in User Interface.
* modifications to receiver functions:
cw_receive_character(), cw_receive_representation(),
cw_start_receive_tone() and cw_end_receive_tone() are now actually
setting errno to EINVAL (as described in documentation) when they detect
that input timestamp (when the timestamp is non-NULL) is in some way
invalid.
cw_receive_buffer_dot() and cw_receive_buffer_dash() set additional value
of errno (EINVAL) when they detect that input timestamp (when the
timestamp is non-NULL) is in some way invalid.
* cw_wait_for_tone_queue_critical() now sets errno to EINVAL and returns
CW_FAILURE if function's argument is negative.
* there is a hard limit on length of name of sound device: 127
characters (+1 for terminating NUL).
* library soname/version changed from 6.6.1 to 7.0.0.
- xcwcp:
* program's command line option "--sound" has been changed to
"--system", for consistency with similar option in other unixcw
programs.