alsa-project/alsa-lib issue #44 was opened from archenemies:
The following documentation is incomplete. It doesn't explain what "avail min" or "avail max" means. It's like asking someone you just met "what is your maximum age?". We need more context for the phrase "maximum number of frames available" to be meaningful. Is it maximum allowed before frames start getting dropped? Is it the maximum that we've seen over the course of operating the device?
https://www.alsa-project.org/alsa-doc/alsa-lib/group___p_c_m___s_w___params....
snd_pcm_sw_params_get_avail_min()
Get avail min from a software configuration container.
https://www.alsa-project.org/alsa-doc/alsa-lib/group___p_c_m___status.html#g...
snd_pcm_status_get_avail_max()
Get maximum number of frames available from a PCM status container after last snd_pcm_status call.
Returns Maximum number of frames ready to be read/written
The following is less important, but it still should be fixed. We need to explain what a "software configuration container" is. The phrase is used all over the place; it only needs to be defined once:
https://www.alsa-project.org/alsa-doc/alsa-lib/group___p_c_m.html#ga7e082d9e...
snd_pcm_sw_params_t
typedef struct _snd_pcm_sw_params snd_pcm_sw_params_t
PCM software configuration container
Issue URL : https://github.com/alsa-project/alsa-lib/issues/44 Repository URL: https://github.com/alsa-project/alsa-lib