From 64b729f3284ead6a71fbeb7f8e0dd22187b21786 Mon Sep 17 00:00:00 2001 From: "Matthias P. Braendli" Date: Fri, 8 Jul 2016 11:50:26 +0200 Subject: Add doxygen configuration and target --- src/AlsaInput.h | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) (limited to 'src/AlsaInput.h') diff --git a/src/AlsaInput.h b/src/AlsaInput.h index 34886df..a17134b 100644 --- a/src/AlsaInput.h +++ b/src/AlsaInput.h @@ -16,6 +16,10 @@ * and limitations under the License. * ------------------------------------------------------------------- */ +/*! \section ALSA Input + * + * This input uses libasound to get audio data. + */ #ifndef __ALSA_H_ #define __ALSA_H_ @@ -34,8 +38,9 @@ #include "SampleQueue.h" #include "common.h" -/* Common functionality for the direct alsa input and the - * threaded alsa input +/*! Common functionality for the direct alsa input and the + * threaded alsa input. The threaded one is used for + * drift compensation. */ class AlsaInput { @@ -80,10 +85,10 @@ class AlsaInputDirect : public AlsaInput unsigned int rate) : AlsaInput(alsa_dev, channels, rate) { } - /* Read length Bytes from from the alsa device. + /*! Read length Bytes from from the alsa device. * length must be a multiple of channels * bytes_per_sample. * - * Returns the number of bytes read. + * \return the number of bytes read. */ ssize_t read(uint8_t* buf, size_t length); @@ -112,7 +117,7 @@ class AlsaInputThreaded : public AlsaInput } } - /* Start the ALSA thread that fills the queue */ + /*! Start the ALSA thread that fills the queue */ virtual void start(); bool fault_detected() { return m_fault; }; -- cgit v1.2.3