>Number:         3303
>Category:       misc
>Synopsis:       audio(4) man page is incomplete.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people (Misc Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Mar  8 03:20:01 1997
>Last-Modified:
>Originator:     Lennart Augustsson
>Organization:
Department of Computing Science, Chalmers University
>Release:        NetBSD-current 97-03-07
>Environment:
System: NetBSD calvin.cs.chalmers.se 1.2C NetBSD 1.2C (CALVIN) #112: Sat Mar 8 00:06:18 MET 1997 augustss@calvin.cs.chalmers.se:/usr/src/sys/arch/i386/compile/CALVIN i386


>Description:
	The man page for audio(4) does not describe the AUMODE_PLAY_ALL
	mode.
>How-To-Repeat:
	Do `man 4 audio' and compare with /usr/include/audioio.h.
>Fix:
	Apply this patch:

*** share/man/man4/audio.4.old	Sat Mar  8 12:06:26 1997
--- share/man/man4/audio.4	Sat Mar  8 12:08:20 1997
***************
*** 116,122 ****
  hardware interrupt service, one or more audio silence blocks will be
  queued for playback.  The writing process must provide enough data via
  subsequent write calls to ``catch up'' in time to the current audio
! block before any more process-provided samples will be played.
  [Alternatively, the playing process can use one of the interfaces below
  to halt and later restart audio playback.]
  If a reading process does not call
--- 116,123 ----
  hardware interrupt service, one or more audio silence blocks will be
  queued for playback.  The writing process must provide enough data via
  subsequent write calls to ``catch up'' in time to the current audio
! block before any more process-provided samples will be played,
! unless the mode AUMODE_PLAY_ALL is used.
  [Alternatively, the playing process can use one of the interfaces below
  to halt and later restart audio playback.]
  If a reading process does not call
***************
*** 189,194 ****
--- 190,196 ----
  	u_int	mode;		/* current device mode */
  #define AUMODE_PLAY	0x01
  #define AUMODE_RECORD	0x02
+ #define AUMODE_PLAY_ALL	0x04	/* play all samples--no real-time correction */
  } audio_info_t;
  .Ed
  When setting the current state with AUDIO_SETINFO, the audio_info
>Audit-Trail:
>Unformatted: