Added more informative comments to open mode flags

diff --git a/include/control.h b/include/control.h
index 61ead1c404b7c37e37703895cb98d8a46c7a2619..f6810642cd343df66b09b19ab70173f06009f2e2 100644 (file)
--- a/include/control.h
+++ b/include/control.h
@@ -171,10 +171,10 @@ typedef enum _snd_ctl_type {
        SND_CTL_TYPE_INET
 } snd_ctl_type_t;
 
-/** Non blocking mode \hideinitializer */
+/** Non blocking mode (flag for open mode) \hideinitializer */
 #define SND_CTL_NONBLOCK               0x0001
 
-/** Async notification \hideinitializer */
+/** Async notification (flag for open mode) \hideinitializer */
 #define SND_CTL_ASYNC                  0x0002
 
 /** CTL handle */

diff --git a/include/hwdep.h b/include/hwdep.h
index 2061de81d8d8195d8459764b452296a7002e747d..31288b2e73bcb0bd94a2cdc66a68db0f2b35fbc2 100644 (file)
--- a/include/hwdep.h
+++ b/include/hwdep.h
@@ -62,7 +62,7 @@ typedef enum _snd_hwdep_iface {
 #define SND_HWDEP_OPEN_WRITE           (O_WRONLY)
 /** open for reading and writing */
 #define SND_HWDEP_OPEN_DUPLEX          (O_RDWR)
-/** flag: open in nonblock mode */
+/** open mode flag: open in nonblock mode */
 #define SND_HWDEP_OPEN_NONBLOCK                (O_NONBLOCK)
 
 /** HwDep handle type */

diff --git a/include/pcm.h b/include/pcm.h
index 84849bce344e4a17479d3ceffafe71229b5de37e..a0d2a2650933b1bbfc5be7379d6a750ef9b47d6c 100644 (file)
--- a/include/pcm.h
+++ b/include/pcm.h
@@ -267,9 +267,9 @@ typedef long snd_pcm_sframes_t;
 /** Timestamp */
 typedef struct timeval snd_timestamp_t;
 
-/** Non blocking mode \hideinitializer */
+/** Non blocking mode (flag for open mode) \hideinitializer */
 #define SND_PCM_NONBLOCK               0x0001
-/** Async notification \hideinitializer */
+/** Async notification (flag for open mode) \hideinitializer */
 #define SND_PCM_ASYNC                  0x0002
 
 /** PCM handle */

diff --git a/include/rawmidi.h b/include/rawmidi.h
index dac3ec3e2124c0af565e3d3c3a9e92937104a8b5..e7093b11fbace006a8c625a296c46693aaae1c83 100644 (file)
--- a/include/rawmidi.h
+++ b/include/rawmidi.h
@@ -57,12 +57,12 @@ typedef enum _snd_rawmidi_stream {
        SND_RAWMIDI_STREAM_LAST = SND_RAWMIDI_STREAM_INPUT,
 } snd_rawmidi_stream_t;
 
-/** Append \hideinitializer */
-#define SND_RAWMIDI_APPEND     1
-/** Non blocking mode \hideinitializer */
-#define SND_RAWMIDI_NONBLOCK   2
-/** Write sync mode \hideinitializer */
-#define SND_RAWMIDI_SYNC       4
+/** Append (flag to open mode) \hideinitializer */
+#define SND_RAWMIDI_APPEND     0x0001
+/** Non blocking mode (flag to open mode) \hideinitializer */
+#define SND_RAWMIDI_NONBLOCK   0x0002
+/** Write sync mode (Flag to open mode) \hideinitializer */
+#define SND_RAWMIDI_SYNC       0x0004
 
 /** RawMidi handle */
 typedef struct _snd_rawmidi snd_rawmidi_t;

diff --git a/include/seq.h b/include/seq.h
index 1dc303e8f1e948d07223c502b56e03f4f10ef967..934a2985c2fca7e196f57fc4cd8bfee3ca29acfa 100644 (file)
--- a/include/seq.h
+++ b/include/seq.h
@@ -62,7 +62,7 @@ do {\
 /**
  * sequencer opening mode
  */
-#define SND_SEQ_NONBLOCK       1       /**< non-blocking mode */
+#define SND_SEQ_NONBLOCK       0x0001  /**< non-blocking mode (flag to open mode) */
 
 /** sequencer handle type */
 typedef enum _snd_seq_type {

diff --git a/include/timer.h b/include/timer.h
index cdf019d19227681c6ac50f66f2d40059b4226e9f..a33ce317527dae91999c664c526f1891e6a5d3ff 100644 (file)
--- a/include/timer.h
+++ b/include/timer.h
@@ -81,8 +81,8 @@ typedef enum _snd_timer_slave_class {
 /** global timer - RTC */
 #define SND_TIMER_GLOBAL_RTC   1
 
-/** timer open mode flag - nonblock */
-#define SND_TIMER_OPEN_NONBLOCK                1
+/** timer open mode flag - nonblocking behaviour */
+#define SND_TIMER_OPEN_NONBLOCK                0x0001
 
 /** timer handle type */
 typedef enum _snd_timer_type {