From: Jaroslav Kysela <perex@perex.cz>
Date: Mon, 28 Jan 2002 18:11:45 +0000 (+0000)
Subject: Added more informative comments to open mode flags
X-Git-Tag: v1.0.3~492
X-Git-Url: https://git.alsa-project.org/?a=commitdiff_plain;h=d57853a90a6a25675c505ba7f06c02839503b5ca;p=alsa-lib.git

Added more informative comments to open mode flags
---

diff --git a/include/control.h b/include/control.h
index 61ead1c4..f6810642 100644
--- 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 2061de81..31288b2e 100644
--- 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 84849bce..a0d2a265 100644
--- 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 dac3ec3e..e7093b11 100644
--- 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 1dc303e8..934a2985 100644
--- 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 cdf019d1..a33ce317 100644
--- 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 {