From 6faf38313e5f313cbcfe5c78af1dd310131798d2 Mon Sep 17 00:00:00 2001 From: Mads Kiilerich Date: Fri, 11 Dec 2009 16:20:31 +0100 Subject: headers: Some trivial fixes for some documentation typos Note also the willneed/will_need inconsistency. I guess it could be nice to ASAP choose one of them and introduce a backward compatibility hack for the other. The issues was mostly found with: for a in $(grep -r '^[ /]\*.*()' $( find -name '*.[ch]') | sed 's,^.* \([^ ]*\)().*$,\1,g' | sort | uniq | grep ^pa_) do grep -rq "^.[^*].*\<$a(" $(find * -name '*.h') || echo $a done --- src/pulse/def.h | 3 ++- src/pulse/introspect.h | 2 +- src/pulse/proplist.h | 2 +- src/pulse/simple.h | 4 ++-- src/pulse/stream.h | 4 ++-- src/pulse/volume.h | 6 +++--- 6 files changed, 11 insertions(+), 10 deletions(-) (limited to 'src/pulse') diff --git a/src/pulse/def.h b/src/pulse/def.h index 30a076d5..82106ef8 100644 --- a/src/pulse/def.h +++ b/src/pulse/def.h @@ -63,6 +63,7 @@ static inline int PA_CONTEXT_IS_GOOD(pa_context_state_t x) { #define PA_CONTEXT_SETTING_NAME PA_CONTEXT_SETTING_NAME #define PA_CONTEXT_READY PA_CONTEXT_READY #define PA_CONTEXT_FAILED PA_CONTEXT_FAILED +#define PA_CONTEXT_TERMINATED PA_CONTEXT_TERMINATED #define PA_CONTEXT_IS_GOOD PA_CONTEXT_IS_GOOD /** \endcond */ @@ -351,7 +352,7 @@ typedef struct pa_buffer_attr { * that may be. Initialize to 0 to enable manual start/stop * control of the stream. This means that playback will not stop * on underrun and playback will not start automatically. Instead - * pa_stream_corked() needs to be called explicitly. If you set + * pa_stream_cork() needs to be called explicitly. If you set * this value to 0 you should also set PA_STREAM_START_CORKED. */ uint32_t minreq; diff --git a/src/pulse/introspect.h b/src/pulse/introspect.h index 68cfc874..f9d22b29 100644 --- a/src/pulse/introspect.h +++ b/src/pulse/introspect.h @@ -460,7 +460,7 @@ typedef struct pa_card_info { pa_proplist *proplist; /**< Property list */ } pa_card_info; -/** Callback prototype for pa_context_get_card_info() and friends \since 0.9.15 */ +/** Callback prototype for pa_context_get_card_info_...() \since 0.9.15 */ typedef void (*pa_card_info_cb_t) (pa_context *c, const pa_card_info*i, int eol, void *userdata); /** Get information about a card by its index \since 0.9.15 */ diff --git a/src/pulse/proplist.h b/src/pulse/proplist.h index aae05346..e3f0af07 100644 --- a/src/pulse/proplist.h +++ b/src/pulse/proplist.h @@ -325,7 +325,7 @@ void pa_proplist_update(pa_proplist *p, pa_update_mode_t mode, pa_proplist *othe * specified key name. \since 0.9.11 */ int pa_proplist_unset(pa_proplist *p, const char *key); -/** Similar to pa_proplist_remove() but takes an array of keys to +/** Similar to pa_proplist_unset() but takes an array of keys to * remove. The array should be terminated by a NULL pointer. Return -1 * on failure, otherwise the number of entries actually removed (which * might even be 0, if there where no matching entries to diff --git a/src/pulse/simple.h b/src/pulse/simple.h index 6f1ba414..b1f65374 100644 --- a/src/pulse/simple.h +++ b/src/pulse/simple.h @@ -82,8 +82,8 @@ * * \li pa_simple_drain() - Will wait for all sent data to finish playing. * \li pa_simple_flush() - Will throw away all data currently in buffers. - * \li pa_simple_get_playback_latency() - Will return the total latency of - * the playback pipeline. + * \li pa_simple_get_latency() - Will return the total latency of + * the playback pipeline. * * \section cleanup_sec Cleanup * diff --git a/src/pulse/stream.h b/src/pulse/stream.h index bc54a118..b9057885 100644 --- a/src/pulse/stream.h +++ b/src/pulse/stream.h @@ -289,7 +289,7 @@ * issued on the others. * * To synchronize a stream to another, just pass the "master" stream - * as last argument to pa_stream_connect_playack(). To make sure that + * as last argument to pa_stream_connect_playback(). To make sure that * the freshly created stream doesn't start playback right-away, make * sure to pass PA_STREAM_START_CORKED and - after all streams have * been created - uncork them all with a single call to @@ -716,7 +716,7 @@ pa_operation *pa_stream_set_buffer_attr(pa_stream *s, const pa_buffer_attr *attr /** Change the stream sampling rate during playback. You need to pass * PA_STREAM_VARIABLE_RATE in the flags parameter of - * pa_stream_connect() if you plan to use this function. Only valid + * pa_stream_connect_...() if you plan to use this function. Only valid * after the stream has been connected successfully and if the server * is at least PulseAudio 0.9.8. \since 0.9.8 */ pa_operation *pa_stream_update_sample_rate(pa_stream *s, uint32_t rate, pa_stream_success_cb_t cb, void *userdata); diff --git a/src/pulse/volume.h b/src/pulse/volume.h index ded4422e..185c3419 100644 --- a/src/pulse/volume.h +++ b/src/pulse/volume.h @@ -149,7 +149,7 @@ pa_cvolume* pa_cvolume_set(pa_cvolume *a, unsigned channels, pa_volume_t v); char *pa_cvolume_snprint(char *s, size_t l, const pa_cvolume *c); /** Maximum length of the strings returned by - * pa_cvolume_snprint_dB(). Please note that this value can change with + * pa_sw_cvolume_snprint_dB(). Please note that this value can change with * any release without warning and without being considered API or ABI * breakage. You should not use this definition anywhere where it * might become part of an ABI. \since 0.9.13 */ @@ -169,7 +169,7 @@ char *pa_sw_cvolume_snprint_dB(char *s, size_t l, const pa_cvolume *c); char *pa_volume_snprint(char *s, size_t l, pa_volume_t v); /** Maximum length of the strings returned by - * pa_volume_snprint_dB(). Please note that this value can change with + * pa_sw_volume_snprint_dB(). Please note that this value can change with * any release without warning and without being considered API or ABI * breakage. You should not use this definition anywhere where it * might become part of an ABI. \since 0.9.15 */ @@ -268,7 +268,7 @@ double pa_sw_volume_to_linear(pa_volume_t v) PA_GCC_CONST; #ifdef INFINITY #define PA_DECIBEL_MININFTY ((double) -INFINITY) #else -/** This floor value is used as minus infinity when using pa_volume_{to,from}_dB(). */ +/** This floor value is used as minus infinity when using pa_sw_volume_to_dB() / pa_sw_volume_from_dB(). */ #define PA_DECIBEL_MININFTY ((double) -200.0) #endif -- cgit