Add the JPortAudio JavaDocs to the PortAudio reference.

bindings/java/jportaudio.dox

@@ -6,10 +6,14 @@
 
 @section java_draft DRAFT - IN PROGRESS
 
-9/1/12 JPortAudio is very new and should be considered an "alpha" release.
+9/4/12 JPortAudio is very new and should be considered an "alpha" release.
 The building of JPortAudio will eventually be integrated into the Makefile as an optional build.
 
-Currently JPortAudio is only supported for Windows. Please contact us if you want to help with porting to Mac or Linux.
+Currently JPortAudio is only supported for Windows and Macintosh. Please contact us if you want to help with porting Linux.
+
+For reference documentation of the JPortAudio API see: com.portaudio.PortAudio
+
+For an example see: PlaySine.java
 
 @section java_comp_windows Building JPortAudio on Windows
 

bindings/java/jportaudio/src/com/portaudio/BlockingStream.java

@@ -36,6 +36,11 @@
  * license above.
  */
 
+/** @file
+ @ingroup bindings_java
+
+ @brief A blocking read/write stream.
+*/
 package com.portaudio;
 
 /**
@@ -46,6 +51,8 @@ package com.portaudio;
  * 
  * To create one of these, call PortAudio.openStream().
  * 
+ * @see PortAudio
+ * 
  * @author Phil Burk
  * 
  */

bindings/java/jportaudio/src/com/portaudio/DeviceInfo.java

@@ -36,10 +36,17 @@
  * license above.
  */
 
+/** @file
+ @ingroup bindings_java
+
+ @brief Information about a JPortAudio device.
+*/
 package com.portaudio;
 
 /**
  * Equivalent to PaDeviceInfo
+ * @see PortAudio
+ * @see HostApiInfo
  * @author Phil Burk
  *
  */

bindings/java/jportaudio/src/com/portaudio/HostApiInfo.java

@@ -36,10 +36,17 @@
  * license above.
  */
 
+/** @file
+ @ingroup bindings_java
+
+ @brief Information about a JPortAudio Host API.
+*/
 package com.portaudio;
 
 /**
  * Equivalent to PaHostApiInfo
+ * @see PortAudio
+ * @see DeviceInfo
  * @author Phil Burk
  *
  */

bindings/java/jportaudio/src/com/portaudio/PortAudio.java

@@ -36,6 +36,11 @@
  * license above.
  */
 
+/** @file
+ @ingroup bindings_java
+
+ @brief Java wrapper for the PortAudio API.
+*/
 package com.portaudio;
 
 /**
@@ -52,6 +57,12 @@ package com.portaudio;
  * garbage collection or synchronization. So only the blocking read/write mode
  * is supported.
  * 
+ * @see BlockingStream
+ * @see DeviceInfo
+ * @see HostApiInfo
+ * @see StreamInfo
+ * @see StreamParameters
+ * 
  * @author Phil Burk
  * 
  */

bindings/java/jportaudio/src/com/portaudio/StreamInfo.java

@@ -36,10 +36,18 @@
  * license above.
  */
 
+
+/** @file
+ @ingroup bindings_java
+
+ @brief Information about a JPortAudio Stream.
+*/
+
 package com.portaudio;
 
 /**
  * Equivalent to PaStreamInfo
+ * @see PortAudio
  * @author Phil Burk
  *
  */

bindings/java/jportaudio/src/com/portaudio/StreamParameters.java

@@ -36,9 +36,15 @@
  * license above.
  */
 
+/** @file
+ @ingroup bindings_java
+
+ @brief Options to use when opening a stream.
+*/
 package com.portaudio;
 /**
  * Equivalent to PaStreamParameters
+ * @see PortAudio
  * @author Phil Burk
  *
  */