pcm: snd_pcm_(physical_)format_width() - change documentation

The word "nominal" is not so correct here. Use similar
wording as we use in the kernel space (the bit-width of the format).

Link: https://github.com/larsimmisch/pyalsaaudio/pull/146
Signed-off-by: Jaroslav Kysela <perex@perex.cz>

diff --git a/src/pcm/pcm_misc.c b/src/pcm/pcm_misc.c
index 04b131259e7c81f80cf47d05c02caf541e4b847d..3cff4326f94ed5e03fafb8c410bc13943e7e6700 100644 (file)
--- a/src/pcm/pcm_misc.c
+++ b/src/pcm/pcm_misc.c
@@ -203,9 +203,9 @@ int snd_pcm_format_cpu_endian(snd_pcm_format_t format)
 }
 
 /**
- * \brief Return nominal bits per a PCM sample
+ * \brief Return the bit-width of the format
  * \param format Sample format
- * \return bits per sample, a negative error code if not applicable
+ * \return the bit-width of the format, or a negative error code if not applicable
  */
 int snd_pcm_format_width(snd_pcm_format_t format)
 {
@@ -270,9 +270,9 @@ int snd_pcm_format_width(snd_pcm_format_t format)
 }
 
 /**
- * \brief Return bits needed to store a PCM sample
+ * \brief Return the physical bit-width of the format (bits needed to store a PCM sample)
  * \param format Sample format
- * \return bits per sample, a negative error code if not applicable
+ * \return the physical bit-width of the format, or a negative error code if not applicable
  */
 int snd_pcm_format_physical_width(snd_pcm_format_t format)
 {