increase PA_CVOLUME_SNPRINT_MAX to a proper value and document that it is not considered part of the ABI

This commit is contained in:
Lennart Poettering 2008-10-03 17:45:55 +02:00
parent bde142c237
commit 28af9944fe
3 changed files with 16 additions and 4 deletions

View file

@ -204,7 +204,11 @@ const char* pa_channel_position_to_string(pa_channel_position_t pos) PA_GCC_PURE
/** Return a human readable text label for the specified channel position. \since 0.9.7 */ /** Return a human readable text label for the specified channel position. \since 0.9.7 */
const char* pa_channel_position_to_pretty_string(pa_channel_position_t pos); const char* pa_channel_position_to_pretty_string(pa_channel_position_t pos);
/** The maximum length of strings returned by pa_channel_map_snprint() */ /** The maximum length of strings returned by
* pa_channel_map_snprint(). 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. */
#define PA_CHANNEL_MAP_SNPRINT_MAX 336 #define PA_CHANNEL_MAP_SNPRINT_MAX 336
/** Make a humand readable string from the specified channel map */ /** Make a humand readable string from the specified channel map */

View file

@ -249,7 +249,11 @@ const char *pa_sample_format_to_string(pa_sample_format_t f) PA_GCC_PURE;
/** Parse a sample format text. Inverse of pa_sample_format_to_string() */ /** Parse a sample format text. Inverse of pa_sample_format_to_string() */
pa_sample_format_t pa_parse_sample_format(const char *format) PA_GCC_PURE; pa_sample_format_t pa_parse_sample_format(const char *format) PA_GCC_PURE;
/** Maximum required string length for pa_sample_spec_snprint() */ /** Maximum required string length for
* pa_sample_spec_snprint(). 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. */
#define PA_SAMPLE_SPEC_SNPRINT_MAX 32 #define PA_SAMPLE_SPEC_SNPRINT_MAX 32
/** Pretty print a sample type specification to a string */ /** Pretty print a sample type specification to a string */

View file

@ -130,8 +130,12 @@ pa_cvolume* pa_cvolume_init(pa_cvolume *a);
/** Set the volume of all channels to the specified parameter */ /** Set the volume of all channels to the specified parameter */
pa_cvolume* pa_cvolume_set(pa_cvolume *a, unsigned channels, pa_volume_t v); pa_cvolume* pa_cvolume_set(pa_cvolume *a, unsigned channels, pa_volume_t v);
/** Maximum length of the strings returned by pa_cvolume_snprint() */ /** Maximum length of the strings returned by
#define PA_CVOLUME_SNPRINT_MAX 64 * pa_cvolume_snprint(). 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.*/
#define PA_CVOLUME_SNPRINT_MAX 320
/** Pretty print a volume structure */ /** Pretty print a volume structure */
char *pa_cvolume_snprint(char *s, size_t l, const pa_cvolume *c); char *pa_cvolume_snprint(char *s, size_t l, const pa_cvolume *c);