diff options
author | David Fries <david@fries.net> | 2010-10-12 20:05:47 -0500 |
---|---|---|
committer | Colin Guthrie <cguthrie@mandriva.org> | 2010-10-13 09:07:39 +0100 |
commit | 2da3c47838ef548ba13965c145c408f0f01b94c9 (patch) | |
tree | ba77f762d8e8e82823b6a89c53f8415e34c98a8e /src/pulse/stream.h | |
parent | 9295e4a0dcd3aebd77b6732651bbd417c6cd2e46 (diff) |
doxygen: Documentation improvements
stream.h, simple.h
The words drain and flush are a little ambiguous, make it explicit as
to what happens to any existing audio.
*mainloop.h
reword *_free and *_get_api for grammar
Diffstat (limited to 'src/pulse/stream.h')
-rw-r--r-- | src/pulse/stream.h | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/src/pulse/stream.h b/src/pulse/stream.h index 46bc02a7..0985f5b2 100644 --- a/src/pulse/stream.h +++ b/src/pulse/stream.h @@ -529,9 +529,10 @@ size_t pa_stream_writable_size(pa_stream *p); /** Return the number of bytes that may be read using pa_stream_peek()*/ size_t pa_stream_readable_size(pa_stream *p); -/** Drain a playback stream. Use this for notification when the buffer - * is empty. Please note that only one drain operation per stream may - * be issued at a time. */ +/** Drain a playback stream. Use this for notification when the + * playback buffer is empty after playing all the audio in the buffer. + * Please note that only one drain operation per stream may be issued + * at a time. */ pa_operation* pa_stream_drain(pa_stream *s, pa_stream_success_cb_t cb, void *userdata); /** Request a timing info structure update for a stream. Use @@ -609,10 +610,10 @@ void pa_stream_set_buffer_attr_callback(pa_stream *p, pa_stream_notify_cb_t cb, * of the stream it will be created in corked state. */ pa_operation* pa_stream_cork(pa_stream *s, int b, pa_stream_success_cb_t cb, void *userdata); -/** Flush the playback buffer of this stream. Most of the time you're - * better off using the parameter delta of pa_stream_write() instead - * of this function. Available on both playback and recording - * streams. */ +/** Flush the playback buffer of this stream. This discards any audio + * in the buffer. Most of the time you're better off using the parameter + * delta of pa_stream_write() instead of this function. Available on both + * playback and recording streams. */ pa_operation* pa_stream_flush(pa_stream *s, pa_stream_success_cb_t cb, void *userdata); /** Reenable prebuffering as specified in the pa_buffer_attr |